Solusi untuk kegagalan Webhook di Workspace Studio

Anda telah membuat alur kerja di Google Workspace Studio, Anda telah menambahkan langkah tersebut. Kirim webhook Dan permintaan tersebut tidak pernah sampai ke tujuannya. Atau mungkin alurnya berjalan dengan baik dan sekarang terjadi kesalahan. Sebelum mengubah URL secara membabi buta, ada baiknya untuk menyelidiki terlebih dahulu. Pada titik mana eksekusi berhenti?: akses ke langkah tersebut, persetujuan yang tertunda, konfigurasi permintaan, atau respons dari layanan eksternal.

Workspace Studio menggunakan langkah ini untuk mengirimkan Permintaan HTTP ke alamat tertentuIni dapat digunakan untuk memberi tahu alat internal, membuat catatan di aplikasi lain, atau mengirim data ke layanan yang tidak memiliki konektor langsung. Solusinya bergantung pada apakah pemblokiran terjadi di dalam Google Workspace atau di server yang menerima permintaan.

Periksa apakah administrator telah mengaktifkan webhook.

Si Kirim webhook Fitur ini tidak muncul di antara langkah-langkah yang tersedia; mulailah dengan izin organisasi. Google menunjukkan bahwa fitur ini... dinonaktifkan secara default dan bahwa administrator harus mengaktifkannya untuk unit organisasi yang bersangkutan. Jalurnya adalah Konsol admin > Aplikasi > Google Workspace > Workspace Studio > Pengaturan webhook.

Pastikan juga akun Anda memiliki akses ke fitur tersebut: Google terus mengidentifikasi pengiriman webhook sebagai sebuah fitur. pratinjau terbatasJika Anda bukan administrator, berikan nama langkah yang hilang, akun Anda, dan unit organisasi tempat Anda berada kepada administrator Workspace. Ini akan memungkinkan mereka untuk memverifikasi pengaturan yang berlaku tanpa memengaruhi izin pada tim lain.

Tinjau daftar URL yang diizinkan dan persetujuan.

Pada beberapa edisi, administrator dapat membatasi tujuan eksternal menggunakan daftar domain dan URL yang diizinkanJika langkah tersebut ada tetapi Anda tidak dapat terhubung ke titik akhir tertentu, pastikan domain atau URL Anda ada dalam daftar tersebut. Pengaturan ini dikelola dari opsi impor dan pengambilan URL Drive dan Dokumen.

Pembatasan ini Cara kerjanya tidak sama di semua edisi.Daftar izin webhook tersedia di edisi seperti Business Plus, Enterprise Standard dan Plus, serta Education Standard dan Plus. Pada edisi yang tidak menawarkan kontrol ini, mengaktifkan webhook memungkinkan koneksi ke URL yang valid tanpa menerapkan daftar izin ini. Oleh karena itu, disarankan untuk terlebih dahulu memeriksa edisi dan kebijakan organisasi Anda.

Alur tersebut mungkin juga sedang menunggu persetujuan penggunaGoogle memperlakukan pengiriman data ke titik akhir eksternal sebagai tindakan sensitif dan secara default memerlukan peninjauan dan konfirmasi. Jika otomatisasi tampak macet, buka Studio dan periksa permintaan persetujuan yang tertunda sebelum menyimpulkan bahwa server telah gagal.

Konfigurasikan URL, metode, dan data yang dikirim dengan benar.

Buka alirannya di studio.ruang kerja.google.com dan periksa langkah Kirim webhook. Alamatnya seharusnya lengkap dan statisKolom ini menerima URL yang diawali dengan http:// o https://tetapi hal itu tidak memungkinkan penyisipan variabel ke dalam URL itu sendiri. HTTPS adalah opsi yang direkomendasikan. untuk menghindari pengiriman informasi yang tidak terenkripsi; ini bukan persyaratan bidang ini.

• Metode HTTP: Pilih metode yang diharapkan oleh API target. Studio menawarkan GET, POST, PUT, PATCH, dan DELETE; POST adalah metode default.
• Isi permintaan: Ini bersifat opsional dan dikirim sebagai teks. Untuk banyak API, disarankan untuk menggunakan JSON, dengan memperhatikan tanda kutip, kurung kurawal, dan nama field yang dibutuhkan oleh layanan tersebut.
• Variabel: Anda dapat menyertakan data dari langkah-langkah sebelumnya di dalam isi permintaan. Periksa hasilnya ketika sebuah variabel berisi tanda kutip, jeda baris, atau karakter lain yang dapat merusak format JSON.
• Permintaan GET: Studio mengabaikan isi permintaan (request body) dengan metode ini. Jika layanan tersebut memerlukan data dalam isi permintaan, periksa metode mana yang didukung oleh dokumentasinya.

