Principes de base de l'intégration Twilio

Affichez des suggestions en temps réel en intégrant des modules d'interface utilisateur à Twilio.

Avant de commencer

Pour intégrer des modules d'interface utilisateur à Twilio Flex, vous devez avoir accès aux ressources suivantes:

Une fois que vous y avez accès, procédez comme suit:

  1. Déployez le module backend. Lorsque vous déployez le serveur backend, spécifiez la variable d'environnement AUTH_OPTION sur Twilio en suivant les instructions de déploiement.
  2. Clonez le dépôt Git sur votre machine locale ou dans votre environnement de développement à l'aide du code suivant: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations

Étape 1: Installez la CLI Twilio

Pour installer la CLI Twilio :

  1. Installez Node 18.
  2. Installez la CLI Twilio.

Étape 2: Installez les plug-ins

La CLI Twilio fournit deux plug-ins: Flex et sans serveur. Pour installer les plug-ins, vous devez disposer des éléments suivants:

  • NPM version 6.0.0 ou ultérieure (pour vérifier, saisissez npm -v dans votre terminal)
  • Versions 14, 16 ou 18 de Node (pour vérifier, saisissez node -v dans votre terminal)

Flex

Installez le plug-in Flex à l'aide de la commande de plug-in Twilio suivante:

twilio plugins:install @twilio-labs/plugin-flex

Sans serveur

Installez le plug-in sans serveur à l'aide de la commande du plug-in Twilio:

twilio plugins:install @twilio-labs/plugin-serverless

Étape 3: Créez un profil pour la CLI Twilio

Pour émettre des commandes CLI incluant vos identifiants Twilio, créez d'abord un profil à l'aide de la commande suivante:

twilio login

Twilio vous demandera de fournir le SID de votre compte et votre jeton d'authentification, que vous trouverez dans le tableau de bord de la console Twilio. Lorsque vous êtes invité à saisir l'identifiant abrégé, utilisez le nom dev.

Exemple de création de profil:

$ twilio login
You can find your account SID and auth token at https://www.twilio.com/console
 » Your auth token will be used once to create an API key for future CLI access to your Twilio account or subaccount, then forgotten.
? The account SID for your Twilio account or subaccount: ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
? Your Twilio auth token for your Twilio account or subaccount: [hidden]
? Shorthand identifier for your profile: dev

Lorsque vous exécutez twilio login (un alias de twilio profiles:create), il utilise le SID de votre compte et le jeton d'authentification pour générer une clé API, la stocke dans un fichier de configuration et l'associe au profil pour authentifier les futures requêtes. Pour des raisons de sécurité, votre jeton d'authentification n'est utilisé que pour générer la clé API et n'est pas stocké localement une fois le profil créé.

Définir un profil actif

Pour activer un profil, exécutez le code suivant: 

twilio profiles:use PROFILE_ID

Utilisez l'identifiant abrégé dev pour PROFILE_ID.

Étape suivante