Templates

2 min read

Autentikasi

Endpoint template memakai Bearer token yang sama dengan Send:

Authorization: Bearer YOUR_ACCOUNT_TOKEN

Tidak ada field sesi dashboard atau channel key yang diperlukan. Channel key hanya wajib untuk POST /v1/send.

Buat dan kelola di dashboard

API publik ini hanya untuk membaca template. Buat dan edit template di dashboard di Channel → channel → Templates. Setelah disetujui dan aktif, daftar lewat API dan gunakan id di body send.

Template WABA yang muncul di list disinkronkan dari Meta — hanya baca lewat API; kelola di Channel → WABA → Templates.

Objek template

Setiap respons list/get mengembalikan template dalam bentuk ini:

Field	Tipe	Arti
`id`	integer	ID template — gunakan di `content.<channel>.template` saat send
`channel`	string	`whatsapp`, `telegram`, `email`, atau `waba`
`name`	string	Nama unik per channel di akun Anda
`active`	boolean	Apakah template dapat dipilih untuk send
`body`	object	Konten spesifik channel (teks, media, HTML email, dll.)
`review_status`	string	`pending`, `approved`, atau `rejected`
`review_reason`	string or null	Alasan auto-review menolak konten, jika ada
`template_type`	string or null	Subtipe opsional jika berlaku
`created_at`	string	Timestamp UTC ISO 8601
`updated_at`	string	Timestamp UTC ISO 8601

Hanya template dengan review_status: "approved" dan active: true yang dapat dipakai di /v1/send.

Daftar template

GET https://api.kirisan.com/v1/templates
GET https://api.kirisan.com/v1/templates?channel=whatsapp

Query opsional channel: whatsapp, telegram, email, atau waba.

Jika channel diabaikan, Kirisan mengembalikan template dari semua channel plus template WABA yang disinkronkan dari Meta.

Respons:

{
  "status": true,
  "data": [
    {
      "id": 42,
      "channel": "whatsapp",
      "name": "order-update",
      "active": true,
      "review_status": "approved",
      "review_reason": null,
      "body": { },
      "created_at": "2026-06-01T10:00:00Z",
      "updated_at": "2026-06-01T10:00:00Z"
    }
  ]
}

Ambil satu template

GET https://api.kirisan.com/v1/templates/:id

Mengembalikan { "status": true, "data": { … } } atau 404 dengan "reason": "not found".

Pakai dengan Send

Referensikan ID template di body send:

{
  "content": {
    "whatsapp": { "template": 42 }
  }
}

Lihat Send API untuk bentuk permintaan lengkap dan substitusi variabel.

Terkait

Send API — kirim pesan yang mereferensikan ID template
Errors — kegagalan autentikasi dan validasi
Send messages — pilih template di UI
WhatsApp templates — editor template dashboard