Conceptos básicos de la integración de Twilio

Integra módulos de IU con Twilio para mostrar sugerencias en tiempo real.

Antes de comenzar

Para integrar módulos de IU con Twilio Flex, necesitas acceso a los siguientes recursos:

Cuando tengas acceso, sigue estos pasos para comenzar:

  1. Implementa el módulo de backend. Cuando implementes el servidor de backend, especifica que la variable de entorno AUTH_OPTION sea Twilio siguiendo las instrucciones de implementación.
  2. Clona el repositorio de git en tu máquina local o entorno de desarrollo con el siguiente código: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations

Paso 1: Instala Twilio CLI

Para instalar la CLI de Twilio, haz lo siguiente:

  1. Instala Node 18.
  2. Instala Twilio CLI.

Paso 2: Instala los complementos

Twilio CLI proporciona dos complementos: Flex y sin servidores. Para instalar los complementos, necesitas acceso a lo siguiente:

  • NPM versión 6.0.0 o posterior (escribe npm -v en la terminal para verificarlo)
  • Versiones de nodo 14, 16 o 18 (escribe node -v en la terminal para verificarlo)

Flex

Instala el complemento Flex con el siguiente comando del complemento de Twilio:

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

Sin servidores

Instala el complemento sin servidor con el comando del complemento de Twilio:

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

Paso 3: Crea un perfil para Twilio CLI

Para emitir comandos de CLI que incluyan tus credenciales de Twilio, primero crea un perfil con el siguiente comando:

twilio login

Twilio te solicitará el SID de tu cuenta y el token de autenticación, que puedes encontrar en el panel de la consola de Twilio. Cuando se te solicite el identificador abreviado, usa el nombre dev.

Ejemplo de creación 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

Cuando ejecutas twilio login (un alias para twilio profiles:create), se usa el SID de tu cuenta y el token de autenticación para generar una clave de API, almacenarla en un archivo de configuración y asociarla con el perfil para autenticar solicitudes futuras. Por motivos de seguridad, tu token de autenticación solo se usa para generar la clave de API y no se almacena de forma local después de crear el perfil.

Cómo establecer un perfil activo

Para activar un perfil, ejecuta el siguiente código: 

twilio profiles:use PROFILE_ID

Usa el identificador abreviado dev para PROFILE_ID.

¿Qué sigue?