Dasar-dasar integrasi Twilio

Menampilkan saran real-time dengan mengintegrasikan modul UI dengan Twilio.

Sebelum memulai

Untuk mengintegrasikan modul UI dengan Twilio Flex, Anda memerlukan akses ke resource berikut:

Jika Anda memiliki akses, lakukan langkah-langkah berikut untuk memulai:

  1. Deploy modul backend. Saat men-deploy server backend, tentukan variabel lingkungan AUTH_OPTION menjadi Twilio dengan mengikuti petunjuk deployment.
  2. Clone repositori git ke komputer lokal atau lingkungan pengembangan Anda dengan kode berikut: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations

Langkah 1: Instal Twilio CLI

Untuk menginstal Twilio CLI,

  1. Instal Node 18.
  2. Instal Twilio CLI.

Langkah 2: Instal plugin

Twilio CLI menyediakan dua plugin: Flex dan serverless. Untuk menginstal plugin, Anda memerlukan akses ke hal berikut:

  • NPM versi 6.0.0 atau yang lebih baru (ketik npm -v di terminal untuk memeriksa)
  • Node versi 14, 16, atau 18 (ketik node -v di terminal untuk memeriksa)

Fleksibel

Instal plugin Flex menggunakan perintah plugin Twilio berikut:

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

Serverless

Instal plugin serverless menggunakan perintah plugin Twilio:

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

Langkah 3: Buat profil untuk Twilio CLI

Untuk mengeluarkan perintah CLI yang menyertakan kredensial Twilio Anda, buat profil terlebih dahulu menggunakan perintah berikut:

twilio login

Twilio akan meminta SID akun dan token autentikasi Anda, yang keduanya dapat Anda temukan di dasbor konsol Twilio. Saat diminta untuk memasukkan ID singkat, gunakan nama dev.

Contoh pembuatan 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

Saat Anda menjalankan twilio login (alias untuk twilio profiles:create), twilio login akan menggunakan SID akun dan token autentikasi Anda untuk membuat kunci API, menyimpan kunci dalam file konfigurasi, dan mengaitkan kunci dengan profil untuk mengautentikasi permintaan mendatang. Untuk keamanan, token autentikasi Anda hanya digunakan untuk membuat kunci API dan tidak disimpan secara lokal setelah profil dibuat.

Menetapkan profil aktif

Untuk mengaktifkan profil, jalankan kode berikut: 

twilio profiles:use PROFILE_ID

Gunakan ID singkat dev untuk PROFILE_ID.

Langkah selanjutnya