La parte frontend de la integración de Twilio consta de dos componentes: funciones y complementos de Twilio. Las funciones alojan el documento HTML y los métodos de API necesarios para usar Agent Assist, por lo que no es necesario alojarlos 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 endpoints de API sin servidor que pueden realizar tareas alojadas en Twilio. Proporcionan verificación de usuarios, tokens de servicio de chat y la interfaz de Asistente.
Complemento Twilio Flex
Usa el complemento Flex para personalizar las experiencias y los comportamientos de los agentes y supervisores de Flex. Presentas la consola de Agent Assist al agente en la aplicación Flex.
Variables de entorno
- Crea un archivo llamado
.env
en el directorioagent-assist-functions
. - Crea un archivo llamado
.env.dev
en el directorioagent-assist-plugins
. - Define las siguientes variables de entorno para que el complemento funcione después de la implementación:
Tipo de nombre | Contexto |
---|---|
TWILIO_ACCOUNT_SID |
En el panel de control de Twilio Flex. |
ACCOUNT_SID |
En el panel de control de Twilio Flex. |
AUTH_TOKEN |
En el panel de control 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 del servicio. |
PROXY_SERVER_URL |
Esta es la URL del servidor backend. |
TWILIO_CONVERSATION_PROFILE |
En el panel de control de Twilio Flex. |
TWILIO_FEATURES |
Se trata de una lista separada por comas de funciones de sugerencias de Asistente para agentes que se van a renderizar, como `SMART_REPLY` o `CONVERSATION_SUMMARIZATION`. |
TWILIO_FUNCTIONS_URL |
Esta es la URL de Cloud Run de la aplicación backend después de desplegar las funciones. Selecciona la opción Funciones de asistencia del agente de Twilio. A continuación, verás una URL similar a twilio-agent-assist-functions-####-dev.twil.io. |
TWILIO_DEBUG |
Mostrar registros en la consola: true, false o sin definir. |
Para obtener más información sobre la configuración de variables de entorno, consulta la documentación de Twilio correspondiente.
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.