Integrasi API

Nala Send adalah API WhatsApp yang Meta-compatible. Ganti base URL, tetap pakai payload Meta yang sama, lalu tambahkan broadcast saat butuh kirim ke banyak penerima.

Base URL: https://api.nalasend.id. Setiap request memakai API key Nala.

Mulai cepat

  1. Buat akun dan hubungkan nomor WhatsApp Cloud API di dashboard.
  2. Buat API key live atau test. Key hanya ditampilkan sekali.
  3. Kirim request pertama ke endpoint Meta-compatible.
curl -X POST https://api.nalasend.id/meta/v20.0/109384756201/messages \
  -H "Authorization: Bearer nala_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "628123456789",
    "type": "text",
    "text": { "body": "Halo dari Nala Send" }
  }'

Response sukses adalah response Meta. Nala menambahkan header kuota:

HTTP/1.1 200 OK
X-Request-Id: req_01J...

Dua mode, satu endpoint

ModeGunakan jikaRequest
Single sendKirim satu pesan lewat payload MetaPOST /meta/{version}/{phone_number_id}/messages
BroadcastKirim ke banyak penerima dari request yang samaEndpoint yang sama + X-Nala-Broadcast: true

Yang perlu diketahui

  • Idempotency: kirim Idempotency-Key pada retry agar pesan tidak terkirim dua kali.
  • Rate limit: pengiriman mengikuti rate limit per nomor dan tier Meta.
  • 24 jam: teks bebas hanya bisa dikirim di dalam customer service window; di luar itu gunakan template.
  • Test key: key nala_test_* tidak memotong kuota dan tidak memanggil Meta.