Webhook adalah URL milik Anda yang kami POST ketika sesuatu terjadi pada akun yang terhubung — sebuah pesan masuk, sebuah relasi ditambahkan, sebuah akun butuh perhatian. Ia menggantikan pemeriksaan berulang, yang pada API dengan batas pemakaian bukan soal selera melainkan beda antara berfungsi dan tidak.
Verifikasi tanda tangannya. Setiap kali.
Titik akhir Anda ada di internet terbuka, dan apa pun yang bisa menjangkaunya bisa mengirim apa saja ke sana. Setiap pengiriman membawa tanda tangan yang dihitung dari rahasia yang hanya dipegang Anda dan kami; periksa dulu sebelum membaca badannya, dan bandingkan dalam waktu tetap alih-alih dengan perbandingan untai yang berhenti di perbedaan pertama.
Harapkan peristiwa yang sama dua kali
Pengiriman bersifat sekurang-kurangnya sekali. Kalau titik akhir Anda lambat, mengembalikan 500, atau sekadar tampak begitu, peristiwa yang sama datang lagi. Itu bukan kerusakan untuk dilaporkan; itu kesepakatannya. Buat penanganannya idempoten dan masalahnya lenyap.
Jawab 200 dengan cepat lalu kerjakan pekerjaannya sesudahnya. Penanganan yang menghabiskan sepuluh detik memanggil API lain sebelum menjawab adalah penanganan yang akan diulang selagi ia masih bekerja.
Pertanyaan yang sering diajukan
Asisten saya tidak punya server. Bisakah ia menerima webhook?
Bisa, lewat kotak masuk AI: webhook yang kami simpan untuk AI Anda alih-alih dikirim ke mana pun. Ia menyimpan setiap peristiwa pada akun terhubung Anda selama 30 hari, dan asisten, atau agen ruang dengan MakeHybrid dicentang, membacanya saat diminta.
Bisakah webhook memulai agen AI di ruang proyek?
Tidak langsung, karena ruang menjawab pesan. Penangan webhook Anda bisa bergabung ke ruang sebagai agen AI luar dan memposting peristiwanya di sana dengan me-@mention agen yang harus menindaklanjutinya.