Kirim event uji

Kirim contoh satu event (ditandai `test: true`) sekarang, lalu lihat jawaban sistem Anda.

Contohnya sama dengan di panduan Event webhook. Event uji tidak diulang bila gagal dan tidak dihitung dalam kesehatan webhook.

Kirim header Idempotency-Key (misalnya UUID baru per permintaan). Ulangan dengan kunci yang sama dalam 24 jam mendapat jawaban pertama lagi, jadi tidak terkirim dua kali.

Kunci: kf_live_ / kf_test_… di header Authorization: Bearer. Dibuat di Pengaturan › API & Webhook › Buat kunci.
Izin kunci: webhooks:manage
Fitur paket: API kirim WhatsApp

Parameter alamat

idintegerwajib
Id webhook.

Body (JSON)

eventstring: message.received | message.status | contact.created | lead.created | order.paid | ticket.created | ticket.status | template.status | channel.status
Event yang dicontohkan, bawaan message.received.

Error yang mungkin

401 missing_key Kunci API belum dikirim
401 key_invalid Kunci API tidak dikenal
401 key_revoked Kunci API sudah dicabut
401 key_expired Kunci API kedaluwarsa
401 member_inactive Pembuat kunci bukan anggota lagi
403 ip_not_allowed IP server tidak ada di daftar kunci
403 plan_no_api Paket belum memuat API untuk kunci live
403 tenant_blocked Akses bisnis ditangguhkan
403 scope_missing Kunci tidak punya izin ini
403 permission_missing Role pembuat kunci tidak punya izin ini
403 live_key_required Butuh kunci live
404 not_found Tidak ditemukan
422 invalid_request Field tidak sah
429 rate_limited Terlalu banyak permintaan per menit
500 internal_error Gangguan di Klik Flow

Coba

Endpoint ini butuh kunci live, jadi tidak bisa dicoba di halaman docs. Panggil dari server Anda.

Contoh permintaan

curl -X POST "https://klikflow.id/api/v2/webhooks/6/test" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"event":"order.paid"}'

Contoh jawaban 200

{
  "data": {
    "object": "webhook_delivery",
    "event_id": "evt_9Qx2Lm4Kp7Rt1Zs8",
    "event": "order.paid",
    "test": true,
    "succeeded": true,
    "status_code": 200,
    "error": null,
    "duration_ms": 182
  }
}

Parameter alamat

Body (JSON)

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.