Lihat konektor yang didukung untuk Application Integration.

Pemicu webhook

Pratinjau — Webhook trigger

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Pemicu webhook adalah pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa apa pun dari backend yang mendukung webhook. Pemicu Webhook menerima peristiwa dari aplikasi berbasis SaaS pihak ketiga yang mendukung kemampuan peristiwa webhook. Pemicu ini mendukung beberapa jenis autentikasi untuk pemroses peristiwa Anda.

Penting: Integration Connectors adalah komponen yang dapat ditagih dari Google Cloud. Untuk mengetahui informasi tentang biaya dan tagihan penggunaan Integration Connectors, lihat Harga Integration Connectors.

Sebelum memulai

Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu webhook, pastikan Anda memiliki peran Identity and Access Management (IAM) berikut di project:

• Connector Admin (roles/connectors.admin)

Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.

Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk Pemicu webhook:

• Pemanggil Integrasi Aplikasi (roles/integrations.integrationInvoker)

Untuk mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Tambahkan pemicu Webhook

Untuk menambahkan Pemicu webhook ke integrasi Anda, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Integrasi Aplikasi

2. Di menu navigasi, klik Integrasi.

   Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Buat Integrasi.
   2. Pilih region untuk integrasi.
      Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, Klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk mengetahui informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Buat.

   Integrasi yang baru dibuat akan terbuka di editor integrasi.

4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen Pemicu webhook di editor integrasi.

Untuk mengonfigurasi Webhook trigger, Anda dapat menggunakan koneksi Webhook yang ada dan tersedia di Integration Connectors, atau membuat koneksi Webhook baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu Webhook menggunakan koneksi yang ada

Anda dapat mengonfigurasi Pemicu webhook menggunakan koneksi Webhook yang ada di Integration Connectors. Perhatikan bahwa pemicu Webhook adalah pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi Webhook dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk mengetahui informasi tentang cara mengonfigurasi pemicu Webhook menggunakan koneksi Webhook baru, lihat Mengonfigurasi pemicu Webhook menggunakan koneksi baru

Untuk mengonfigurasi Pemicu webhook menggunakan koneksi Webhook yang ada, lakukan langkah-langkah berikut:

1. Klik elemen Pemicu webhook di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Region: Pilih region koneksi Webhook Anda.
   2. Koneksi: Pilih koneksi Webhook yang ingin Anda gunakan.

      Integrasi Aplikasi hanya menampilkan koneksi Webhook yang aktif dan telah mengaktifkan langganan peristiwa.

   3. Jenis langganan peristiwa: Masukkan jenis peristiwa yang ingin Anda gunakan untuk memicu integrasi.
   4. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu Webhook.
4. Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Koneksi webhook.

Mengonfigurasi pemicu Webhook menggunakan koneksi baru

Untuk mengonfigurasi pemicu Webhook menggunakan koneksi Webhook baru, lakukan langkah-langkah berikut:

