Antes de empezar

Para integrar Whatsapp con tu asistente, debes tener acceso a Twilio y al menos a un rol de Desarrollador. Para obtener más información, consulte la diferencia de roles para Twilio.

1. Vaya al sitio 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. 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á.

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 cuenta con un riguroso proceso de revisión de todas las empresas que quieren interactuar con los clientes a través de su red. WhatsApp, que es propiedad de Meta (antes llamada Facebook), requiere que registres tu negocio en el directorio de empresas de Meta.

1. Para registrarse, vaya a la página Meta Herramientas Empresariales y haga clic en Crear nueva cuenta. Siga las instrucciones para crear una cuenta.

2. Obtén tu ID de Meta Business Manager. En Configuración, haz clic en la pestaña Información de la empresa. El ID de Business Manager se encuentra en la parte superior de la página.

3. Habilite sus números Twilio para WhatsApp utilizando la página web del Programa de proveedores técnicos de WhatsApp, que es la única vía oficialmente admitida por Meta para incorporar a sus clientes a WhatsApp a partir del 1 de enero de 2025. Para más información, consulte la descripción general del programa de proveedores de WhatsApp Tech.

   Sugerencias para especificar los valores siguientes:

   • 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.

   • Meta Business Manager ID: Añade el ID de la cuenta que has creado en el paso anterior.

   • ¿Ofrece a sus clientes un autoservicio de incorporación? Seleccione No. Al adoptar el Tech Provider Program, sus clientes se incorporarán a WhatsApp utilizando el producto WhatsApp Embedded Signup de Meta.

4. Pulse Enviar.

Dale tiempo a WhatsApp para que evalúe y apruebe tu envío. 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. Vaya a la página Integraciones pulsando el icono de integraciones () en el menú de la izquierda.

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

3. Pulse 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

5. 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.

6. 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.

7. 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.

8. Copie el valor del campo URI de webhook.

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

9. Pulse Finalizar.

Si se cambia 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 esperas a que WhatsApp apruebe tu envío, puedes probar la integración utilizando el sandbox de Twilio. Con el sandbox, puede enviar y recibir mensajes de plantilla preaprobados a números que se unan a su sandbox, utilizando un número de prueba Twilio compartido y preaprovisionado.

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 sandbox, vaya a la página web de Twilio Console e inicie sesión con sus credenciales de Twilio. 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.

Para obtener información completa y detallada, consulte Empezar a utilizar Twilio Sandbox para WhatsApp.

Finalizar la integración del producto

Después de que WhatsApp conceda permiso y acceso a la red de WhatsApp, actualice la integración para utilizar su número de teléfono Twilio dedicado en lugar del número del sandbox.

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.

3. 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 watsonx 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.