La partie frontend de l'intégration Twilio comprend deux composants : les fonctions et les plug-ins Twilio. Les fonctions hébergent le document HTML et les méthodes d'API nécessaires pour utiliser Agent Assist, ce qui évite d'avoir à les héberger ailleurs. Un plug-in Twilio permet de présenter l'interface Agent Assist sur le poste de travail de l'agent.
Fonctions Twilio
Les fonctions Twilio sont des points de terminaison d'API sans serveur qui peuvent effectuer des tâches hébergées par Twilio. Elles fournissent la validation des utilisateurs, les jetons de service de chat et l'interface Agent Assist.
Plug-in Twilio Flex
Utilisez le plug-in Flex pour personnaliser les expériences et les comportements des agents et des superviseurs Flex. Vous présentez la console Agent Assist à l'agent dans l'application Flex.
Variables d'environnement
- Créez un fichier nommé
.envdans le répertoireagent-assist-functionsou - Créez un fichier nommé
.env.devdans le répertoireagent-assist-plugins. - Définissez les variables d'environnement suivantes pour que le plug-in fonctionne après le déploiement :
| Type de nom | Contexte |
|---|---|
TWILIO_ACCOUNT_SID |
Recherchez-le dans le tableau de bord Twilio Flex. |
ACCOUNT_SID |
Recherchez-le dans le tableau de bord Twilio Flex. |
AUTH_TOKEN |
Recherchez-le dans le tableau de bord Twilio Flex. |
TWILIO_API_KEY |
Créez-le dans la console Twilio. |
TWILIO_API_SECRET |
Créez-le dans la console Twilio. |
TWILIO_CHAT_SERVICE_SID |
Localisez le SID du service. |
PROXY_SERVER_URL |
Il s'agit de l'URL du serveur backend. |
TWILIO_CONVERSATION_PROFILE |
Recherchez-le dans le tableau de bord Twilio Flex. |
TWILIO_FEATURES |
Il s'agit d'une liste de fonctionnalités de suggestion Agent Assist à afficher, séparées par une virgule, par exemple : `SMART_REPLY`, `CONVERSATION_SUMMARIZATION`. |
TWILIO_FUNCTIONS_URL |
Il s'agit de l'URL Cloud Run de l'application backend après le déploiement des fonctions. Sélectionnez l'option Twilio Agent Assist Functions (Fonctions Twilio Agent Assist). Une URL semblable à twilio-agent-assist-functions-####-dev.twil.io devrait alors s'afficher. |
TWILIO_DEBUG |
Afficher les journaux dans la console : True, false ou non défini. |
Pour en savoir plus sur la configuration des variable d'environnement, consultez la documentation Twilio correspondante.
Déploiement
Utilisez le script suivant pour déployer la solution dans votre instance 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.