Noções básicas de integração do Twilio

Mostre sugestões em tempo real integrando módulos UI com o Twilio.

Antes de começar

Para integrar módulos UI com o Twilio Flex, você precisa ter acesso aos seguintes recursos:

Quando tiver acesso, siga estas etapas para começar:

  1. Implante o módulo de back-end. Ao implantar o servidor de back-end, especifique a variável de ambiente AUTH_OPTION como Twilio seguindo as instruções de implantação.
  2. Clone o repositório do git na máquina local ou no ambiente de desenvolvimento com o seguinte código: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations

Etapa 1: instalar a CLI do Twilio

Para instalar a CLI do Twilio,

  1. Instale o Node 18.
  2. Instale a CLI da Twilio.

Etapa 2: instalar plug-ins

A CLI da Twilio oferece dois plug-ins: flexível e sem servidor. Para instalar os plug-ins, você precisa ter acesso a:

  • NPM versão 6.0.0 ou mais recente (digite npm -v no terminal para verificar)
  • Versões do Node 14, 16 ou 18 (digite node -v no terminal para verificar)

Flex

Instale o plug-in Flex usando o seguinte comando do plug-in do Twilio:

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

Sem servidor

Instale o plug-in sem servidor usando o comando do plug-in do Twilio:

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

Etapa 3: criar um perfil para o Twilio CLI

Para emitir comandos da CLI que incluem suas credenciais do Twilio, primeiro crie um perfil usando o seguinte comando:

twilio login

O Twilio vai solicitar o SID da conta e o token de autenticação, que podem ser encontrados no painel do console do Twilio. Quando o identificador abreviado for solicitado, use o nome dev.

Exemplo de criação de perfil:

$ 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 você executa twilio login (um alias para twilio profiles:create), ele usa o SID da conta e o token de autenticação para gerar uma chave de API, armazenar a chave em um arquivo de configuração e associar a chave ao perfil para autenticar solicitações futuras. Por motivos de segurança, seu token de autenticação é usado apenas para gerar a chave de API e não é armazenado localmente após a criação do perfil.

Definir um perfil ativo

Para ativar um perfil, execute o seguinte código: 

twilio profiles:use PROFILE_ID

Use o identificador abreviado dev para a PROFILE_ID.

A seguir