Unofficial WhatsApp Gateway API

API Rumah Coding dipakai untuk membuat instance gateway, mengirim pesan, mengirim media, dan menerima webhook event dari node WhatsApp unofficial. Integrasi berjalan melalui endpoint REST dengan payload JSON yang mudah dihubungkan ke CRM, support desk, atau sistem internal.

Authentication

Setiap request memakai API key pada header. Simpan token hanya di backend atau panel internal, jangan ditempel di frontend publik.

            // HTTP Headers Required

            apikey: YOUR_GLOBAL_TENANT_API_KEY

            Content-Type: application/json

Create Gateway Instance

Membuat sesi instance baru dan menghasilkan QR code untuk pairing nomor WhatsApp pada node gateway.

POST /instance/create

JSON Key	Definitions
`instanceName` Required	Nama instance unik. Gunakan huruf, angka, atau underscore agar mudah dibaca di dashboard.
`qrcode`	Mengembalikan QR code dalam format base64 untuk proses pairing. Nilai yang disarankan: `true`.

// Structure Request Layout
{
    "instanceName": "CS_HQ_NODE1",
    "token": "CLIENT_ID_SECURE_PHRASE",
    "qrcode": true
}
                

Send Text Message

Mengirim pesan teks ke nomor personal atau grup melalui instance yang sudah aktif.

POST /message/sendText/{instanceName}

JSON Pattern Payload	Description and Execution Constraint
`number` Required	Nomor tujuan diawali kode negara, contoh `6281...`. Untuk grup gunakan format JID grup sesuai output gateway.
`options.delay`	Jeda dalam milidetik untuk membantu mengatur ritme pengiriman pesan.
`textMessage.text` Required	Isi pesan. Mendukung teks Unicode dan format sederhana seperti bold atau italic sesuai dukungan WhatsApp.

// Standard Blast Array Payload Reference Structure
{
    "number": "6281234567890",
    "options": {
        "delay": 1200,
        "presence": "composing"
    },
    "textMessage": {
        "text": "Greetings from the reliable *B2B Gateway API*! \nThis payload is constructed automatically via Node Integration."
    }
}
                

Send Media Message

Mengirim dokumen, gambar, atau PDF melalui instance yang sama dengan payload URL atau base64 sesuai konfigurasi node gateway.

POST /message/sendMedia/{instanceName}

{
    "number": "6281234567890",
    "mediaMessage": {
        "mediatype": "document",
        "fileName": "proposal.pdf",
        "media": "https://example.com/proposal.pdf"
    }
}
        

Webhook Event Mapping

Webhook delivery mengirim perubahan status instance, pesan masuk, pesan terkirim, dan kegagalan queue ke endpoint tenant yang sudah didaftarkan.

Event	Use Case
`connection.update`	Memantau QR, connecting, open, dan close untuk health dashboard.
`messages.upsert`	Menerima pesan inbound dan meneruskannya ke sistem CRM atau support.
`send.message.status`	Menyimpan status sent, failed, dan retry untuk audit campaign.

Untuk dokumentasi endpoint enterprise lengkap, hubungi tim Rumah Coding atau masuk ke workspace Dashboard.