Menyetel webhook Anda

Webhook adalah callback HTTPS yang dibuat partner yang menentukan cara agen Anda harus merespons pesan dan acara. Kecuali Anda menggunakan setelan otomatis seperti Dialogflow, Anda perlu menyetel webhook kustom untuk menentukan perilaku agen Anda.

Webhook tingkat partner dan tingkat agen

Anda dapat menyetel webhook di tingkat partner atau di tingkat agen. Webhook tingkat partner berlaku untuk setiap agen yang Anda kelola, sedangkan masing-masing webhook 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 serupa, atau jika Anda hanya memiliki satu agen, dapat menggunakan webhook tingkat partner.

Jika Anda telah mengonfigurasi webhook tingkat partner dan webhook tingkat agen, webhook tingkat agen lebih diprioritaskan pada agen spesifiknya, sedangkan webhook tingkat partner berlaku untuk agen yang tidak memiliki platform tingkat agen webhook.

Menetapkan webhook tingkat partner

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

  1. Buka Konsol Developer Komunikasi Bisnis dan login dengan Akun Google Business Messages Anda.
  2. Buka Setelan akun.
  3. Pastikan akun partner yang benar dipilih.
  4. Untuk URL webhook Business Messages, klik Configure.
  5. Untuk URL endpoint Webhook, masukkan URL aplikasi Anda + "/callback/". Misalnya, isi kolom tersebut dapat berupa "https://PROJECT_ID.appspot.com/callback/".
  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 dan kirim respons 200 OK dengan teks biasa parameter secret sebagai isi respons. Misalnya, anggap saja webhook menerima permintaan POST dengan konten isi berikut:

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

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

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

Menetapkan webhook tingkat agen

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

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

  7. Konfigurasi webhook Anda untuk menerima permintaan POST dengan clientToken, lalu kirimkan respons 200 OK dengan nilai parameter secret. 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, tampilkan respons 200 OK dengan URL rahasia disetel ke 0123456789.

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