Incluir encabezados SIP personalizados y compatibilidad con REFERIDOS
Aumente la cantidad de información que se pasa con solicitudes SIP con encabezados X SIP personalizados y gestione las desconexiones con mayor elegancia con SIP REFER.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Enterprise Edition, Unlimited Edition y Developer Edition con Foundation Edition o Agentforce 1 Edition y complementos de Salesforce Voice. |
| Permisos de usuario necesarios | |
|---|---|
| Para abrir, modificar o crear un flujo en Flow Builder: | Gestionar flujo |
Antes de empezar, trabaje con su socio de SIP para asegurarse de que sus solicitudes de SIP incluyen encabezados X o encabezados personalizados a los que puede hacer referencia en sus flujos. Para utilizar SIP REFER, compruebe que su socio admite este protocolo para desconexiones.
Para empezar, active una configuración para capturar encabezados SIP personalizados en llamadas entrantes y pasar datos contextuales enriquecidos como intención del cliente, preferencia de idioma o información de autenticación a Agentforce Voice. Para gestionar desconexiones al distribuir a un representante, establezca el método de desconexión como SIP REFER en el flujo de distribución. Para gestionar cualquier otro tipo de desconexiones que no sean de distribución, como el descolgamiento automático de agentes o la finalización de sesión de agentes debido a que no hay respuesta del cliente, establezca el método de desconexión como SIP REFER en el flujo de reserva. En ambos escenarios de desconexión, el Controlador de bordes de sesión (SBC) o la plataforma de telefonía redirige la llamada a un URI utilizando el encabezado de respuesta Referirse a URI. También puede elegir establecer el método de desconexión como SIP BYE si es necesario.
Consideraciones sobre encabezados personalizados y REFERIDOS SIP
- Los valores de encabezado X personalizados tienen una longitud máxima de 255. Este límite no se aplica a encabezados X-SF como X-SF-Token.
- El número máximo de encabezados SIP personalizados se basa en el límite de campos personalizados permitidos por objeto para el objeto Datos de sesión de llamada de Voice. Los campos estándar y los encabezados X-SF no cuentan en ese límite.
- Salesforce recibe valores de encabezado que se envían en un SIP INVITE y los devuelve en una respuesta. Puede actualizar un valor de encabezado en un flujo de modo que el valor de respuesta difiera. Para no devolver un encabezado, establezca el valor del campo como nulo.
- Si utiliza SIP REFER, debe establecer un valor Refer to URI en el objeto VoiceCallSessionData.
Active la configuración Incluir encabezados SIP personalizados y REFERIR asistencia
- Desde Configuración, en el cuadro Búsqueda rápida, introduzca Agencia Voice y, a continuación, seleccione Agencia Voice Configuración.
- Bajo Pasos de configuración en la página Configuración de Agentforce Voice, seleccione la ficha SIP / Enrutamiento dinámico.
-
Active Incluir encabezados SIP personalizados y refiera asistencia.
La configuración entra en vigor en cinco a diez minutos.
Crear campos personalizados para datos de sesiones de llamadas de voz
Opcionalmente, para enviar encabezados personalizados en la solicitud REFER o BYE, cree campos personalizados en el objeto Datos de sesión de llamada de Voice. Salesforce pasa los campos estándar Datos de sesión de llamada de voz y los valores de campo personalizados como encabezados SIP en solicitudes. Para campos personalizados,
X_Account_ID__c se convierte en X-Account-ID como encabezado, sustituyendo guiones bajos por guiones. Consulte Crear un campo personalizado para obtener más información.
No es necesario crear campos personalizados para enviar encabezados X-SF como X-SF-Token o enviar campos estándar en el objeto Datos de sesión de llamada de Voice como encabezados.
Modificar el flujo de distribución
Modifique el flujo de OmniCanal saliente que enruta las conversaciones de su agente a otro destino, como un representante de servicio, una cola o un agente diferente. Utilice este flujo para seleccionar el protocolo para desconexiones y cualquier encabezado personalizado que desee enviar con solicitudes SIP.
- En Configuración, en el cuadro Búsqueda rápida, introduzca Flujos y, a continuación, seleccione Flujos.
- Para abrir su flujo de distribución en Flow Builder, selecciónelo.
- Asegúrese de que el flujo tiene una variable de entrada recordId que almacena el Id. de registro de llamada de Voice. El tipo de datos es Texto y la variable está Disponible para entrada. Cree esta variable si no existe.
-
Opcionalmente, agregue un elemento Obtener registros para obtener datos de registros de Llamada de Voice para su uso en una solicitud de REFERIDO SIP en el siguiente paso.
Por ejemplo, almacene el valor Número de teléfono Para en una variable para utilizar en el valor SIP Referenciado por información.
-
Para actualizar campos en el registro Datos de sesión de llamada de voz de la sesión, agregue un elemento Actualizar registros. Cada registro Datos de sesión de llamada de Voice almacena temporalmente metadatos de sesión, incluyendo encabezados SIP personalizados.
- En Cómo encontrar registros para actualizar y establecer sus valores, seleccione Especificar condiciones para identificar registros y establecer campos de forma individual.
- Para Objeto, seleccione Datos de sesión de llamada de voz.
- Para Requisitos de condición para actualizar registros, especifique Se cumplen todas las condiciones (AND) Id. de llamada de voz igual a recordId.
-
Para gestionar desconexiones utilizando SIP REFER para situaciones donde falla una distribución de un agente a otro destino, establezca el campo Método de desconexión SIP en SIP_REFER. Establezca el campo Referir a URI de SIP como su valor de URI de referencia de SIP preferido, donde se debe enviar la llamada. También recomendamos establecer el campo Información de referencia de SIP para identificar el usuario o entidad que inició la transferencia de llamada. Para gestionar desconexiones durante una distribución con SIP BYE en su lugar, deje Método de desconexión de SIP en su valor predeterminado, SIP_BYE.
Para obtener más información acerca de los campos disponibles, consulte VoiceCallSessionData.
-
Opcionalmente, establezca encabezados personalizados o actualice valores de encabezado para enviar información de vuelta a la plataforma de SBC o telefonía en la solicitud REFER o BYE.
Salesforce pasa valores de campo Datos de sesión de llamada de voz como encabezados SIP en solicitudes. Para campos personalizados,
X_Account_ID__cse convierte enX-Account-IDcomo encabezado. Para evitar que se incluyan encabezados en solicitudes, establezca el valor de campo como nulo (en blanco).
Crear un flujo de reserva
Para gestionar situaciones donde se desconecta una llamada entre un agente y un cliente, como cuando un cliente deja de hablar durante un periodo prolongado (colgamiento semántico), cuando un agente finaliza la sesión de forma abrupta debido a un problema o si hay una desconexión durante la distribución, cree un flujo de reserva iniciado automáticamente. Utilice este flujo para seleccionar el protocolo SIP y cualquier encabezado personalizado que desee enviar en caso de desconexión.
- En Configuración, en el cuadro Búsqueda rápida, introduzca Flujos y, a continuación, seleccione Flujos.
- Haga clic en Nuevo flujo y cree un flujo iniciado automáticamente. Para evitar enrutamiento adicional, no utilice un flujo de OmniCanal para este paso.
- Cree una variable de entrada que almacena el Id. de registro de llamada de Voice. Asigne un nombre a la variable recordId, establezca el tipo de datos como Texto, seleccione Disponible para entrada y luego haga clic en Listo.
-
Agregue un elemento Actualizar registros para actualizar los campos Datos de sesión de llamada de voz.
- En Cómo encontrar registros para actualizar y establecer sus valores, seleccione Especificar condiciones para identificar registros y establecer campos de forma individual.
- Para Objeto, seleccione Datos de sesión de llamada de voz.
- Para Requisitos de condición para actualizar registros, especifique Se cumplen todas las condiciones (AND) Id. de llamada de voz igual a recordId.
-
Para gestionar desconexiones utilizando SIP REFER, establezca el campo Método de desconexión de SIP en SIP_REFER. Establezca el campo Referir a URI de SIP como su valor de URI de referencia de SIP preferido, donde se debe enviar la llamada. También recomendamos establecer el campo Información de referencia de SIP para identificar el usuario o entidad que inició la transferencia de llamada. Para gestionar desconexiones durante una distribución con SIP BYE en su lugar, deje Método de desconexión de SIP en su valor predeterminado, SIP_BYE.
Para obtener más información acerca de los campos disponibles, consulte VoiceCallSessionData.
-
Opcionalmente, establezca encabezados personalizados o actualice valores de encabezado para enviar información de vuelta a la plataforma de SBC o telefonía en la solicitud REFER o BYE.
Salesforce pasa valores de campo Datos de sesión de llamada de voz como encabezados SIP en solicitudes. Para campos personalizados,
X_Account_ID__cse convierte enX-Account-IDcomo encabezado. Para evitar que se incluyan encabezados, establezca su valor de campo como nulo (en blanco).
Actualizar el flujo entrante
Para especificar el flujo iniciado automáticamente de reserva, actualice el flujo de OmniCanal entrante para el agente. Salesforce utiliza el Nombre de API de flujo de reserva del registro Datos de sesión de llamada de voz para identificar el flujo de reserva.
- En Configuración, en el cuadro Búsqueda rápida, introduzca Flujos y, a continuación, seleccione Flujos.
- Para abrir el flujo de OmniCanal entrante en Flow Builder, selecciónelo.
-
Agregue un elemento Actualizar registros para actualizar datos de sesiones de llamadas de voz. Establezca el campo Nombre de API de flujo de reserva en el nombre de API del flujo de reserva que creó anteriormente.
Si no especifica un flujo de reserva, en caso de una desconexión, Salesforce envía SIP_BYE como el método de desconexión y sin encabezados personalizados.
Tras probar llamadas entrantes en su entorno sandbox, repita los pasos de este artículo para activar el parámetro y configurar flujos en producción.
