Menyetel webhook Anda

Webhook adalah callback HTTPS yang dibuat partner yang menentukan cara agen Anda merespons pesan dan peristiwa. Kecuali jika Anda menggunakan solusi otomatis bawaan seperti Dialogflow, Anda perlu menetapkan webhook kustom untuk menentukan perilaku agen Anda.

Webhook tingkat partner dan webhook

Anda dapat menetapkan webhook di tingkat partner atau di tingkat agen. Webhook tingkat partner berlaku untuk setiap agen yang Anda kelola, sedangkan webhook tingkat agen masing-masing berlaku untuk satu agen individual.

Jika Anda mengoperasikan beberapa agen dengan perilaku berbeda, Anda dapat menetapkan webhook berbeda untuk setiap agen menggunakan setelan tingkat agen. Di sisi lain, jika agen Anda memiliki perilaku yang serupa atau jika Anda hanya memiliki satu agen, Anda dapat menggunakan webhook tingkat partner.

Jika Anda memiliki webhook tingkat partner dan webhook tingkat agen yang dikonfigurasi, webhook tingkat agen akan didahulukan pada agen tertentu, sementara webhook tingkat partner berlaku untuk agen yang tidak memiliki webhook tingkat agen.

Menetapkan webhook tingkat partner

Untuk menyetel webhook tingkat partner, ikuti langkah-langkah berikut:

  1. Buka Konsol Developer Komunikasi Bisnis dan login dengan akun Google Business Messages.
  2. Buka Setelan akun.
  3. Pastikan akun partner yang benar dipilih.
  4. Untuk URL webhook Business Messages, klik Konfigurasikan.
  5. Untuk URL endpoint webhook, masukkan URL aplikasi + "/callback/". Misalnya, mungkin seperti "https://PROJECT_ID.appspot.com/callback/".
  6. Catat nilai clientToken Anda. Anda perlu memverifikasi bahwa pesan yang Anda terima berasal dari Google.

  7. Konfigurasikan webhook Anda untuk menerima permintaan POST dengan parameter clientToken yang ditentukan dan kirim respons 200 OK dengan nilai teks biasa dari parameter rahasia sebagai isi respons. Misalnya, webhook Anda menerima permintaan POST dengan konten isi berikut:

    {
"clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    Dalam hal ini, webhook Anda harus mengonfirmasi nilai clientToken dan, jika clientToken benar, menampilkan respons 200 OK dengan 0123456789 sebagai isi respons.

  8. Di konsol, klik Verifikasi. Saat Business Messages memverifikasi webhook Anda, dialog akan ditutup.

Menetapkan webhook tingkat agen

Anda menerima pesan yang dikirim ke agen Anda di webhook tingkat partner. Jika ingin pesan bagi agen tertentu tiba di webhook yang berbeda, Anda dapat menetapkan webhook tingkat agen.

  1. Buka Konsol Developer Komunikasi Bisnis dan login dengan akun Google Business Messages.
  2. Klik agen Anda.
  3. Klik Integrations.
  4. Untuk Webhook, klik Configure.
  5. Untuk URL endpoint webhook, masukkan URL webhook Anda, dimulai dengan "https://".
  6. Catat nilai clientToken Anda. Anda memerlukannya untuk memverifikasi bahwa pesan yang Anda terima berasal dari Google.

  7. Konfigurasi webhook Anda untuk menerima permintaan POST dengan parameter clientToken yang ditentukan dan kirim respons 200 OK dengan nilai parameter rahasia. Misalnya, webhook Anda menerima permintaan POST dengan konten isi berikut:

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    Dalam hal ini, webhook Anda harus mengonfirmasi nilai clientToken dan, jika clientToken benar, menampilkan respons 200 OK dengan parameter URL rahasia yang ditetapkan ke 0123456789.

  8. Di konsol, klik Verifikasi. Saat Business Messages memverifikasi webhook Anda, dialog akan ditutup.