URL publik

Server Kirisan harus bisa menjangkau URL Anda di internet publik lewat HTTPS. Alamat seperti http://localhost:3000/... di laptop tidak terlihat dari luar, jadi pengiriman akan gagal sampai endpoint diekspos.

Syarat yang wajar

1. URL HTTPS yang menerima POST berisi JSON.
2. Jawaban 2xx supaya Kirisan menganggap pengiriman berhasil (dan berhenti mengulang).
3. Verifikasi signing secret (opsional) — lihat Verification.

Atur URL di menu Webhooks (listener per device dan/atau level akun, tergantung event). Setelah disimpan, pakai Testing untuk mengirim sampel, lalu cek Logs kalau ada yang gagal.

• Panduan: Webhook di dashboard · Testing · Log webhook
• Dashboard: Webhooks

Pengembangan lokal

Pakai tunnel (ngrok, Cloudflare Tunnel, dan sejenisnya) supaya ada URL HTTPS publik yang mengarah ke port lokal Anda. Saat develop, arahkan Kirisan ke URL tunnel; saat production, ganti ke host tetap Anda.

Bentuk payload tetap bisa dipelajari tanpa URL lewat Playground webhook.

Kegagalan yang sering terjadi

• Memakai HTTP, bukan HTTPS
• Firewall, basic-auth, atau tantangan bot memblokir POST dari Kirisan
• Handler lambat atau mengembalikan 5xx (Kirisan mungkin mengulang)

→ Pemecahan masalah webhook

Selanjutnya

Payload & balasan