La parte del frontend de la integración de Twilio consta de dos componentes: funciones y complementos de Twilio. Functions aloja el documento HTML y los métodos de API necesarios para usar Agent Assist y reemplaza la necesidad de alojar contenido en otro lugar. Un complemento de Twilio es una forma de presentar la interfaz de Agent Assist en el escritorio del agente.
Funciones de Twilio
Las funciones de Twilio son extremos de API sin servidores que pueden realizar tareas alojadas por Twilio. Proporcionan verificación de usuarios, tokens de servicio de chat y la interfaz de Agent Assist.
Complemento de Twilio Flex
Usa el complemento Flex para personalizar las experiencias y los comportamientos de los usuarios para los agentes y supervisores de Flex. Presentas la consola de Agent Assist al agente dentro de la aplicación de Flex.
Variables de entorno
- Crea un archivo llamado
.env
en el directorioagent-assist-functions
o - Crea un archivo llamado
.env.dev
en el directorioagent-assist-plugins
. - Configura las siguientes variables de entorno para que el complemento funcione después de la implementación:
Tipo de nombre | Contexto |
---|---|
TWILIO_ACCOUNT_SID |
Busca en el panel de Twilio Flex. |
ACCOUNT_SID |
Busca en el panel de Twilio Flex. |
AUTH_TOKEN |
Busca en el panel de Twilio Flex. |
TWILIO_API_KEY |
Crea una en la consola de Twilio. |
TWILIO_API_SECRET |
Crea una en la consola de Twilio. |
TWILIO_CHAT_SERVICE_SID |
Busca el SID de servicio. |
PROXY_SERVER_URL |
Esta es la URL del servidor de backend. |
TWILIO_CONVERSATION_PROFILE |
Busca en el panel de Twilio Flex. |
TWILIO_FEATURES |
Es una lista separada por comas de las funciones de sugerencias de Agent Assist que se renderizarán, como "SMART_REPLY" o "CONVERSATION_SUMMARIZATION". |
TWILIO_FUNCTIONS_URL |
Esta es la URL de Cloud Run para la aplicación de backend después de implementar las funciones. Selecciona la opción Funciones de Twilio Agent Assist. Luego, deberías ver una URL similar a twilio-agent-assist-functions-####-dev.twil.io. |
TWILIO_DEBUG |
Mostrar registros en la consola: Verdadero, falso o sin definir. |
Para obtener más información sobre la configuración de variable de entorno, consulta la documentación relevante de Twilio.
Implementación
Usa la siguiente secuencia de comandos para implementar la solución en tu instancia de Twilio:
npm run deploy:functions #Deploys just the functions to the Twilio instance. npm run deploy:plugin #Deploys just the plugin to the Twilio instance, run command produced in the output to activate.