Configurar Twilio WhatsApp

La API de Twilio para WhatsApp ayuda a las organizaciones a enviar y recibir mensajes a sus usuarios de WhatsApp.

Para configurar el canal de chat de WhatsApp, un Administrador del generador de habilidades debe completar los siguientes pasos:

1. Registrarse y crear una cuenta en Twilio. Una vez creada la cuenta, debe configurar la facturación para los mensajes/transacciones de Twilio. Para obtener más información sobre los precios y la facturación, consulte https://www.twilio.com/whatsapp/pricing/us .

2. Crear un proyecto en Twilio. Debe copiar el Account SID (SID de la cuenta), el Auth Token (Token de autorización), el número de Sender (Emisor), el código de activación y guardarlos en una ubicación de fácil acceso, como un bloc de notas o cualquier herramienta de edición de texto.

3. Configurar y activar el canal de chat de WhatsApp en Luma Virtual Agent mediante el Account SID (SID de la cuenta) y el Auth Token (Token de autenticación) del proyecto de WhatsApp de Twilio.

4. Invitar a los usuarios a utilizar el canal de WhatsApp para interactuar con el agente virtual.

Paso 1: registrarse en Twilio

Para utilizar WhatsApp con Luma Virtual Agent, primero debe registrarse en Twilio. Para ello, siga los siguientes pasos:

1. Vaya al sitio web de Twilio ingresando la URL www.twilio.com. La página principal de Twilio aparece como se muestra a continuación.

   Open

   

    

2. Cree una cuenta en Twilio haciendo clic en Sign up (Registrarse). Para saber cómo registrarse para obtener una cuenta de Twilio y otros detalles de gestión de la cuenta, consulte https://support.twilio.com/hc/en-us/sections/205104908-Account-Management .
   Si ya dispone de una cuenta, vaya al paso siguiente (punto 3).

   1. En la pantalla de registro, agregue los datos obligatorios y la contraseña.

   2. Seleccione “I accept Twilio Privacy statement…” (Acepto la declaración de privacidad de Twilio…). y haga clic en Start your free trial (Iniciar la prueba gratuita) para crear su cuenta.

      Open

      

   3. Se enviará un correo electrónico a la dirección de correo electrónico (agregada en el paso anterior) para verificar su cuenta.

   4. Haga clic en el vínculo del correo electrónico y confirme su dirección de correo electrónico.

   5. El vínculo lo redirigirá a Twilio. Para verificar su número de teléfono, agregue su número y haga clic en Verify (Verificar).

   6. Ingrese el código de verificación recibido en su teléfono y haga clic en Submit (Enviar).

   7. La cuenta ahora está verificada. Finalice la creación de la cuenta y vaya al Project Dashboard (Panel del proyecto).
      En “Do you write code” (¿Escribe código?), haga clic en No y haga clic en Skip to Dashboard (Saltar al panel).

3. Si ya tiene una cuenta, inicie sesión en Twilio con los datos de su cuenta y vaya al Dashboard (Panel).

    

4. Una vez que haya iniciado sesión, el siguiente paso es crear un nuevo proyecto. Si ya tiene un proyecto, vaya al paso siguiente (punto 5).

   1. En el panel del proyecto, haga clic en Create New Project (Crear nuevo proyecto).

   2. Agregue el nombre del proyecto y haga clic en Verify (Verificar).

   3. Proporcione su número de teléfono y código de verificación para verificar su cuenta (como en el punto 2). Ahora vaya al Dashboard (Panel).

   4. Su proyecto ya está listo.
      
      

5. En el Project Dashboard (Panel del proyecto), copie los siguientes datos y conserve la información en el bloc de notas que utilizará para la configuración de canales en Luma. Haga clic en el botón para copiar en los campos:

   1. SID de la cuenta

   2. Token de autenticación

Paso 2: Configurar WhatsApp en Luma Virtual Agent

1. El siguiente paso es configurar y activar WhatsApp como canal de chat en Luma Virtual Agent.

   1. Inicie sesión en su tenant en la interfaz de usuario del Bot Builder (Consola de Administración de Luma).

   2. Vaya al menú Bot (Bot) → Configurations (Configuraciones) → Channels (Canales). Haga clic en el ícono de WhatsApp de Twilio y abra las configuraciones.

   3. Ahora agregue el Account SID (SID de la cuenta) y el Auth Token (Token de autenticación) (copiados en el paso 2 → punto 5) a los respectivos campos en la pantalla de configuración en la interfaz de usuario de Bot Builder (Consola de Administración de Luma).

   4. En la sección User Reconciliation For Channel Authentication (Reconciliación de usuarios para la autenticación del canal), especifique la información del usuario que se debe utilizar para la autenticación automática y la conciliación de los datos del usuario con los campos de registro del Luma Virtual Agent. Dado que WhatsApp utiliza el número de teléfono del usuario para la autenticación, seleccione “phone” (teléfono) en User Fields (Campos de usuario) y haga clic en Set (Establecer).

   5. Copie la Message URL (URL del mensaje) y conserve la información en un bloc de notas que utilizará para configurar el servicio de mensajería en Twilio en un paso posterior.

   6. Haga clic en Configure (Configurar) para activar WhatsApp. El canal ahora está activado y configurado como Active (Activo).

