Ajukan template

Ajukan template WhatsApp Official baru untuk disetujui.

template memakai bentuk yang sama dengan pembuat template di aplikasi dan diperiksa dengan aturan yang sama sebelum diajukan.

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: templates:write
Fitur paket: API kirim WhatsApp

Body (JSON)

channel_idstringwajib
Akun WhatsApp Official, waba:<id> dari Daftar saluran.
templateobjectwajib
Draf template: name, language, category, kind, parameterFormat, body, bodyExamples, dan lainnya.

Error yang mungkin

400 invalid_json Body bukan JSON yang sah
400 idempotency_key_invalid Idempotency-Key tidak sah
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 channel_not_allowed Saluran tidak boleh dipakai kunci ini
409 idempotency_conflict Idempotency-Key dipakai untuk isi lain
409 request_in_progress Permintaan yang sama masih diproses
422 invalid_request Field tidak sah
429 rate_limited Terlalu banyak permintaan per menit
500 internal_error Gangguan di Klik Flow
502 channel_refused WhatsApp menolak pesan

Coba

Coba sekarang dengan kunci tes

Kunci API tesHanya kunci tes (kf_test_…), disimpan di tab ini saja dan dikirim hanya ke API situs ini. Body (JSON)Idempotency-Key

/api/v2/templates

Contoh permintaan

curl -X POST "https://klikflow.id/api/v2/templates" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"waba:3","template":{"name":"pengingat_bayar","language":"id","category":"UTILITY","kind":"standard","parameterFormat":"NAMED","header":{"format":"NONE"},"body":"Halo {{nama}}, tagihan {{orderid}} jatuh tempo besok.","bodyExamples":{"nama":"Rina","orderid":"INV-2207"},"footer":"","buttons":[]}}'

Contoh jawaban 201

{
  "data": {
    "object": "template",
    "name": "pengingat_bayar",
    "language": "id",
    "status": "PENDING",
    "category_changed_to": null
  }
}

Body (JSON)

Error yang mungkin

Coba

Kirim WhatsApp dari sistem Anda lewat API Klik Flow.