Untuk developer

Kirim WhatsApp dari sistemmu, satu endpoint saja

Notifikasi pesanan, pengingat tagihan, nomor resi, OTP. Bukan gateway seadanya — idempotency, retry webhook, dan batas laju sudah terpasang sejak awal.

Kirim pesan
curl -X POST https://api.chaty.id/api/v1/messages \
  -H "Authorization: Bearer crm_a1b2c3d4.XyZ..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8812-notif" \
  -d '{
    "accountId": 5,
    "to": "628123456789",
    "type": "text",
    "body": "Halo! Pesanan #8812 sudah dikirim."
  }'

# 202 Accepted
{ "success": true, "data": { "messageId": 304, "status": "pending" } }

Kenapa beda

Detail yang biasanya baru terasa saat produksi

Gateway WhatsApp gampang dibuat. Yang susah itu bikin dia tetap benar saat jaringan putus, saat request dobel, dan saat volumenya naik.

API key ber-scope

Sembilan scope terpisah — messages:send, contacts:read, dan seterusnya. Key bisa dikunci ke nomor tertentu saja, dan dicabut seketika dari dashboard.

Idempotency bawaan

Kirim ulang request dengan header Idempotency-Key yang sama, respons pertama yang dikembalikan. Jaringan putus di tengah jalan tidak lagi berarti pelanggan dapat notifikasi dua kali.

Webhook dengan log & retry

Pesan masuk, perubahan status, dan update kontak dikirim ke endpoint-mu. Gagal? Dicoba lagi otomatis, dan tiap percobaan tercatat supaya bisa ditelusuri.

Rate limit yang transparan

Sisa kuota dikirim di header tiap respons — X-RateLimit-Remaining dan Retry-After. Tidak perlu menebak kapan boleh mengirim lagi.

Endpoint

Yang paling sering dipakai

Dokumentasi lengkap dan playground interaktif tersedia di dalam dashboard — semua endpoint bisa dicoba langsung dari browser.

  • POST /v1/messages Kirim pesan teks, media, atau template
  • GET /v1/messages/:id Cek status satu pesan
  • GET /v1/chats Daftar percakapan
  • GET /v1/chats/:id/messages Riwayat pesan satu chat
  • GET /v1/contacts Daftar & cari kontak
  • POST /v1/contacts Tambah atau perbarui kontak
  • POST /v1/contacts/check Cek nomor terdaftar di WhatsApp atau tidak
  • POST /v1/media Upload gambar, dokumen, atau audio
  • GET /v1/accounts Daftar nomor & status koneksinya
  • POST /v1/webhooks Daftarkan endpoint webhook

Webhook

Dua arah, bukan cuma kirim

Pasang endpoint webhook, terima pesan masuk secara realtime, proses di sistemmu, lalu balas lewat API. Itu pola bot balas-otomatis yang paling sederhana.

Contoh payload
// Webhook masuk ke server-mu saat ada pesan baru
{
  "event": "message.received",
  "data": {
    "chatId": 23,
    "from": "628123456789",
    "type": "text",
    "body": "Kak, pesanan saya sudah dikirim belum?"
  }
}

Satu catatan penting: abaikan event message.sent hasil kirimanmu sendiri, kalau tidak bot-nya akan membalas dirinya sendiri tanpa henti.

Mau lihat dokumentasinya dulu?

Kami kirimkan akses playground supaya kamu bisa mencoba tiap endpoint sebelum memutuskan.

Minta akses API