WhatsApp API Documentation - Kirimi | REST API untuk Kirim Pesan, OTP & Broadcast

Getting Started

Selamat datang di dokumentasi API Kirimi! Panduan ini akan membantu Anda memulai integrasi WhatsApp dengan aplikasi Anda.

Base URL

https://api.kirimi.id

Autentikasi

Setiap request API memerlukan kredensial berikut:

user_code - Kode pengguna unik Anda dari dashboard
secret - Kunci rahasia untuk autentikasi API
device_id - ID perangkat WhatsApp yang terhubung (untuk endpoint tertentu)

Penting

Jaga kerahasiaan Secret Key Anda
Regenerate Secret Key secara berkala untuk keamanan
Gunakan HTTPS untuk semua API request

Dua jalur pengiriman

Kirimi punya dua jalur yang aturannya berbeda, dan endpoint-nya tidak saling menggantikan:

Perangkat QR Scan - dipakai endpoint /v1/send-message dan /v1/broadcast-message. Butuh device_id, bisa mengirim teks bebas kapan saja, dan bisa mengirim ke grup.
WhatsApp Business API resmi - dipakai endpoint /v1/waba/*. Butuh waba_id, bukan device_id. Pesan yang Anda mulai duluan wajib memakai template yang disetujui Meta, balasan bebas teks hanya dalam 24 jam sejak pesan masuk terakhir, dan tidak bisa mengirim ke grup.

Response Format

Semua response API memakai amplop yang sama. Periksa nilai success, jangan hanya kode HTTP:

{
  "success": true,
  "message": "Pesan berhasil dikirim",
  "data": {
    "message_id": "msg_123456",
    "status": "sent"
  }
}

API Endpoints

API untuk mengirim pesan teks dan media (gambar, video, dokumen) ke nomor WhatsApp.

Send Message

POSThttps://api.kirimi.id/v1/send-message

Request Payload

{
  "user_code": "YOUR-USER-CODE",
  "device_id": "YOUR-DEVICE-ID",
  "receiver": "6281234567890",
  "message": "Hello from Kirimi API!",
  "secret": "YOUR-SECRET-KEY"
}

Parameters

Parameter	Type	Required	Description
user_code	string	Required	Kode pengguna Anda dari akun Kirimi
device_id	string	Required	ID perangkat yang sudah terdaftar
receiver	string	Required	Nomor WhatsApp penerima (format: 6281234567890). Bisa juga dikirim sebagai "phone". Untuk grup, pakai ID grup.
message	string	Optional	Pesan teks (maksimal 15.000 karakter). Wajib diisi kecuali media_url disertakan.
secret	string	Required	Kunci rahasia untuk autentikasi
media_url	string	Optional	URL file media (gambar/video/audio/dokumen). Wajib bila message kosong.
fileName	string	Optional	Nama file yang ditampilkan saat mengirim dokumen
quotedMessageId	string	Optional	ID pesan yang ingin dibalas (reply)

Broadcast Message

POSThttps://api.kirimi.id/v1/broadcast-message

Request Payload

{
  "user_code": "YOUR-USER-CODE",
  "device_id": "YOUR-DEVICE-ID",
  "label": "Campaign Name",
  "numbers": [
    "6281234567890",
    "6289876543210"
  ],
  "message": "Broadcast message content",
  "secret": "YOUR-SECRET-KEY",
  "delay": 30
}

Parameters

Parameter	Type	Required	Description
user_code	string	Required	Kode pengguna Anda dari akun Kirimi
device_id	string	Required	ID perangkat terdaftar Anda
label	string	Required	Label broadcast untuk identifikasi
numbers	array	Required	Array nomor telepon penerima
message	string	Required	Pesan yang akan dikirim
secret	string	Required	Kunci rahasia untuk autentikasi
delay	number	Optional	Jeda antar pesan dalam detik. Nilai di bawah 30 otomatis dinaikkan ke 30, maksimal 3600. Default 30.
delayMin	number	Optional	Batas bawah jeda acak antar pesan (detik). Berlaku aturan minimum 30 yang sama.
delayMax	number	Optional	Batas atas jeda acak antar pesan (detik), maksimal 3600.
media_url	string	Optional	URL file media yang ikut dikirim ke seluruh penerima
started_at	string	Optional	Jadwal mulai broadcast (format datetime). Kosongkan untuk mengirim sekarang.

Contoh Kode

Berikut adalah contoh implementasi untuk mengirim pesan menggunakan berbagai bahasa pemrograman.

Kirimi API Documentation

Getting Started

Base URL

Autentikasi

Penting

Dua jalur pengiriman

Response Format

API Endpoints

Send Message

Request Payload

Parameters

Broadcast Message

Request Payload

Parameters

Contoh Kode

Pertanyaan Umum

API Playground

Credentials Dapatkan API Key

Siap untuk memulai?