Buatlah pelaksanaan pengujian Dan ingat bahwa ini akan mengirimkan permintaan sebenarnya ke tujuan. Jika langkah ini berhasil, responsnya akan tersedia sebagai variabel teks untuk digunakan nanti dalam alur yang sama.

Gunakan tab Aktivitas untuk menemukan masalahnya.

Setelah setiap eksekusi, buka Aktivitas di Workspace Studio. Jika permintaan berhasil, Anda dapat meninjau data yang dikirim dan respons yang diterima. Jika gagal, Studio akan menampilkan kode kesalahan dan respons URL tujuanInformasi ini memungkinkan kita untuk membedakan antara masalah konfigurasi dalam alur dan penolakan yang disebabkan oleh layanan eksternal.

Un 400 Hal ini biasanya menunjukkan bahwa penerima tidak menerima permintaan sebagaimana adanya; mereka meninjau metode dan isi permintaan tersebut. Dalam hal terjadi 401 atau 403Periksa persyaratan akses layanan dan batasan yang diterapkan oleh organisasi Anda. 404 Ini meminta Anda untuk memverifikasi rute titik akhir. Jika 429Periksa batasan permintaan Anda; kesalahan 5xx Angka tersebut biasanya mengindikasikan masalah pada layanan penerima. Respons spesifik dari titik akhir lebih bermanfaat daripada menafsirkan angka tersebut secara terpisah.

Administrator juga dapat berkonsultasi dengan Log peristiwa Workspace Studio untuk menyelidiki permintaan webhook. Akses ke data tertentu, seperti URL yang diminta, dibatasi karena mungkin berisi informasi sensitif.

Jangan sampai Anda salah mengira webhook Studio dengan webhook Google Chat yang masuk.

Langkah Kirim webhook Workspace Studio mengirimkan permintaan ke URL eksternal. webhook Google Chat masukSebaliknya, ini adalah URL yang dibuat di dalam ruang agar sistem lain dapat memposting pesan di sana. Keduanya merupakan elemen terpisah, meskipun Anda dapat menggunakan URL Obrolan sebagai tujuan untuk alur Studio.

Jika tujuan Anda adalah memasang iklan di Google Chat, pertama-tama periksa apakah langkah 1 sudah cukup. Publikasikan di suatu ruang dari Studio. Jika Anda perlu menggunakan webhook masuk, Anda harus membuatnya dari Aplikasi dan integrasi dari ruang tersebut dan menjaga URL-nya tetap privat, yang mencakup kunci dan token. Webhook ini digunakan untuk mengirim pesan ke ruang tersebut, tetapi tidak memungkinkan percakapan dengan pengguna.

Google Chat menerapkan kuota bersama untuk webhook yang masuk. satu permintaan per detik dan per ruangBatasan ini berlaku untuk Obrolan; ini bukan batasan umum untuk langkah Kirim Webhook di Workspace Studio. Jika kesalahan terjadi saat memposting banyak pengumuman berturut-turut ke ruang yang sama, periksa kuota ini bersama dengan respons permintaan.

Periksa kuota aliran jika kesalahan terjadi secara berkala.

Workspace Studio memungkinkan Anda membuat hingga 25 alur per pengguna, dengan maksimum 20 langkah per alurSelain itu, sistem ini menerapkan batasan gabungan pada jumlah eksekusi selama setiap periode 24 jam. Jika Anda mencapai batasan ini, eksekusi selanjutnya akan gagal hingga penghitung diatur ulang.

Jika webhook hanya gagal setelah banyak aktivasi, periksa Aktivitas Periksa batasan Studio dan batasan layanan target. Memperbaiki pemicu—misalnya, membatasinya pada pengirim atau peristiwa tertentu—dapat mencegah permintaan yang tidak perlu. Jika kesalahan terjadi pada percobaan pertama, mulailah dengan memeriksa izin, persetujuan yang tertunda, dan respons endpoint.