Memeriksa integrasi eksternal
Terakhir diperbarui: 6 Juli 2026
Toko pakaian daring "Lemari Hangat" telah menyiapkan sebuah Webhook (integrasi yang mengirim notifikasi ke program luar ketika terjadi perubahan pada konten) yang secara otomatis memberi tahu bot notifikasi internal setiap kali sebuah produk baru didaftarkan. Namun suatu hari penanggung jawabnya berkata, "Akhir-akhir ini notifikasi produk baru sama sekali tidak datang." Hal pertama yang harus dipastikan adalah apakah notifikasi memang tidak terkirim, atau terkirim tetapi terlewat di sisi bot.
Webhook adalah perangkat yang berjalan dengan sendirinya begitu dibuat, jadi biasanya tidak perlu diperhatikan. Namun program luar yang menerima notifikasi berada di luar jangkauan kita, sehingga suatu saat akan tiba hari ketika program itu tidak merespons atau mengembalikan kesalahan. Halaman ini membahas cara memastikan apakah Webhook yang telah disiapkan berjalan dengan baik, serta cara menemukan panggilan yang gagal dan menanganinya sesuai penyebabnya, dalam bentuk resep per situasi.
Apa itu Webhook dan cara membuat, menyalakan, mematikan, serta mengubahnya dibahas di Webhook. Di sini kita berfokus pada sisi mengoperasikan dan memeriksa Webhook yang sudah dibuat.
Apa yang tercatat dalam riwayat panggilan
Setiap kali Webhook mengirim permintaan ke program luar, setiap panggilan tersebut tercatat dalam riwayat panggilan. Setiap catatan memuat hal berikut.
- Kapan dikirim, dan berapa lama waktu pemrosesannya
- Perubahan apa yang memicu pengiriman (misalnya, pendaftaran produk)
- Ke alamat mana dikirim
- Kode respons yang dikembalikan program luar (angka hasil yang menunjukkan bagaimana permintaan diproses)
- Apakah panggilan tersebut berhasil atau gagal
Riwayat panggilan terdiri dari dua lapis. Pertama, ada daftar yang menampilkan panggilan secara urut waktu, dan ketika Anda membuka salah satu entri dari daftar itu, muncul detail panggilan tersebut. Pada detail, Anda dapat melihat langsung permintaan yang benar-benar kita kirim dan respons yang dikembalikan program luar.
Ketika Anda menekan nama pada daftar Webhook, layar detail terbuka, dan daftar ini muncul di tab Webhook Calls di bagian atas. Catatan yang dikirim Bot Notifikasi Produk Baru milik "Lemari Hangat" setiap kali sebuah produk didaftarkan tampak seperti ini.
Pada daftar hanya tampil ringkas Webhook Dipanggil pada dan Call Result, sedangkan informasi selebihnya seperti ke alamat mana dan karena apa dikirim baru terlihat setelah Anda menekan baris untuk membuka detail. Jika daftar terlihat usang, Anda dapat memuatnya ulang dengan Segarkan Calls di kanan atas.
Berhasil atau gagal ditentukan oleh kode respons. Jika kode respons berada dalam rentang normal (umumnya kisaran 200 dan 300), panggilan dicatat sebagai berhasil; jika angkanya di luar itu, dicatat sebagai gagal. Jika program luar sama sekali tidak merespons, atau respons yang dikembalikan terlalu besar, panggilan tersebut juga tetap tercatat sebagai gagal.
Memastikan notifikasi terkirim dengan baik
Untuk memastikan apakah perkataan penanggung jawab itu benar, pertama-tama lihat berapa persen dari panggilan yang selama ini dikirim Webhook ini berhasil. Tingkat keberhasilan panggilan langsung terlihat pada daftar Webhook.
- Buka layar Webhook di pengaturan Space toko pakaian.
- Pada daftar, periksa kolom Successful Calls(%) di baris
Bot Notifikasi Produk Baru.
Misalnya, tampil seperti "66,67%". Jika 100%, berarti semua panggilan yang dikirim selama ini berhasil, dan dalam hal itu yang melewatkan adalah botnya. Jika lebih rendah dari 100%, artinya notifikasi itu sendiri pernah tersendat saat dikirim, jadi penyebabnya kita cari di bagian berikutnya.
Jika belum ada satu pun panggilan yang dikirim selama ini, berarti notifikasi bukan gagal, melainkan memang tidak pernah terkirim. Ini terjadi ketika Webhook dalam keadaan mati (INACTIVE), atau ketika selama itu tidak ada perubahan yang cocok dengan kondisi yang telah Anda pasang. Dalam hal ini, periksa di Webhook apakah ia menyala dan diatur untuk menanggapi perubahan yang mana.
Menemukan penyebab panggilan yang gagal
Jika terlihat kegagalan, buka satu panggilan tersebut untuk melihat apa yang salah. Pada detail, permintaan yang kita kirim dan respons yang dikembalikan program luar ditampilkan bersama.
- Pada tab Webhook Calls milik
Bot Notifikasi Produk Baru, tekan baris yang hasilnya gagal. Layar Webhook Call Detail akan terbuka. - Pada Request, periksa ke alamat mana dan isi apa yang dikirim.
- Pada Response, periksa kode respons dan isi yang dikembalikan program luar.
Kode respons dan isi yang dikembalikan memberi tahu penyebabnya. Jika kode respons berada dalam rentang gagal, berarti program luar menerima permintaan tetapi gagal saat memprosesnya, dan dalam kasus ini penyebabnya sering tertulis pada isi yang dikembalikan. Jika sama sekali tidak ada respons atau alamatnya tidak ditemukan, bisa jadi alamat tujuan telah berubah atau programnya sedang mati.
Jika Anda ingin meneruskan panggilan ini apa adanya kepada penanggung jawab program luar, Anda dapat menyalinnya dalam bentuk yang bisa mereproduksi panggilan ini menggunakan Salin cURL di kanan atas, lalu mengirimkannya.
Permintaan yang dikirim juga memuat header yang kita sertakan. Di antaranya, yang telah ditetapkan sebagai nilai rahasia (misalnya, nilai kunci yang dipakai untuk mengakses program luar) tampil tersamarkan dengan tanda bintang di layar. Nilai aslinya tidak terungkap, jadi Anda dapat memeriksa detailnya dengan tenang.
Jika Webhook ini digunakan bersama WriteBack yang mengisi kembali data dengan respons yang dikembalikan, apakah setiap operasinya berhasil atau gagal juga dapat dilihat pada tab WriteBack Hasil di detail yang sama. Arti masing-masing item dibahas di Webhook.
Menangani saat terjadi kegagalan
Ada satu hal yang perlu diketahui lebih dahulu. Panggilan yang gagal tidak dikirim ulang secara otomatis. Notifikasi yang sekali gagal hanya tersisa apa adanya di riwayat; Webhook tidak mengirimkannya kembali dengan sendirinya. Karena itu, penanganannya terbagi menjadi dua jalur. Yaitu memperbaiki penyebab agar notifikasi berikutnya terkirim dengan normal, dan menangani sendiri kasus yang sudah gagal dan terlewat oleh bot.
Berdasarkan apa yang Anda lihat pada detail, berikut adalah penyebab yang perlu ditelusuri beserta penanganannya.
| Yang terlihat pada detail | Penyebab yang perlu ditelusuri | Penanganan |
|---|---|---|
| Kode respons dalam rentang gagal beserta isi kesalahannya | Program luar gagal saat memproses permintaan | Teruskan isi respons yang dikembalikan apa adanya kepada penanggung jawab program luar agar mereka memperbaikinya |
| Tidak ada respons atau alamat tidak ditemukan | Alamat tujuan telah berubah atau program sedang mati | Periksa apakah alamatnya benar, dan jika berubah, ubah Webhook |
| Panggilan itu sendiri tidak tercatat | Webhook dalam keadaan mati (INACTIVE) | Nyalakan kembali Webhook |
| Tercatat sebagai gagal dan respons yang dikembalikan sangat besar | Isi yang dikembalikan program luar terlalu besar | Sesuaikan sisi program luar agar mengurangi isi yang dikembalikan |
Cara memperbaiki alamat atau menyalakan kembali Webhook dibahas di Webhook.
Meskipun penyebabnya sudah diperbaiki, notifikasi yang gagal selama itu tidak akan terkirim ulang dengan sendirinya. Anda dapat memeriksa masing-masing panggilan yang gagal itu terkait pendaftaran produk yang mana dari isi yang dikirim pada detail panggilan tersebut, jadi untuk produk-produk itu, beri tahu langsung penanggung jawab bot untuk menutup pemrosesan yang terlewat.