Configuración de la integración telefónica
IBM Cloud
Después de configurar la integración telefónica para el asistente, puede modificar los valores de integración telefónica personalizar el comportamiento de la llamada.
Gestión de errores de llamada y transferencia
Puede configurar la integración telefónica para transferir a la persona que llama a un agente en directo si la conexión telefónica falla por cualquier motivo. Para transferir automáticamente la llamada a una persona, vaya a la pestaña Avanzado de los ajustes de integración del teléfono y realice las siguientes selecciones de configuración:
-
Destino SIP cuando una llamada falla: añada el punto final SIP para el servicio de agente de soporte. Especifique un SIP o un URI de teléfono para una cola de llamada general que pueda redirigir solicitudes a otras colas. Para obtener más información, consulte Configuración de una solución de centro de servicio al usuario de copia de seguridad.
-
Mensaje de fallo de llamada: Añada el mensaje que desea que el asistente diga a la persona que llama antes de transferir la llamada a un agente en directo.
Si, después de transferir la llamada a un humano, la conexión con un agente en directo falla por cualquier motivo, puede configurar qué hacer.
-
Mensaje de fallo de transferencia: Añada el mensaje que desea que el asistente diga a la persona que llama si falla la transferencia a un agente en directo. El mensaje puede tener una longitud máxima de 150 caracteres.
-
Desconectar llamada tras error de transferencia: elija si desea desconectar la llamada después del mensaje de error. Esta opción está habilitada de forma predeterminada. Si esta opción está inhabilitada, cuando una transferencia de llamada falla, el asistente puede desconectar o procesar una acción diferente.
Si elige dejar una llamada conectada a pesar de un error de transferencia, watsonx Assistant inicia un nuevo turno para determinar el paso siguiente. Es importante que el asistente se configure con una acción o webhook que pueda manejar este escenario.
La integración telefónica da soporte a la recuperación tras desastre proporcionando la capacidad de realizar una migración tras error rápida a otra región en lugar de direccionar la llamada a un agente en directo cuando se produce una interrupción del servicio. Esto se consigue enviando una respuesta SIP 503 al proveedor de conexión troncal SIP en sentido ascendente, en lugar de hacer referencia automáticamente a la llamada a un agente en directo cuando se producen anomalías durante la configuración de una llamada. El proveedor de conexión troncal SIP puede utilizar esta respuesta 503 para volver a direccionar la llamada a otra región. Si desea utilizar esta posibilidad, abra un tíquet de servicio en la instancia de servicio de watsonx Assistant que requiera la recuperación tras desastre.
Proteger la conexión telefónica
Puede añadir seguridad a la conexión telefónica dirigiéndose al separador Opciones avanzadas de los valores de integración telefónica y seleccionando una de las opciones siguientes, o ambas:
-
Forzar la conexión troncal segura: seleccione esta opción para utilizar SRTP (protocolo de transporte en tiempo real segura) para proteger el audio que se transmite por teléfono. Para obtener más información sobre RTP, consulte Detalles de direccionamiento de las llamadas.
-
Habilitar autenticación SIP: seleccione esta opción si quiere exigir la autenticación de resumen de SIP.
Si se requiere la autenticación SIP, todo el tráfico de entrada (es decir, las solicitudes del proveedor SIP al asistente) se autentica utilizando la autenticación de resumen SIP y se debe enviar utilizando TLS (seguridad de la capa de transporte). Si se selecciona esta opción, es necesario configurar el nombre de usuario y la contraseña del resumen SIP, y la conexión troncal SIP que se utiliza para conectarse al Asistente debe estar configurada para que utilice solo TLS.
Si utiliza Twilio como proveedor de troncales SIP, no puede activar la autenticación SIP para las troncales SIP salientes a watsonx Assistant.
Aplicación de valores avanzados de configuración de conexión troncal SIP
Para configurar cómo interactúa el asistente con una conexión troncal SIP de un proveedor externo, vaya al separador Conexión troncal SIP en los valores de integración telefónica y actualice las opciones siguientes en la sección Integración de conexión troncal SIP:
-
Cabeceras SIP INVITE para extraer: liste las cabeceras que desea que utilice el asistente.
La solicitud SIP INVITE puede incluir metadatos sobre la llamada en cabeceras que se pueden extraer y enviar al asistente utilizando variables de contexto. Por ejemplo, muchas empresas utilizan sistemas IVR (Interactive Voice Response) que pasan información sobre una llamada entrante utilizando cabeceras SIP. Si desea utilizar cualquiera de estas cabeceras, liste aquí los nombres de cabecera.
Las cabeceras especificadas, si están presentes en la solicitud, se almacenan en la variable de contexto
sip_custom_invite_headers
, junto con otros metadatos relacionados que se extraen automáticamente de SIP INVITE. Esta variable es una matriz en la que cada par de clave/valor representa una cabecera de la solicitud, como en este ejemplo:{ "input": { "text": "", ... }, "context" : { "global" : {...}, "skills" : {...}, "integrations" : { "voice_telephony": { "private":{ "user_phone_number":"+18594213456", }, "sip_call_id": "Aob2-2743-5678-1234", "assistant_phone_number":"+18882346789", "sip_custom_invite_headers": { "X-customer-name": "my_name", "X-account-number": "12345" } } } } }
A continuación, puede hacer referencia a estas cabeceras en el asistente. Por ejemplo, puede comprobar el valor de la cabecera en una condición de paso para determinar el paso siguiente. También puede utilizar estas cabeceras para realizar búsquedas en los registros del asistente; por ejemplo, puede buscar una cabecera personalizada para encontrar todos los mensajes asociados a una cuenta determinada.
-
Desactivar el timbre que oyen las personas que llaman mientras se contacta con el asistente: Elija si desea que la persona que llama oiga una señal que indique que se está contactando con el asistente.
Se envía una respuesta
180 Ringing
del asistente de nuevo al proveedor de conexión troncal SIP mientras el asistente procesa la invitación de la llamada entrante. La respuesta del tono de llamada se envía de forma predeterminada. -
No poner a los interlocutores en espera durante la transferencia a un agente activo: decida si desea que la integración del teléfono ponga al interlocutor en espera.
Si el proveedor de conexión troncal SIP gestiona las esperas, inhabilite esta característica. Por ejemplo, algunos proveedores de conexiones troncales SIP prefieren que el asistente envíe una solicitud SIP REFER, para así poner ellos mismos la llamada en espera.
Para más información sobre el protocolo SIP, consulte el RFC 3261 y sobre el protocolo RTP, consulte el RFC 3550.
Configuración de una solución de centro de servicio al usuario
Cuando se utiliza la integración telefónica como primera línea de asistencia a los clientes, es una buena idea disponer de un agente en directo de reserva. Puede diseñar el asistente para que transfiera una llamada a un humano en caso de que la conexión telefónica falle, o si un usuario pide hablar con alguien.
Es posible que su empresa ya disponga de uno o varios números de teléfono que se conectan a un despachador automático de llamadas (ACD), que puede poner en cola a las personas que llaman hasta que esté disponible un agente adecuado. Si no es así, elija una solución de service desk para utilizarla como copia de seguridad.
Una conversación no se puede transferir de un tipo de integración a otro. Por ejemplo, si utiliza la integración de conversación web con el soporte de centro de servicio al usuario, no puede transferir una llamada telefónica al centro de servicio al usuario que se ha configurado para la conversación web.
Debe proporcionar el URI SIP del servicio de atención al usuario para la solución de soporte del servicio de atención al usuario que utilice. Debe especificar esta información en el asistente cuando habilite una transferencia de llamada desde un nodo de diálogo o un paso de acción. Para obtener más información, consulte Transferencia de una llamada a un agente activo.
Optimizar las acciones para la interacción telefónica
Para ofrecer la mejor experiencia al cliente, diseñe su diálogo teniendo en cuenta las funciones de integración por teléfono:
-
No incluya elementos HTML en las respuestas de acción. Para añadir formato, utilice Markdown. Para obtener más información, consulte Formato de respuestas.
-
Puede utilizar una extensión de búsqueda para incluir los resultados de búsqueda en acciones que la integración telefónica va a leer. Cuando se devuelven resultados de búsqueda, la integración telefónica lee el mensaje introductorio (por ejemplo,
I found this information that might be helpful
) y, a continuación, el cuerpo solo del primer resultado de búsqueda.La totalidad de la respuesta de búsqueda (es decir, el mensaje introductorio más el cuerpo del primer resultado de la búsqueda) debe tener una longitud de menos de 5.000 caracteres; de lo contrario, la respuesta no se leerá. Asegúrese de probar los resultados de la búsqueda que se obtienen y de organizar la recopilación de datos que utilice según sea necesario.
Para obtener más información sobre cómo utilizar la integración de búsqueda, consulte Utilización del contenido de ayuda existente.
Para obtener más información sobre cómo implementar acciones comunes desde el diálogo, consulte Gestión de interacciones telefónicas.
Creación de una conexión troncal SIP
Si no utiliza la opción de generar un número de teléfono gratuito, deberá configurar el troncal SIP que utiliza la integración telefónica. Busque un proveedor y cree una cuenta troncal SIP, por la que debe pagar por uso.
Para configurar una conexión troncal SIP, elija una de estas opciones:
- Configuración de una conexión troncal SIP Twilio
- Utilizar otros proveedores de terceros
- Traiga su propia conexión troncal SIP
- Migrar desde Voice Agent with Watson
Configuración de un troncal SIP Twilio
Antes de empezar la configuración de una conexión troncal SIP de Twilio, realice los siguientes pasos de requisito previo:
- Cree una cuenta Twilio en el sitio web de Twilio.
- Crear una conexión troncal SIP
Si ya ha creado una conexión troncal SIP, siga los pasos de Configurar una conexión troncal SIP.
Crear una conexión troncal SIP
-
Inicie sesión en su consola Twilio y vaya a la sección Elastic SIP Trunking.
Nota: Si no ve Elastic SIP Trunking, haga lo siguiente:
- Busque
Elastic SIP Trunking
en la barra de búsqueda. - Pulse Panel de instrumentos de conexión troncal SIP elástica.
- Busque
-
En el menú de navegación de la izquierda, vaya a Visión general y haga clic en Empezar.
-
Haga clic en Crear nueva troncal en la barra de navegación de troncales.
-
Introduzca un nombre para su troncal SIP en el campo NOMBRE AMIGO.
-
Pulse el botón Crear. Se asigna un SID de troncal una vez que se crea una nueva troncal.
Para la configuración de una conexión troncal SIP, siga los pasos de Configurar una conexión troncal SIP.
Configurar la conexión troncal SIP
Para configurar una conexión troncal SIP, haga lo siguiente:
-
En la página Panel de control de conexiones troncales SIP elásticas, vaya a Conexiones troncales SIP elásticas.
-
Haga clic en Gestionar en el menú de navegación de la izquierda.
-
Pulse Conexiones troncales y seleccione la conexión troncal SIP que ha creado.
-
Haga clic en Originación para configurar sus parámetros.
-
Para añadir el URI SIP de origen, haga clic en el botón Añadir nuevo URI de origen y proporcione valores para los siguientes campos:
- Origination SIP URI- Puede obtener el SIP URI para su integración telefónica en la página de configuración de integración telefónica de watsonx Assistant. Para ello, en watsonx Assistant, inicie la herramienta y cree un asistente. Elija Añadir integración y seleccione Teléfono. Desde el asistente, copie el URI de SIP y péguelo en el campo URI de SIP de origen de Twilio.
- Prioridad-La prioridad clasifica la importancia del URI. Un número más bajo representa la importancia más alta.
- Peso: el peso se utiliza para determinar la compartición de carga cuando más de un URI tiene la misma prioridad. Cuanto más alto sea el valor, más carga se proporciona un URI.
- Habilitado-Es necesario conmutar el conmutador Habilitado a
Yes
. Esto significa que el URI SIP de origen está habilitado.
-
Si tiene previsto dar soporte a las transferencias de llamadas, habilite la Transferencia de llamadas (SIP REFER) en la conexión troncal SIP. Si tiene previsto transferir llamadas a la red telefónica pública conmutada (PSTN), habilite también la Transferencia PSTN en la conexión troncal.
-
Seleccione Números en la barra de navegación para su troncal SIP, y luego haga una de las siguientes cosas:
- Pulse Añadir un número y, a continuación, Comprar un número*.
- Si ya tiene un número, puede pulsar Añadir un número y, a continuación, Añadir un número existente.
Si utiliza una cuenta Lite o Trial Twilio para realizar pruebas, asegúrese de verificar el destino de la transferencia. Para obtener más información, consulte la documentación de Twilio.
No se puede habilitar la autenticación SIP si elige Twilio como proveedor de conexión troncal SIP. Twilio no admite SIPS para llamadas con origen.
Uso de otros proveedores de terceros
Puede solicitar ayuda para configurar una cuenta con otro proveedor de conexión troncal SIP abriendo una solicitud de soporte.
IBM ha establecido relaciones con los siguientes proveedores de conexiones troncales SIP:
El proveedor de conexión troncal SIP configura una conexión troncal SIP para el tráfico de voz y gestiona el acceso desde las direcciones IP permitidas. La mayoría de los principales proveedores de conexiones troncales SIP disponen de relaciones existentes con IBM. Por lo tanto, la configuración de red que es necesaria para dar soporte a la conexión troncal SIP normalmente se puede gestionar automáticamente con un esfuerzo mínimo.
-
Cree un caso deIBM Cloud.
-
En el campo Tema, especifique
watsonx Assistant
. -
En la lista desplegable Subtema, seleccione
Phone & SMS Integration
. -
En el campo Asunto, especifique
SIP trunk provider setup for watsonx Assistant
. -
Incluya la información siguiente en la descripción:
- Nombre de la empresa
- Su ID de cuenta IBM Cloud
- Su nombre de servicio watsonx Assistant
- Diagrama de red con información de dirección IP o del proveedor de la conexión troncal SIP
Traiga su propia conexión troncal SIP
Si prefiere utilizar un proveedor de conexiones troncales SIP con el que IBM no tiene una relación establecida, puede hacerlo.
En la tabla siguiente se muestran los nombres de dominio completos y las direcciones IP que se utilizan para las conexiones SIP.
Ubicación | Nombres de dominio | Direcciones IP |
---|---|---|
Dallas | public.0001.voip.us-south.assistant.watson.cloud.ibm.com public.0002.voip.us-south.assistant.watson.cloud.ibm.com public.0003.voip.us-south.assistant.watson.cloud.ibm.com |
67.228.108.82 169.63.5.162 150.239.30.146 |
Frankfurt | public.0001.voip.eu-de.assistant.watson.cloud.ibm.com public.0002.voip.eu-de.assistant.watson.cloud.ibm.com public.0003.voip.eu-de.assistant.watson.cloud.ibm.com |
161.156.178.162 169.50.56.146 149.81.86.82 |
Londres | public.0001.voip.eu-gb.assistant.watson.cloud.ibm.com public.0002.voip.eu-gb.assistant.watson.cloud.ibm.com public.0003.voip.eu-gb.assistant.watson.cloud.ibm.com |
158.176.120.162 141.125.102.34 158.175.99.34 |
Seúl | public.0001.voip.kr-seo.assistant.watson.cloud.ibm.com | |
Sydney | public.0001.voip.au-syd.assistant.watson.cloud.ibm.com public.0002.voip.au-syd.assistant.watson.cloud.ibm.com public.0003.voip.au-syd.assistant.watson.cloud.ibm.com |
168.1.47.2 135.90.86.50 168.1.106.130 |
Tokio | public.0001.voip.jp-tok.assistant.watson.cloud.ibm.com public.0002.voip.jp-tok.assistant.watson.cloud.ibm.com public.0003.voip.jp-tok.assistant.watson.cloud.ibm.com |
165.192.69.82 128.168.105.178 161.202.149.162 |
Washington, DC | public.0001.voip.us-east.assistant.watson.cloud.ibm.com public.0002.voip.us-east.assistant.watson.cloud.ibm.com public.0003.voip.us-east.assistant.watson.cloud.ibm.com |
52.116.100.158 169.61.70.162 169.59.136.194 |
Migración desde Voice Agent with Watson
Si ha creado una instancia de servicio de IBM® Voice Agent with Watson en IBM Cloud para permitir que los clientes se conecten a un asistente por teléfono, considere la posibilidad de utilizar la integración telefónica en su lugar. Puede utilizar la misma cuenta SIP y el mismo número de teléfono que ha configurado para su uso con Voice Agent with Watson en la integración telefónica.
La integración telefónica proporciona una integración más fluida con el asistente. Sin embargo, actualmente, la integración no da soporte a las funciones siguientes:
- Llamadas salientes
- Configuración de ubicaciones de copia de seguridad
- Reenvío de eventos para guardar informes detallados de llamadas en el servicio de base de datos IBM Cloudant for IBM Cloud
- Revisión de la página de resumen de uso. Utilice en su lugar IBM Log Analysis. Para obtener más información, consulte Visualización de registros.
Para migrar desde Voice Agent with Watson a la integración telefónica de watsonx Assistant, complete el paso siguiente:
-
En la página Voice Agent with Watson, copie el número o los números de teléfono que ha utilizado para la cuenta SIP.
-
Cuando configure la integración de teléfonos de watsonx Assistant, añada el número de teléfono o el conjunto de números que haya copiado en el paso anterior.
-
En la página de configuración de la integración telefónica, copie el identificador uniforme de recursos (URI) de SIP.
-
En la cuenta de la conexión troncal SIP, sustituya el URI de Voice Agent with Watson que ha especificado previamente por el URI que ha copiado de la página de configuración de integración telefónica en el paso anterior.
Por ejemplo, si utiliza una conexión troncal SIP de Twilio, añada el identificador uniforme de recursos (URI) de SIP del asistente al campo de Twilio URI de SIP de origen.
-
Si el proveedor de conexión troncal SIP aún no figura en la lista con la región de watsonx Assistant a la que está migrando, siga estas instrucciones para obtener acceso a la conexión troncal SIP.
Detalles de direccionamiento de las llamadas
Las llamadas entrantes a su asistente siguen este proceso:
-
Un cliente llama al número de teléfono de soporte al cliente gestionado por el proveedor de conexión troncal SIP (Session Initiation Protocol).
-
El servicio troncal SIP envía una solicitud SIP
INVITE
a la integración telefónica de su asistente para establecer una conexión. -
La integración del teléfono se conecta con los servicios de voz necesarios para permitir la interacción.
-
Cuando los servicios están listos, se establece la conexión y se envía un audio at través de RTP (Real-time Transport Protocol).
RTP es un protocolo de red para la entrega de audio y vídeo a través de redes IP.
-
Se procesa la acción de saludo del asistente. El texto de respuesta se envía al servicio Text to Speech para que se convierta en audio y el audio se envía al interlocutor.
-
Cuando el cliente dice algo, el el servicio Speech to Text convierte el audio en texto y lo envía al asistente para su evaluación.
-
El asistente procesa la entrada y calcula la mejor respuesta. El texto de respuesta del asistente se envía al servicio Text to Speech para convertirlo en audio y el audio se envía de nuevo al interlocutor a través de la conexión existente.
-
Si el interlocutor solicita hablar con una persona, el asistente puede transferir la persona a un centro de llamadas. Se envía una solicitud SIP
REFER
al proveedor de conexión troncal SIP para que pueda transferir la llamada al URI SIP del centro de llamadas especificado en el nodo de diálogo en el que está configurada la acción de transferencia. -
Cuando uno de los participantes de la llamada cuelga, se envía una solicitud SIP
BYE
al otro participante.