WhatsApp API · REST

WhatsApp API untuk kirim pesan dari sistem Anda.

REST API sederhana untuk mengirim pesan, OTP, dan notifikasi WhatsApp langsung dari aplikasi, website, atau workflow. Autentikasi token, respons JSON, tanpa WhatsApp Business API resmi.

Base URL · https://app.jalinara.id

Quickstart

Kirim pesan pertama dalam 3 langkah.

01

Hubungkan nomor

Daftar, lalu pindai QR untuk menghubungkan nomor WhatsApp Anda ke Jalinara. Tanpa Business API resmi.

02

Ambil token API

Buat token di dashboard, lalu kirim di header Authorization: Bearer <token> pada setiap request.

03

Panggil /send

POST JSON berisi target dan message. Pesan langsung masuk antrean pengiriman.

Referensi

Endpoint inti dan operasional.

Semua endpoint menerima token lewat header Authorization (format Bearer <token>, Token <token>, atau token polos). Base URL: https://app.jalinara.id.

POST/send

Kirim teks, media, lokasi, atau bulk hingga 200 target per request (sesuai paket). Mendukung partial success dan Idempotency-Key agar retry tidak mengirim pesan ganda. Alias: /api/send.

ParameterTipeKeterangan
targetstring/array wajibNomor format internasional tanpa +. Bulk dapat berupa array atau dipisahkan koma/baris baru.
messagestring wajib*Isi pesan teks atau caption media. Alias: text.
typestring opsionaltext, image, video, audio, document, atau location.
url/base64string opsionalSumber media berupa URL aman atau data base64.
filenamestring opsionalNama berkas untuk lampiran dokumen.
latitude/longitudenumber opsionalKoordinat wajib untuk tipe location.
devicestring opsionalID perangkat. Token yang di-scope hanya dapat memakai perangkat tersebut.
GET/device

Cek status koneksi perangkat WhatsApp Anda. Alias: /api/gateway/status.

Field responsTipeKeterangan
connectedbooleantrue bila perangkat siap mengirim.
statestringStatus detail koneksi (mis. connected).
phonestringNomor perangkat (bisa disamarkan bila privasi aktif).
POST/validate

Cek apakah sebuah nomor terdaftar di WhatsApp. Tidak memakan kuota pesan. Alias: /api/contact/check.

ParameterTipeKeterangan
targetstring wajibNomor yang ingin diperiksa.
GET/api/gateway/messages/:id

Pantau satu pesan dari ID hasil /send: queued, sent, delivered, read, atau failed. Daftar dan filter log tersedia di GET /api/gateway/messages.

POST/api/gateway/schedules

Jadwalkan pesan satu kali atau berulang dengan send_at dan recurrence (none, daily, weekly, monthly). Daftar, detail, dan pembatalan tersedia lewat endpoint schedules.

PUT/api/gateway/webhook

Atur URL dan secret webhook per perangkat. Gunakan POST /api/gateway/webhook/test untuk menguji delivery, dan DELETE pada path yang sama untuk menonaktifkan.

🔑 Autentikasi

Setiap request butuh token API yang dibuat dari dashboard Anda. Kirim lewat header:

  • Authorization: Bearer <token>
  • atau Authorization: Token <token>
  • atau token polos di header Authorization

Token tidak diterima lewat query-string (mencegah bocor ke log/proxy).

📦 Format respons

Respons JSON kompatibel, berisi status ringkas dan detail Jalinara:

response.json
{
  "status":  true,
  "detail":  "message queued",
  "id":      [ "..." ],
  "queued":  1,
  "failed":  0,
  "total":   1
}
Reliability & security

Siap untuk integrasi produksi.

Request dapat di-retry dengan aman, status bisa dipantau, dan setiap webhook dapat diverifikasi.

IDEMPOTENCY

Retry tanpa pesan ganda

Kirim header Idempotency-Key. Key yang sama dan body identik mengembalikan respons awal selama 24 jam.

WEBHOOK

Status real-time

Terima event incoming, sent, delivered, read, failed, canceled, dan device disconnected dengan event ID untuk deduplikasi.

HMAC-SHA256

Verifikasi signature

Cocokkan x-jalinara-signature terhadap timestamp dan raw JSON body memakai secret perangkat Anda.

webhook-headers.txt
x-jalinara-event: message.delivered
x-jalinara-event-id: 550e8400-e29b-41d4-a716-446655440000
x-jalinara-timestamp: 1785658503
x-jalinara-signature: v1=<hmac-sha256>

# signed content: "<timestamp>.<raw-json-body>"

⏱️ Batas request

Gateway menerima hingga 60 request/menit per token secara default. Jalur kirim paket Free dibatasi 20 request/menit per akun. Header RateLimit-* menunjukkan batas dan sisa request.

⚠️ Error konsisten

Error selalu berupa JSON dengan status: false, message, dan code. Gunakan HTTP 409 untuk konflik idempotency dan 429 untuk rate limit.

Migrasi

Sudah pakai gateway lain? Ganti satu URL.

Format request dan respons dibuat kompatibel dengan gateway WhatsApp populer. Umumnya Anda cukup mengganti base URL ke https://app.jalinara.id — workflow, parameter, dan kode yang sudah ada tetap jalan. Tanpa migrasi besar, tanpa tulis ulang integrasi.

Mulai gratis

🔗 Integrasi tanpa kode

Sambungkan ke n8n, alat automasi, atau webhook Anda. Cukup HTTP request ke /send dengan header token — cocok untuk notifikasi pesanan, pengingat, dan konfirmasi otomatis.

🔢 OTP & notifikasi

Kirim kode OTP dan notifikasi transaksional real-time. Endpoint /validate membantu memastikan nomor pelanggan aktif di WhatsApp sebelum mengirim, tanpa memotong kuota.

FAQ

Pertanyaan umum

Apa itu WhatsApp API?
WhatsApp API adalah antarmuka pemrograman yang membuat sistem Anda bisa mengirim & menerima pesan WhatsApp otomatis — OTP, notifikasi pesanan, atau balasan bot — tanpa membuka aplikasi WhatsApp manual. Jalinara menyediakannya sebagai REST API dengan autentikasi token.
Apakah WhatsApp API Jalinara gratis?
Anda bisa membuat token dan mulai mengirim di paket Free tanpa biaya dan tanpa kartu kredit. Untuk volume lebih besar tersedia paket berbayar.
Apakah saya perlu WhatsApp Business API resmi?
Tidak. Cukup hubungkan nomor WhatsApp Anda dengan memindai QR, lalu langsung pakai REST API. Tanpa proses approval Business API yang panjang.
Saya sudah pakai gateway lain — apakah migrasi sulit?
Tidak. Format request & respons kompatibel dengan gateway populer, jadi umumnya Anda cukup mengganti base URL menjadi https://app.jalinara.id tanpa mengubah kode.
Bahasa/framework apa yang didukung?
Apa pun yang bisa melakukan HTTP request — Node.js, PHP, Python, Go, atau tanpa kode lewat n8n/Zapier-style webhook. API-nya REST/JSON standar.

Kirim WhatsApp dari kode Anda hari ini.

Buat token API gratis, hubungkan nomor, dan mulai kirim pesan dalam hitungan menit.

Buat token API gratis