Integración con WhatsApp

Antes de empezar

Para integrar Whatsapp con tu asistente, debes tener acceso a Twilio y al menos un rol de Desarrollador. Para obtener más información, consulta las diferencias entre los distintos roles de Twilio.

1. Ve a la página web de Twilio.

2. Crear una cuenta.

3. En el separador Desarrollar, pulse Números de teléfono.

4. Siga las instrucciones para obtener un número de teléfono.

Cuando se obtiene un número de teléfono de Twilio, admite automáticamente la voz, SMS y MMS automáticamente. Su nuevo número de teléfono aparece como número activo.

Mantenga abierta la página web de Twilio en un separador de navegador web para poderla consultar más tarde, si lo desea.

Pida permiso a WhatsApp para habilitar su número de Twilio para WhatsApp

WhatsApp tiene un proceso riguroso que utilizan para revisar todas las empresas que desean interactuar con clientes a través de la red. WhatsApp, que es propiedad de Facebook, requiere que registre su negocio con el directorio de negocios de Facebook.

1. Para registrarte, entra en la página web de Facebook Business Manager y haz clic en «Crear cuenta ». Siga las instrucciones para crear una cuenta.

2. Obtén tu ID de administrador de empresas de Facebook. En «Configuración», haz clic en la pestaña «Información de la empresa ». El identificador del administrador de empresas de Facebook se encuentra en la parte superior de la página.

3. Envía el formulario «Solicitar la activación de tus números de Twilio para WhatsApp » desde la página web «API de Twilio para WhatsApp ».

Sugerencias para especificar los valores siguientes:

• Número de teléfono: especifique el número de teléfono de Twilio que ha creado anteriormente.

Tenga en cuenta el suministro de más de un número de teléfono y el proceso de obtención de permiso para los números en paralelo. Si su número fue utilizado por una empresa diferente anteriormente (porque Twilio le asignó un número utilizado antes, por ejemplo), WhatsApp lo rechazará.

• ¿Están trabajando con un ISV?: Seleccione No.

• SID de cuenta de Twilio: en el sitio de Twilio, pulse el icono de inicio para ir al panel de control del proyecto y buscar el SID.

• ID de Facebook Business Manager: añada el ID de la cuenta que ha creado en el paso anterior.

1. Haga clic en Solicitar ahora.

Proporcione tiempo de WhatsApp para evaluar y aprobar su solicitud. Puede tardar hasta 7 días en que su solicitud sea aprobada.

Configurar la integración

Para configurar la integración, realice los pasos siguientes:

1. Ve a la página «Integraciones» haciendo clic en el icono de integraciones () del menú de la izquierda.

2. Pulse Añadir en el recuadro WhatsApp con Twilio.

3. Haz clic en «Confirmar ».

4. Desde el sitio de Twilio, haga clic en su nombre de cuenta en el menú superior izquierdo para ir al panel de control de su cuenta.

Copie los valores siguientes y almacénelos temporalmente, para poder pegarlos en la página de configuración de la integración de WhatsApp con Twilio en los pasos siguientes.

• SID de cuenta

• Señal de autenticación

1. Vuelva a la página de configuración de la integración de WhatsApp con Twilio. Pulse Siguiente para ir al paso 1 de la configuración de integración de WhatsApp con Twilio.

2. Especifique la información de SID de cuenta. Pulse Siguiente para ir al paso 2 de la configuración de integración de WhatsApp con Twilio.

3. Especifique la información de Señal de autenticación. Pulse Siguiente para ir al paso 3 de la configuración de integración de WhatsApp con Twilio.

4. Copie el valor del campo URI de webhook.

Puede utilizar este URI de webhook para probar la integración en la sección siguiente.

1. Pulse Finalizar.

Si se modifica un campo necesario para la autenticación, todas las entradas de los campos relacionados deben rellenarse y validarse de nuevo.

Prueba de la integración

Mientras espera a que WhatsApp apruebe su solicitud, puede probar la integración utilizando el recinto de pruebas de Twilio. Con el recinto de pruebas, puede enviar y recibir mensajes de plantilla previamente aprobados a números que se unan a su recinto de pruebas, utilizando un número de prueba de Twilio compartido.

No utilice el recinto de pruebas de Twilio en producción. Las sesiones del recinto de pruebas caducan al cabo de 3 días.

1. Para crear un entorno de pruebas, ve a la página web Twilio Try WhatsApp. Se muestra una solicitud Activar el recinto de pruebas. Acepte que crear un recinto de pruebas y confirme su elección.

2. Siga las instrucciones para crear el recinto de pruebas.

3. Conéctese al recinto de seguridad enviando un mensaje de WhatsApp desde su dispositivo al número de teléfono de recinto de seguridad.

4. En la pestaña Desarrollar, pulse Mensajería > Configuración > Valores del recinto de seguridad de WhatsApp.

5. En la sección Configuración del recinto de seguridad, pegue el URI del webhook que ha copiado anteriormente en el campo Cuando entra un mensaje. Pulse Guardar.

6. Puede probar la integración enviando un mensaje desde WhatsApp al número de teléfono compartido asignado al recinto de pruebas de Twilio.

Finalizar la integración del producto

Después de que WhatsApp otorgue permiso para el número de teléfono de Twilio o al número para acceder a la red de WhatsApp, actualice la integración para utilizar su número de teléfono de Twilio dedicado en lugar del número del recinto de pruebas.

1. En la página de configuración de la integración de WhatsApp con Twilio, desplácese a la sección Webhook del separador Configuración básica. Copie el valor del campo WhatsApp Webhook.

2. Vaya a la página web de su cuenta de Twilio y añada el webhook que ha copiado a la configuración de Twilio para completar la conexión a la integración de WhatsApp en Twilio.

Ofrezca a sus clientes un acceso rápido a su asistente

Puede añadir un icono a su página web que los clientes pueden pulsar para iniciar una conversación sobre WhatsApp con su asistente.

Para añadir un icono a la página web, siga estos pasos:

1. En la página de configuración de integración de WhatsApp con Twilio, pulse el separador Pulsar para conversar.

2. En el campo Mensaje rellenado previamente, añada el texto que WhatsApp debe enviar al asistente en nombre del cliente para que se inicie la conversación.

Especifique un mensaje que sepa que su asistente puede responder de forma útil.

1. Copie el Enlace incluido y añádalo a la página web. Considere la posibilidad de añadir texto delante del icono que explica lo que hace el icono. Por ejemplo, puede añadir un código HTML <span> delante del elemento <span> del icono que diga Have a question? Ask AI assistant for help.

Cuando un usuario pulsa el icono en su página web, abre una sesión de mensajería de WhatsApp que está conectada a su asistente, y añade el texto que especifique en el campo de texto del usuario, listo para ser enviado.

Consideraciones acerca de las acciones

Para ofrecer la mejor experiencia de cliente, diseñe las acciones teniendo en cuenta las funciones de la integración de WhatsApp:

• Una respuesta de texto que contiene más de 1.600 caracteres se divide en varias respuestas.

• No incluya elementos HTML en las respuestas de texto.

• La integración de WhatsApp con Twilio no admite transferencias de chat iniciadas con el tipo de respuesta Conectar con agente.

• Si utiliza la sintaxis de marcación, consulte la tabla Sintaxis de marcación soportada.

• Para incluir un enlace de hipertexto en una respuesta de texto, especifique el URL directamente. No utilice la sintaxis de marcación para enlaces. Por ejemplo, especifique: Contact us at https://www.ibm.com.