Conexión de un bot a Twilio (SMS)

SE APLICA A: SDK v4

Puede configurar el bot para comunicarse con personas mediante la plataforma de comunicación en la nube de Twilio (SMS). En este artículo se describe cómo configurar un bot para comunicarse mediante Twilio mediante la creación de una aplicación de TwiML y la conexión del bot en el Azure Portal.

Requisitos previos

  • Una cuenta de Azure. Si aún no tiene una, cree una cuenta gratuita antes de empezar.
  • Un bot existente publicado en Azure.

Creación de una aplicación TwiML

  1. Si no tiene cuenta de Twilio, cree una. Si ya tiene una cuenta de Twilio, continúe con el paso siguiente.
  2. Siga las instrucciones para crear una aplicación TwiML.
    • Escriba un nombre descriptivo para la aplicación TwiML.
    • En Configuración de voz, deje vacía la dirección URL de solicitud .
    • En Configuración de mensajería, establezca la dirección URL de solicitud:
      • Para un bot global, escriba https://sms.botframework.com/api/sms.
      • Para un bot regional, escriba https://europe.sms.botframework.com/api/sms.

Seleccionar o agregar un número de teléfono

Siga las instrucciones para agregar un llamador comprobado a través de la consola. Puede omitirlo si ya tiene un identificador de llamador comprobado.

Después de finalizar, verá el número comprobado en Identificadores comprobados de autor de llamada.

Especificación de la aplicación TwiML que se va a usar para la voz y la mensajería

Después de agregar un identificador de llamador comprobado, configure la configuración del número para usar la aplicación TwiML que ha creado.

  1. Seleccione Números activos en Administrar números > de teléfono. Seleccione el número y vaya a Configurar.
  2. En Fax de voz & y mensajería, establezca Configurar con en *Aplicación TwiML. A continuación, establezca la aplicación TwiML en la aplicación TwiML que creó anteriormente. Después de finalizar, seleccione Guardar.
  3. Vuelva a seleccionar Números activos . Verá que la configuración activa de voz ymensajería está establecida en la aplicación TwiML.

Recopilación de credenciales de Twilio

  1. Volver a la página principal de la consola de Twilio

  2. En Información de cuenta, verá el SID de la cuenta y el token de autenticación en el panel del proyecto, que se muestra a continuación. Copie y guarde estos valores para los pasos posteriores.

    Recopilación de credenciales de aplicación de la consola de Twilio

Escriba las credenciales de Twilio en el Azure Portal

Ahora que tiene los valores necesarios de Twilio, conecte el bot a Twilio en el Azure Portal.

  1. En una ventana o pestaña independiente, vaya al Azure Portal.

  2. Seleccione el bot que desea conectar a Twilio.

  3. En Configuración, seleccione Canales y, a continuación, seleccione el icono de Twilio (SMS) en la lista de Canales disponibles.

  4. Escriba el número de teléfono, el sid de cuenta y el token de autenticación que guardó anteriormente. Después de finalizar, seleccione Aplicar.

    Escriba las credenciales de Twilio en Azure.

El bot ya está configurado correctamente para comunicarse con los usuarios de Twilio.

Prueba del bot en Twilio

Para probar si el bot está conectado correctamente a Twilio, envíe un mensaje SMS al número de Twilio. Cuando el bot recibe el mensaje, le envía un mensaje de vuelta y devuelve el texto del mensaje.

Información adicional

Para más información sobre el desarrollo de Twilio, consulte la documentación de SMS de Twilio.

Conexión de un bot a Twilio mediante el adaptador de Twilio

Además de usar el canal disponible de Azure Bot Service para conectar el bot con Twilio, los repositorios de la comunidad de Bot Builder definen un adaptador de canal personalizado para Twilio.