WhatsApp Sender - Dokumentasi API

Autentikasi

Gunakan API key perangkat (device token) dari halaman Perangkat.

API key = token perangkat. Setiap perangkat memiliki token unik yang dapat dilihat di menu Perangkat.

Header	Nilai	Catatan
Authorization	`Bearer {device_token}`	Disarankan
X-API-Key	`{device_token}`	Alternatif
Content-Type	`application/json`	Wajib untuk POST

Daftar perangkat

Mengembalikan informasi perangkat yang sedang diautentikasi.

Titik Akhir

GET https://instan.app/api/whatsapp-sender/v1/devices

Contoh

curl --request GET \
--url 'https://instan.app/api/whatsapp-sender/v1/devices' \
--header 'Authorization: Bearer {device_token}'

Contoh Respons

{
    "success": true,
    "message": "OK",
    "data": [
        {
            "token": "abc123",
            "name": "Device Utama",
            "phone": "6281234567890",
            "status": "connected",
            "server_key": "srv_01",
            "created_at": "2026-07-01 10:00:00"
        }
    ]
}

Kirim pesan

Kirim pesan teks WhatsApp melalui perangkat yang diautentikasi via API key.

Titik Akhir

POST https://instan.app/api/whatsapp-sender/v1/messages/send

Contoh

curl --request POST \
--url 'https://instan.app/api/whatsapp-sender/v1/messages/send' \
--header 'Authorization: Bearer {device_token}' \
--header 'Content-Type: application/json' \
--data '{"to":"6281234567890","message":"Halo dari API"}'

Parameter	Rincian	Deskripsi
to	Diperlukan String	Nomor tujuan (format internasional, tanpa +).
message	Diperlukan String	Isi pesan teks atau caption media.
allow_group	Opsional Boolean	Izinkan kirim ke grup WhatsApp (default: false).

Contoh Respons

{
    "success": true,
    "message": "Pesan berhasil dikirim.",
    "data": {
        "device_token": "abc123",
        "to": "6281234567890",
        "message_type": "text"
    }
}

Kirim media

Kirim gambar, video, atau dokumen WhatsApp melalui URL media publik.

Titik Akhir

POST https://instan.app/api/whatsapp-sender/v1/messages/send-media

Contoh

curl --request POST \
--url 'https://instan.app/api/whatsapp-sender/v1/messages/send-media' \
--header 'Authorization: Bearer {device_token}' \
--header 'Content-Type: application/json' \
--data '{"to":"6281234567890","media_url":"https://example.com/promo.jpg","message_type":"image","message":"Promo spesial!"}'

Parameter	Rincian	Deskripsi
to	Diperlukan String	Nomor tujuan (format internasional, tanpa +).
media_url	Diperlukan String	URL media publik. Wajib jika message_type bukan text.
message_type	Diperlukan String	image, video, atau document.
message	Opsional String	Caption media (opsional).
allow_group	Opsional Boolean	Izinkan kirim ke grup WhatsApp (default: false).

Contoh Respons

{
    "success": true,
    "message": "Media berhasil dikirim.",
    "data": {
        "device_token": "abc123",
        "to": "6281234567890",
        "message_type": "image",
        "media_url": "https://example.com/promo.jpg"
    }
}

Kode error

HTTP	Penyebab
401	API key perangkat tidak ada atau tidak valid.
403	Langganan WhatsApp Sender tidak aktif.
404	Perangkat tidak ditemukan.
422	Validasi gagal atau perangkat tidak terhubung.

Alur integrasi

Langkah singkat untuk mulai mengirim pesan via API.

Hubungkan perangkat WhatsApp di Perangkat.
Salin API key perangkat dari menu Perangkat → API key.
Kirim pesan teks dengan POST /messages/send atau media dengan POST /messages/send-media.