Integración con SMS
IBM Cloud
IntelePeer servicio de números de teléfono gratuitos para watsonx Assistant
A partir del 31 de julio de 2025, el servicio de número de teléfono gratuito IntelePeer se interrumpe para watsonx Assistant. Después de esta fecha,
los números de teléfono que utilizan este servicio dejan de conectarse y los usuarios no pueden hacer ni recibir llamadas. Para garantizar la continuidad del servicio, migra tus números de teléfono a Twilio o a otro proveedor de telefonía. Actualice
sus números de teléfono y ajuste la configuración de integración en watsonx Assistant. Si necesita ayuda con la transición, póngase en contacto con el servicio de asistencia en https://www.ibm.com/mysupport/.
Añadir una integración de mensajería de texto para que el asistente pueda intercambiar mensajes con sus clientes.
El servicio de mensajes cortos SMS solamente admite mensajes de texto. Normalmente, SMS restringe la longitud del mensaje de texto a 160 caracteres. El servicio de mensajería multimedia (MMS) admite el envío de imágenes y mensajes de texto con más de 160 caracteres de longitud. Cuando se crea un número de teléfono con Twilio, el soporte de mensajes de MMS se incluye automáticamente. El soporte de mensajes MMS IntelePeer aún no está disponible.
Los clientes envían mensajes de texto a su número de teléfono alojado. Twilio y IntelePeer utilizan un webhook de mensajería que usted configura para enviar una solicitud POST con el cuerpo del mensaje de texto a su asistente. Cada respuesta del asistente se envía de vuelta a Twilio o IntelePeer para convertirla en un mensaje SMS saliente que se envía al cliente. Las respuestas se envían a la API del proveedor de SMS para su procesamiento. Proporcione la información de señal de autenticación del proveedor de SMS, que sirve como credenciales de acceso de API.
Consulte las secciones siguientes para configurar la integración para el proveedor de SMS:
Antes de empezar
Para integrar Twilio con su asistente, debe tener al menos un rol de desarrollador. Para obtener más información, consulte la diferencia de roles para Twilio.
Si no tiene un número de teléfono de mensajería de texto, configure una cuenta de SMS con Twilio y obtenga un número de teléfono.
Integración de SMS con Twilio
-
Vaya al sitio web de Twilio.
-
Crear una cuenta. No se pueden utilizar cuentas de prueba gratuitas para esta integración.
-
En la pestaña Desarrollar de la barra lateral, pulse Números de teléfono. Si Números de teléfono no está presente, vaya a la barra de búsqueda en la parte superior y busque 'Números de teléfono' y, a continuación, seleccione Comprar un número.
-
Siga las instrucciones para Comprar un número. Cómo buscar y comprar un número de teléfono Twilio desde la consola.
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. También puede anclar Números de teléfono en la barra lateral.
Configurar la integración
Para configurar la integración, realice los pasos siguientes:
-
Vaya a la página Integraciones pulsando el icono de integraciones (
) en el menú de la izquierda.
-
Haga clic en Añadir en el mosaico SMS.
-
Haz clic en el azulejo SMS con Twilio.
-
Pulse Confirmar.
-
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 SMS con Twilio en los pasos siguientes.
- SID de cuenta
- Señal de autenticación
-
Vuelva a la página de configuración de la integración de SMS con Twilio. Pulse Siguiente para ir al paso 1 de la configuración de la integración de SMS con Twilio.
-
Especifique la información de SID de cuenta. Pulse Siguiente para ir al paso 2 de la configuración de la integración de SMS con Twilio.
-
Especifique la información de Señal de autenticación. Pulse Siguiente para ir al paso 3 de la configuración de la integración de SMS con Twilio.
-
Opcional: especifique el número de teléfono que su cuenta de Twilio utiliza para la integración de SMS. El URI de webhook se utiliza para transferir mensajes, pero si añade el número de teléfono en este campo opcional, podrá consultarlo fácilmente más adelante. Pulse Siguiente para ir al paso 4 de la configuración de la integración de SMS con Twilio.
-
Copie el valor del campo URI de webhook.
Este URI se añadirá a la configuración de webhook en Twilio. Si quiere dar soporte a más de un número de teléfono, debe añadir el URI al webhook de cada número de teléfono por separado.
-
Vaya a su página web de la cuenta de Twilio. En la pestaña Desarrollar de la barra lateral, haz clic en Números de teléfono > Gestionar > Números activos.
-
En la página Números activos, pulse uno de los números de teléfono.
-
Desplácese hasta la sección Mensajería y, a continuación, busque el campo Webhook que define qué hacer cuando Entra un mensaje.
Pegue en él el valor que ha copiado del campo URI de webhook.
-
Si quiere dar soporte a varios números de teléfono, repita el paso anterior para cada número de teléfono que quiera utilizar.
-
Pulse Guardar.
-
En la pestaña Desarrollo de la barra lateral, haz clic en Mensajería > Configuración > Permisos geográficos. Si Mensajería no está presente, vaya a la barra de búsqueda en la parte superior y busque 'Mensajería' y, a continuación, seleccione Permisos geográficos SMS.
-
En la página Permisos geográficos de mensajería, seleccione los códigos de país de los números de teléfono que puedan enviar mensajes de etxto al número de Twilio. De forma predeterminada, no se permite ningún código de país para el envío de mensajes de texto al número de Twilio.
-
Vuelva a la página de configuración de la integración de SMS con Twilio. Pulse Finalizar.
Integración con SMS con IntelePeer
Si no tienes un número de teléfono de mensajería de texto, crea una cuenta de SMS con IntelePeer y consigue un número de teléfono.
-
Vaya al sitio web deIntelePeer.
-
Cree una cuenta o inicie una prueba gratuita.
Cuando obtiene un número de teléfono IntelePeer, admite voz y SMS. Si el número no está habilitado automáticamente para SMS, deberá habilitarlo manualmente. Su nuevo número de teléfono aparece como número activo. Consulte la Guía de inicio rápido de mensajería de atmósfera
Antes de empezar
Para integrar IntelePeer con su asistente, necesita el servicio "SMS" con tipo de acceso para create
, read
, update
, y delete
. Para obtener más información, consulte Gestión de usuarios en el Portal de clientes.
Configurar la integración
Para configurar la integración, realice los pasos siguientes:
-
Vaya a la página Integraciones pulsando el icono de integraciones (
) en el menú de la izquierda.
-
Haga clic en Añadir en el mosaico SMS.
-
Seleccione el mosaico SMS con IntelePeer.
-
Pulse Confirmar.
-
En el sitio IntelePeer Atmósfera, copie el valor Señal de autenticación de API y almacénelo temporalmente, para que pueda pegarlo en la página de configuración de integración de SMS con IntelePeer en los próximos pasos.
-
En el sitio IntelePeer Customer Portal, en la sección Mis aplicaciones, seleccione SMS API Management. En la barra de título Gestión de SMS, pulse el icono de engranaje, aquí establecerá la Entrada secreta de SMS. La entrada secreta se utiliza para impedir que el webhook del servidor web procese cualquier solicitud POST de SMS de entrada que no se origine en IntelePeer. Establezca aquí el valor de Entrada secreta y recuérdelo, ya que deberá utilizar el valor en la página de configuración de integración de SMS con IntelePeer en los próximos pasos.
-
Vuelva a la página de configuración de la integración de SMS con IntelePeer. Haz clic en Siguiente para ir al Paso 1 de la configuración de la integración de SMS con IntelePeer.
-
Introduzca los datos secretos de su cuenta. Haz clic en Siguiente para ir al paso 2 de la configuración de la integración de SMS con IntelePeer.
-
Especifique la información de Señal de autenticación. Haz clic en Siguiente para ir al paso 3 de la configuración de la integración de SMS con IntelePeer.
-
Opcional: Introduzca el número de teléfono que su cuenta IntelePeer utiliza para la integración de SMS. El URI de webhook se utiliza para transferir mensajes, pero si añade el número de teléfono en este campo opcional, podrá consultarlo fácilmente más adelante. Haz clic en Siguiente para ir al paso 4 de la configuración de la integración de SMS con IntelePeer.
-
Copie el valor del campo URI de webhook.
Añadirá este URI a la configuración del webhook en IntelePeer. Si quiere dar soporte a más de un número de teléfono, debe añadir el URI al webhook de cada número de teléfono por separado.
-
Vaya al sitio IntelePeer Portal de clientes, en la sección Mis aplicaciones, seleccione SMS API Management.
-
Vaya a los números de teléfono que desea habilitar para SMS. Conmute el botón radial Habilitado/Inhabilitado junto al número y establézcalo en Habilitado. El número de teléfono puede tardar unos minutos en activarse para SMS.
-
Una vez que el número de teléfono se ha habilitado para SMS, verá un icono de webhook junto al número.
Pegue en él el valor que ha copiado del campo URI de webhook.
-
Pulse Guardar.
-
Si quiere dar soporte a varios números de teléfono, repita el paso anterior para cada número de teléfono que quiera utilizar.
Por motivos de seguridad, los campos de autenticación se eliminan de la vista después de la configuración inicial. Si se cambia un campo necesario para la autenticación, todas las entradas de los campos relacionados deben rellenarse y validarse de nuevo.
Opciones de configuración avanzadas de SMS
La pestaña Opciones avanzadas está disponible después de configurar la integración de SMS. Pulse el separador Opciones avanzadas para realizar cualquiera de las siguientes personalizaciones en el comportamiento de la mensajería:
- Iniciar conversación desde mensajes de entrada: inhabilite esta opción si desea limitar el soporte de mensajería para permitir que se envíen mensajes en el contexto de una conversación de integración telefónico en curso únicamente, y no permitir que los clientes inicien un intercambio de mensajes con el asistente fuera de una llamada telefónica.
- Mensaje de error predeterminado: añada un mensaje para enviar al cliente si la conexión de SMS falla.
- URL base: este URL es el punto final de la API REST para el servicio SMS que está utilizando.
Optimizar las acciones para la mensajería
Para obtener la mejor experiencia del cliente, diseñe sus acciones teniendo en cuenta las capacidades de la integración de SMS:
-
No incluya elementos HTML en las respuestas de texto.
-
La integración de SMS no da soporte a transferencias de conversación que se inician con el tipo de respuesta connect_to_agent.
-
Los tipos de respuesta Imagen, Audio y Vídeo permiten enviar un mensaje con contenido multimedia. Se envían un título y una descripción con el archivo adjunto. Tenga en cuenta que, en función de la compañía y del dispositivo del usuario final, es posible que estos mensajes no se reciban correctamente. Para obtener una lista de los tipos de contenido soportados para Twilio, consulte Twilio: Tipos de contenido aceptados para soporte.
Para obtener más información sobre estos tipos de respuesta, consulte Referencia de tipos de respuesta.
Si desea utilizar la misma acción para un asistente que se despliega en muchas plataformas distintas, añada respuestas personalizadas según cada tipo de integración. Puede añadir una respuesta condicionada que indique al asistente que muestre la respuesta sólo cuando se esté utilizando la integración de SMS.
Para obtener la documentación de referencia, consulte Referencia de integración deSMS.
Resolución de problemas
Encuentre soluciones a los problemas que puedan surgir al utilizar la integración.
- La recepción de un mensaje Prohibido implica que el número de teléfono especificado al configurar la integración no se puede verificar. Asegúrese de que el número coincida totalmente con el número de teléfono de SMS.
Migración desde Voice Agent with Watson
Si ha creado una instancia de servicio IBM® Voice Agent with Watson en IBM Cloud para que los clientes puedan intercambiar mensajes de texto con un asistente, utilice en su lugar la integración SMS.
La integración de SMS proporciona una integración más fluida con tu asistente y admite tantos números de teléfono como sea necesario. Sin embargo, actualmente, la integración no da soporte a las funciones siguientes:
- Inicio de una interacción exclusivamente mediante SMS con un texto saliente
- Configuración de ubicaciones de copia de seguridad
- Revisión de la página de resumen de uso. Utilice en su lugar IBM Log Analysis.
Para migrar de Voice Agent with Watson a la integración de SMS de watsonx Assistant, complete el siguiente paso:
-
Realice una de las acciones siguientes:
-
Si su instancia de servicio Voice Agent with Watson utiliza un proveedor de servicios SMS distinto de Twilio o IntelePeer,, no podrá seguir utilizándola. Primero debes crear una cuenta de SMS con Twilio o IntelePeer. Complete los pasos Antes de empezar-Twilio o Antes de empezar- IntelePeer para crear la cuenta. A continuación, configure la integración.
-
Si la instancia de servicio de Voice Agent with Watson utiliza Twilio o IntelePeer como proveedor de SMS, puede ir directamente a Configurar la integración-Twilio o Configurar la integración- IntelePeer.
-