Token API & Kirim via API

Token API

Nidaa menggunakan autentikasi bearer token untuk REST API-nya. Token bersifat per-perangkat — setiap token hanya bisa mengirim dari perangkat yang dibuat.

Membuat Token

1. Buka tab API & Token.
2. Pilih Perangkat Anda.
3. Klik + Buat Token dan masukkan nama (mis. "Integrasi CRM").
4. Salin token — hanya ditampilkan sekali. Simpan dengan aman.

Kirim via API

curl -X POST https://api.nidaa.id/api/v1/messages/send \
  -H "Token: TOKEN_ANDA" \
  -H "Content-Type: application/json" \
  -d '{"target":"6281234567890","message":"Halo dari API Nidaa!"}'

Respons

{ "ok": true, "id": "msg_xxx", "status": "queued" }

Webhook

Pasang URL webhook di perangkat Anda untuk menerima pesan masuk dan pembaruan status:

1. Tab Perangkat → klik Webhook di sebuah perangkat.
2. Masukkan URL endpoint Anda.
3. Nidaa akan POST ke URL tersebut untuk setiap pesan masuk dan perubahan status.

Payload webhook (pesan masuk)

{
  "event": "message.inbound",
  "deviceId": "dev_xxx",
  "from": "6281234567890",
  "body": "Halo!",
  "timestamp": "2026-06-30T10:00:00Z"
}

Dokumentasi API lengkap: api.nidaa.id/docs.