Nozioni di base sull'integrazione di Twilio

Mostra suggerimenti in tempo reale integrando i moduli UI con Twilio.

Prima di iniziare

Per integrare i moduli dell'interfaccia utente con Twilio Flex, devi disporre dell'accesso alle seguenti risorse:

Una volta ottenuto l'accesso, segui questi passaggi per iniziare:

  1. Esegui il deployment del modulo di backend. Quando esegui il deployment del server di backend, specifica la variabile di ambiente AUTH_OPTION come Twilio seguendo le istruzioni di deployment.
  2. Clona il repository Git sulla tua macchina locale o nel tuo ambiente di sviluppo con il seguente codice: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations

Passaggio 1: installa l'interfaccia a riga di comando Twilio

Per installare l'interfaccia a riga di comando Twilio:

  1. Installa Node 18.
  2. Installa Twilio CLI.

Passaggio 2: installa i plug-in

La CLI Twilio fornisce due plug-in: Flex e serverless. Per installare i plug-in, devi disporre dell'accesso a quanto segue:

  • NPM versione 6.0.0 o successive (per verificare, digita npm -v nel terminale)
  • Versioni di Node 14, 16 o 18 (per controllare, digita node -v nel terminale)

Flex

Installa il plug-in Flex utilizzando il seguente comando del plug-in Twilio:

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

Serverless

Installa il plug-in serverless utilizzando il comando del plug-in Twilio:

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

Passaggio 3: crea un profilo per la CLI Twilio

Per emettere comandi CLI che includono le tue credenziali Twilio, crea prima un profilo utilizzando il seguente comando:

twilio login

Twilio ti chiederà il SID account e il token di autenticazione, che puoi trovare nella dashboard della console Twilio. Quando ti viene chiesto l'identificatore abbreviato, utilizza il nome dev.

Esempio di creazione di un profilo:

$ 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

Quando esegui twilio login (un alias per twilio profiles:create), viene utilizzato il SID account e il token di autenticazione per generare una chiave API, memorizzarla in un file di configurazione e associarla al profilo per autenticare le richieste future. Per motivi di sicurezza, il token di autenticazione viene utilizzato solo per generare la chiave API e non viene memorizzato localmente dopo la creazione del profilo.

Impostare un profilo attivo

Per attivare un profilo, esegui il seguente codice: 

twilio profiles:use PROFILE_ID

Utilizza l'identificatore abbreviato dev per PROFILE_ID.

Passaggi successivi