Paso 3: configurar el entorno de pruebas de WhatsApp

Una vez que el canal está configurado en la interfaz de usuario de Bot Builder (Consola de Administración de Luma), el siguiente paso es crear y configurar el entorno de pruebas. El entorno de pruebas de Twilio para WhatsApp lo ayuda a conectarse a su bot.

1. En Twilio, vaya al Project Dashboard (Panel del proyecto). Haga clic en All Products & Services (Todos los productos y servicios).

2. Vaya a Programmable Messaging (Mensajería programable).

    

3. Haga clic en Settings (Configuración) → WhatsApp Sandbox Settings (Configuración del entorno de pruebas de WhatsApp).

    

4. Aparece un mensaje de confirmación para activar el entorno de pruebas. Acepte los Términos de servicio y haga clic en Confirm (Confirmar).

    

5. Aparecerá la página del entorno de pruebas de Twilio para WhatsApp .

   1. En la sección Sandbox Configuration (Configuración del entorno de pruebas), configure la dirección URL del punto de conexión. Esto indica el entorno y el tenant de Luma al que debe conectarse el entorno de pruebas.

   2. Copie la URL del mensaje copiada o retenida en el paso 2 → punto 1(e) y pegue la dirección URL en el campo “When a Message Comes in” (Cuando llegue un mensaje) y haga clic en Save (Guardar).

   3. El entorno de pruebas ahora está listo.

       

Paso 4: invitar a los usuarios a su entorno de pruebas

Ahora que el canal está activo y el entorno de pruebas configurado, puede invitar a los usuarios de su organización a conectarse a Luma Virtual Agent a través de WhatsApp. Para utilizar su entorno de pruebas de WhatsApp, el usuario final debe hacer lo siguiente:

1. Agregar el número de remitente proporcionado en la sección Sandbox Participants (Participantes del entorno de pruebas) de su lista de contactos.

2. Una vez agregado el número, enviar un mensaje de WhatsApp al número con el código de activación.

El usuario se agregará al entorno de pruebas. Todos los usuarios (números de teléfono) con acceso al bot están disponibles en USERID.

1. Los usuarios ahora pueden comenzar a interactuar con Luma Virtual Agent a través de WhatsApp. Si el usuario que ha iniciado sesión ya está disponible en Luma Virtual Agent (con el número de teléfono utilizado para WhatsApp), el sistema autenticará automáticamente al usuario. No es necesario ningún registro manual.

    

2. En caso de que el usuario no esté disponible en Luma Virtual Agent, el sistema reconoce a los usuarios como usuarios anónimos y solicita al usuario que se registre en Luma Virtual Agent.

    

Precios de Twilio

Una vez creada la cuenta de Twilio, asegúrese de configurar la facturación para los mensajes/transacciones de Twilio. Hay dos tipos de mensajes:

• mensaje de sesión de WhatsApp

• mensaje de plantilla de WhatsApp

El mensaje de sesión de WhatsApp es cualquier mensaje enviado o recibido en respuesta a una sesión iniciada por el usuario. Una sesión de mensajería se inicia cuando un usuario envía un mensaje a Luma Virtual Agent y dura 24 horas desde el último mensaje recibido. Puede esperar a que los usuarios envíen un mensaje o puede enviar un mensaje de plantilla para invitar al usuario a responder.

El mensaje de plantilla de WhatsApp es iniciado por Luma Virtual Agent (seguimiento, aprobación o resolución). Son plantillas de mensajes aprobadas previamente para notificaciones salientes como alertas de entrega y recordatorios de citas. Se puede utilizar un mensaje de plantilla de WhatsApp si han pasado más de 24 horas desde la última vez que el usuario le respondió. Cualquier otro tipo de mensaje fallará. 

Para obtener más información sobre cuánto cobra Twilio por los diferentes tipos de mensajes, consulte https://www.twilio.com/whatsapp/pricing/us .