kirem.coDokumentasi API
Dokumentasi/Templates/Melihat Daftar Templat Pesan
Templates

Melihat Daftar Templat Pesan

Ringkasan Teknis (TL;DR)

Mengambil daftar lengkap templat pesan WhatsApp yang terdaftar beserta status persetujuannya via API GET /v1/templates.

#templates#list#get

Melihat Daftar Templat Pesan

Endpoint ini mengembalikan daftar seluruh templat pesan WhatsApp yang terdaftar pada akun bisnis Anda di Meta, beserta informasi status persetujuan, kategori, bahasa, dan komponen penyusunnya.


🛜 Endpoint

GET /v1/templates


📋 Parameter

Endpoint ini tidak memerlukan parameter tambahan. Cukup sertakan header Authorization.


🚦 Contoh cURL Request

curl -X GET "https://api.kirem.co/v1/templates" \
  -H "Authorization: Bearer kirem_live_xxx"

🚦 Contoh Kode (Node.js)

const axios = require('axios');

axios.get('https://api.kirem.co/v1/templates', {
  headers: { 'Authorization': 'Bearer kirem_live_xxx' }
}).then(res => console.log(res.data));

🚦 Contoh Kode (Go)

package main

import (
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.kirem.co/v1/templates", nil)
	req.Header.Set("Authorization", "Bearer kirem_live_xxx")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println("Status:", resp.Status)
}

🚦 Contoh Kode (PHP)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.kirem.co/v1/templates');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer kirem_live_xxx']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

✅ Respons Sukses (200 OK)

{
  "status": 200,
  "message": "Templates retrieved successfully",
  "data": [
    {
      "name": "otp_verification",
      "status": "APPROVED",
      "category": "AUTHENTICATION",
      "language": "id",
      "components": [
        {
          "type": "BODY",
          "text": "Kode keamanan OTP Kirem Anda adalah: {{1}}."
        }
      ],
      "id": "18491849184919"
    },
    {
      "name": "promo_diskon_baru",
      "status": "PENDING",
      "category": "MARKETING",
      "language": "id",
      "components": [
        {
          "type": "HEADER",
          "format": "TEXT",
          "text": "Promo Spesial!"
        },
        {
          "type": "BODY",
          "text": "Halo {{1}}, nikmati diskon {{2}}% untuk semua produk."
        },
        {
          "type": "BUTTONS",
          "buttons": [
            {
              "type": "QUICK_REPLY",
              "text": "Ya, saya tertarik"
            }
          ]
        }
      ],
      "id": "194819481948194"
    }
  ]
}

📊 Penjelasan Status Templat

Status Keterangan
APPROVED Templat telah disetujui Meta dan siap digunakan untuk pengiriman pesan
PENDING Templat sedang dalam proses peninjauan oleh Meta (biasanya 24–48 jam)
REJECTED Templat ditolak oleh Meta — perbaiki konten dan kirim ulang

🔍 Memfilter Berdasarkan Status

Untuk memfilter templat berdasarkan status persetujuan, Anda dapat menambahkan query parameter status:

# Hanya tampilkan templat yang sudah disetujui
curl -X GET "https://api.kirem.co/v1/templates?status=APPROVED" \
  -H "Authorization: Bearer kirem_live_xxx"
# Hanya tampilkan templat yang masih menunggu
curl -X GET "https://api.kirem.co/v1/templates?status=PENDING" \
  -H "Authorization: Bearer kirem_live_xxx"

⚠️ Catatan Penting

  • Hanya templat dengan status APPROVED yang dapat digunakan untuk mengirim pesan ke pelanggan.
  • Templat dengan status REJECTED tidak akan muncul di respons kecuali secara eksplisit diminta melalui filter.
  • Gunakan endpoint Create Template untuk membuat templat baru.

Butuh bantuan integrasi lanjutan?

Hubungi tim developer Kirem melalui tiket bantuan.

Buka Tiket Bantuan