1. Klik elemen Pemicu webhook di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Lewati kolom Region.
4. Klik Connection dan pilih opsi Create Connection dari menu.
5. Selesaikan langkah-langkah berikut di panel Buat Koneksi:
   1. Di bagian Location, pilih lokasi untuk koneksi.
      1. Region: Pilih lokasi dari daftar.

         Region yang didukung untuk konektor meliputi:

         Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

      2. Klik Berikutnya.
   2. Di bagian Connection Details, selesaikan langkah-langkah berikut:
      1. Konektor: Pilih Webhook dari menu drop-down Konektor yang tersedia.
      2. Versi konektor: Pilih versi Konektor dari daftar drop-down versi yang tersedia.
      3. Nama Koneksi: Masukkan nama untuk instance Koneksi.

         Nama koneksi harus memenuhi kriteria berikut:

         • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
         • Huruf harus berupa huruf kecil.
         • Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
         • Nama koneksi tidak boleh melebihi 49 karakter.
         • Untuk konektor yang mendukung langganan peristiwa, nama koneksi tidak boleh diawali dengan awalan "goog".
      4. Deskripsi: Masukkan deskripsi untuk instance koneksi (opsional).
      5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
      6. Langganan Peristiwa: Langganan peristiwa akan diaktifkan secara default dan wajib untuk konektor webhook.
         Catatan: Opsi Enable event subscription, entity and actions tidak didukung untuk koneksi ini.
      7. Atau, klik + Tambahkan label untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
      8. Klik Berikutnya.
   3. Di bagian Event Subscription Details, selesaikan langkah-langkah berikut:
      1. Autentikasi Pemroses: Pilih jenis autentikasi untuk pemroses peristiwa dan masukkan detail yang relevan.

         Jenis autentikasi berikut didukung oleh pemroses webhook:

         • Tanpa Autentikasi
         • Autentikasi Google: Pastikan akun layanan memiliki peran roles/connectors.listener yang token aksesnya digunakan untuk autentikasi.
         • Autentikasi Kunci API
         • Autentikasi Dasar
      2. Lokasi Kolom Jenis Peristiwa: Kolom wajib diisi yang menunjukkan lokasi (Header, Parameter Kueri, atau Isi Permintaan) tempat jenis peristiwa yang terkait dengan permintaan peristiwa masuk akan ada.
      3. Nama Kolom Jenis Peristiwa: Kolom wajib di lokasi yang dikonfigurasi mengidentifikasi jenis peristiwa yang terkait dengan permintaan peristiwa masuk.

      {
      "event_type": "user.created",
      ...
      // other request fields
      ...
      }

      Dalam contoh di atas, kolom event_type di isi permintaan menandakan bahwa permintaan berkaitan dengan peristiwa "user.created".
      4. Pilih Aktifkan konektivitas pribadi untuk konektivitas yang aman antara aplikasi backend dan koneksi Anda. Jika memilih opsi ini, Anda harus melakukan langkah-langkah konfigurasi tambahan setelah membuat koneksi. Untuk mengetahui informasi selengkapnya, lihat Konektivitas pribadi untuk langganan peristiwa.
      5. Masukkan konfigurasi pesan yang dihentikan pengirimannya. Jika Anda mengonfigurasi pesan yang dihentikan pengirimannya, koneksi akan menulis peristiwa yang belum diproses ke topik Pub/Sub yang ditentukan. Masukkan detail berikut:
         1. Project ID pesan yang tidak terkirim: Project ID Google Cloud tempat Anda mengonfigurasi topik Pub/Sub pesan yang tidak terkirim.
         2. Topik yang dihentikan pengirimannya: Topik Pub/Sub tempat Anda ingin menulis detail peristiwa yang belum diproses.
      6. Klik Berikutnya.
   4. Tinjau: Tinjau detail autentikasi pendengar dan koneksi Anda.
   5. Klik Buat.

Output pemicu

Pemicu webhook memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan acara di panel konfigurasi pemicu pada bagian Detail Langganan Acara.

Pemicu webhook menunjukkan status langganan peristiwa menggunakan status berikut:

• Creating: Menunjukkan bahwa pemicu berlangganan ke langganan peristiwa.
• Active: Menunjukkan bahwa pemicu berhasil berlangganan langganan peristiwa.
• Error: Menunjukkan bahwa ada masalah dengan langganan peristiwa yang dikonfigurasi.

Selain status langganan acara, bagian Event Subscription details juga menampilkan detail lain seperti region koneksi, nama koneksi, nama langganan acara, dan lainnya.

Variabel output pemicu

Untuk setiap peristiwa, Pemicu webhook menghasilkan variabel output ConnectorEventPayload yang dapat Anda gunakan dalam tugas hilir. Variabel output dalam format JSON yang berisi skema payload Webhook output.

Melihat langganan acara

Untuk melihat dan mengelola semua langganan peristiwa yang terkait dengan koneksi di Integration Connectors, lakukan hal berikut:

1. Buka halaman Integration Connectors > Connections.

   Buka halaman Koneksi

2. Klik koneksi yang langganannya ingin Anda lihat.
3. Klik tab Langganan acara.

   Tindakan ini akan menampilkan semua langganan peristiwa untuk koneksi.

Mengedit pemicu Webhook

Anda dapat mengedit Pemicu webhook untuk mengubah atau memperbarui konfigurasi koneksi dan detail langganan peristiwa.

Penting: Saat mengedit atau mengubah pemicu Webhook, Anda dapat mempertahankan langganan peristiwa yang sebelumnya dikonfigurasi dan dilampirkan ke pemicu, atau menghapusnya. Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan yang menggunakan langganan peristiwa tersebut.

Untuk mengedit pemicu Webhook, lakukan langkah-langkah berikut:

1. Klik elemen Pemicu webhook di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Configure Webhook trigger.
3. Lakukan tindakan berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Untuk mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya, klik Pertahankan, atau klik Hapus.
      Peringatan: Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan peristiwa tersebut. Tugas ini tidak dapat diurungkan.
   2. Perbarui konfigurasi koneksi dan detail langganan peristiwa sesuai keinginan.
   3. Klik Selesai.

Anda dapat melihat detail koneksi dan langganan peristiwa yang diperbarui di panel konfigurasi pemicu di bagian Detail Langganan Peristiwa.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah berikutnya

• Pelajari semua tugas dan pemicu.
• Pelajari cara menguji dan memublikasikan integrasi.
• Pelajari penanganan error.
• Pelajari log eksekusi integrasi.