Insights

Pesan Layanan Gratis

Estimasi pemakaian 1.000 pesan layanan gratis dari Meta per nomor WhatsApp untuk satu bulan kalender (UTC).

GET /api/v1/public/insights/free-tier

peringatan

Harga sejak 1 Oktober 2026: setiap nomor WhatsApp mendapat 1.000 pesan layanan gratis (pesan non-template di dalam window 24 jam) per bulan kalender. Setelah itu, Meta menagih setiap pesan layanan dengan tarif utility. Sisa pesan gratis tidak terbawa ke bulan berikutnya.

Cara Penghitungan

Ini estimasi dari pesan yang dikirim lewat platform ini, bukan data tagihan Meta. Invoice Meta Anda adalah angka final.

Dihitung: pesan non-template yang Anda kirim, berdasarkan waktu pembuatannya (UTC).

Tidak dihitung:

• Pesan template.
• Pesan yang gagal.
• Pesan yang dikirim dari aplikasi WhatsApp Business (coexistence).
• Pesan history sync.
• Pesan yang dikirim dalam 7 hari setelah customer mengirim pesan dari iklan Click-to-WhatsApp. Lihat Iklan Click-to-WhatsApp.

Query Parameter

Parameter	Tipe	Wajib	Keterangan
month	string	tidak	Bulan dalam format YYYY-MM (UTC). Default bulan berjalan.
phone_number_id	string	tidak	Batasi ke satu nomor: id nomor telepon atau phone_number_id Meta dari Daftar Nomor Telepon. Default semua nomor.

Contoh Request

cURL

curl -X GET "https://chat.api.co.id/api/v1/public/insights/free-tier?month=2026-10" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const response = await fetch(
  "https://chat.api.co.id/api/v1/public/insights/free-tier?month=2026-10",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);

const { data } = await response.json();
for (const number of data.phone_numbers) {
  console.log(number.display_phone_number, number.used, "/", number.limit);
}

Python

response = requests.get(
    "https://chat.api.co.id/api/v1/public/insights/free-tier",
    params={"month": "2026-10"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

for number in response.json()["data"]["phone_numbers"]:
    print(number["display_phone_number"], number["used"], "/", number["limit"])

Response

{
  "success": true,
  "data": {
    "month": "2026-10",
    "is_estimate": true,
    "phone_numbers": [
      {
        "id": "clxxx1234567890",
        "display_phone_number": "+62 811-2000-1001",
        "limit": 1000,
        "used": 1047,
        "remaining": 0,
        "estimated_billable": 47
      }
    ]
  }
}

Field Response

Parameter	Tipe	Wajib	Keterangan
used	number	ya	Estimasi pesan layanan yang terkirim bulan ini.
remaining	number	ya	Sisa pesan layanan gratis: max(0, limit - used).
estimated_billable	number	ya	Pesan layanan di atas batas gratis yang kemungkinan ditagih Meta: max(0, used - limit).

Iklan Click-to-WhatsApp

Jumlah lead per iklan Click-to-WhatsApp untuk satu bulan kalender (UTC), plus jumlah customer yang sedang berada di free entry point window saat ini.

GET /api/v1/public/insights/ctwa

info

Saat customer mengirim pesan dari iklan Click-to-WhatsApp, free entry point window terbuka hingga 7 hari. Semua pesan ke customer tersebut gratis selama window ini, dan pesan-pesan itu tidak dihitung ke 1.000 pesan layanan gratis. Untuk cek satu customer, gunakan Cek Messaging Window.

Query Parameter

Parameter	Tipe	Wajib	Keterangan
month	string	tidak	Bulan dalam format YYYY-MM (UTC). Default bulan berjalan.
phone_number_id	string	tidak	Batasi ke satu nomor: id nomor telepon atau phone_number_id Meta. Default semua nomor.

Contoh Request

cURL

curl -X GET "https://chat.api.co.id/api/v1/public/insights/ctwa?month=2026-10" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const response = await fetch(
  "https://chat.api.co.id/api/v1/public/insights/ctwa?month=2026-10",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);

const { data } = await response.json();
console.log("Customers in a free ad window:", data.active_free_windows);

Python

response = requests.get(
    "https://chat.api.co.id/api/v1/public/insights/ctwa",
    params={"month": "2026-10"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

for ad in response.json()["data"]["ads"]:
    print(ad["headline"], ad["leads"])

Response

{
  "success": true,
  "data": {
    "month": "2026-10",
    "active_free_windows": 24,
    "ads": [
      {
        "ad_id": "120210000000001",
        "headline": "Flash Sale 10.10",
        "source_url": "https://fb.me/abc123",
        "source_type": "ad",
        "leads": 11,
        "chats": 14,
        "last_lead_at": "2026-10-09T08:12:00.000Z"
      }
    ]
  }
}

Field Response

Parameter	Tipe	Wajib	Keterangan
active_free_windows	number	ya	Customer yang free entry point window-nya sedang terbuka saat ini (tidak dibatasi bulan).
ad_id	string	ya	ID iklan Meta (referral.source_id dari webhook).
headline	string | null	ya	Headline materi iklan yang dikirim Meta. Ini bukan nama iklan dari Ads Manager.
leads	number	ya	Customer unik yang mengirim pesan dari iklan ini dalam bulan tersebut.
chats	number	ya	Pesan masuk dari iklan ini dalam bulan tersebut (satu customer bisa memulai beberapa).

Coba langsung

tip

Tekan Try it lalu tempel API key Anda (kc_live_...) ke kolom API key (Bearer). Dapatkan key dari API Keys. Request dijalankan ke akun live Anda, jadi endpoint yang mengirim, membuat, atau menghapus akan memengaruhi data sungguhan.

• GET/api/v1/public/insights/free-tierFree Service Messages
• GET/api/v1/public/insights/ctwaClick-to-WhatsApp Ads