Webhook

Belum tersedia. AdForm belum mengirim webhook ke server pihak ketiga. Tidak ada endpoint untuk mendaftarkan URL, tidak ada event yang dikirim, dan belum ada kontrak payload yang bisa dipakai. Jangan bangun listener berdasarkan halaman ini.

#Kenapa halaman ini ada

Pertanyaan paling sering dari integrator adalah "kalau ada pesanan masuk, saya dikabari lewat apa?". Jawaban jujurnya hari ini: belum ada. Halaman ini kami tulis supaya statusnya jelas, bukan supaya terlihat sudah ada.

Sampai webhook keluar tersedia, satu-satunya jalur integrasi yang didukung untuk pihak ketiga adalah API Produk dan pemasangan form lewat iframe + embed.js (lihat Pengantar).

#Rencana, garis besarnya saja

Yang sudah kami putuskan arahnya:

• Berbasis event dari aktivitas pesanan. Peristiwa seputar siklus hidup pesanan adalah pemicu yang paling banyak diminta.
• Endpoint tujuan didaftarkan per tenant. Pemilik akun yang menentukan URL tujuan, dan bisa mencabutnya sewaktu-waktu.
• HTTPS POST dengan body JSON.
• Ditandatangani, supaya penerima bisa memverifikasi bahwa kiriman benar dari AdForm dan bukan pihak lain yang menebak URL Anda.
• Ada percobaan ulang saat endpoint Anda gagal merespons, dengan jeda yang membesar.
• Pengiriman dianggap at-least-once, jadi penerima wajib idempoten — siapkan penanganan kalau event yang sama datang dua kali.

Yang sengaja belum kami tulis: nama event, struktur payload, nama header, dan skema tanda tangan. Kontraknya belum final. Menerbitkan versi yang salah lebih merugikan daripada tidak menerbitkan apa pun — Anda akan menulis kode yang harus dibuang.

#Yang bisa Anda siapkan sekarang

Kalau ingin siap begitu webhook rilis, tiga hal ini aman dikerjakan lebih awal karena tidak bergantung pada detail kontrak:

1. Sediakan endpoint HTTPS publik yang bisa menerima POST JSON dan membalas cepat (idealnya di bawah 5 detik) dengan 2xx.
2. Proses secara asinkron: terima, simpan ke antrean, balas 2xx, kerjakan belakangan. Jangan memproses berat di dalam request.
3. Rancang pemrosesan Anda idempoten sejak awal — aman dijalankan ulang untuk peristiwa yang sama.

#Sementara ini, alternatifnya

• Notifikasi ke tim, bukan ke sistem: dashboard AdForm sudah mengirim notifikasi pesanan ke CS lewat WhatsApp dan e-mail sesuai setelan tenant. Untuk banyak kebutuhan operasional, ini sudah cukup.
• Ekspor manual: pemilik akun bisa mengekspor data pesanan dari dashboard.

Keduanya jalur dashboard, bukan API — perlu akses login tenant, tidak bisa diotomasi dengan API key.

#Ikut menentukan kontraknya

Kami lebih suka merilis kontrak yang sudah diuji satu-dua integrator daripada mengarang sendiri. Kalau produk Anda butuh webhook AdForm, hubungi kami lewat Pusat Bantuan dan sertakan:

• Peristiwa apa yang Anda butuhkan, dan apa yang produk Anda lakukan setelah menerimanya.
• Field apa yang wajib ada di payload agar berguna bagi Anda.
• Perkiraan volume per hari.
• Apakah Anda butuh percobaan ulang dan pengiriman berurutan, atau cukup best-effort.

Kalau kontraknya sudah final, halaman ini diperbarui dengan referensi lengkap dan pemberitahuan ke integrator yang sudah menghubungi kami.