Dokumentasi API

Mulai cepat

SENDAL WAGU adalah gateway WhatsApp tidak resmi. Hubungkan nomor Anda sekali, lalu kirim pesan dari aplikasi apa pun lewat satu endpoint REST.

1. Pilih paket. Buka menu Pilih Paket di panel customer.
2. Hubungkan WhatsApp. Di Sesi WhatsApp, klik Buat sesi baru, lalu Lihat QR dan scan lewat WhatsApp › Perangkat tertaut. Tunggu status connected.
3. Buat API key. Buka API Akses lalu klik Buat API key.
4. Kirim pesan. Salin contoh kode di bagian Kirim pesan.

Daftar gratis Masuk

Autentikasi

Semua request ke API wajib membawa API key milik akun Anda. Kirim apa adanya lewat header Authorization, tanpa awalan Bearer. Header X-Api-Key dan Token, atau field api_key di body, juga diterima.

Endpoint kirim pesan adalah Base URL ditambah /messages.

Kirim pesan teks

Parameter body

Contoh request

curl -X POST "https://send.alkhaf.com/api/v1/messages" \
  -H "Authorization: <API_KEY_ANDA>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "session": "nama_sesi_anda",
    "to": "628123456789",
    "message": "Halo dari SENDAL WAGU!"
  }'

<?php
$ch = curl_init('https://send.alkhaf.com/api/v1/messages');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: <API_KEY_ANDA>',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'session' => 'nama_sesi_anda',
        'to' => '628123456789',
        'message' => 'Halo dari SENDAL WAGU!',
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

const res = await fetch('https://send.alkhaf.com/api/v1/messages', {
  method: 'POST',
  headers: {
    Authorization: '<API_KEY_ANDA>',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    session: 'nama_sesi_anda',
    to: '628123456789',
    message: 'Halo dari SENDAL WAGU!',
  }),
});

console.log(res.status, await res.json());

import requests

res = requests.post(
    "https://send.alkhaf.com/api/v1/messages",
    headers={"Authorization": "<API_KEY_ANDA>", "Accept": "application/json"},
    json={
        "session": "nama_sesi_anda",
        "to": "628123456789",
        "message": "Halo dari SENDAL WAGU!",
    },
)
print(res.status_code, res.json())

Respons

Jika berhasil, API membalas 200 dan kuota pesan berkurang satu. Isi data adalah respons mentah dari mesin WhatsApp dan bisa berbeda antarversi. Daftar respons gagal ada di Kode respons.

{
  "message": "Pesan terkirim.",
  "data": { "id": "..." }
}

Integrasi aplikasi lain

Untuk aplikasi pihak ketiga (sistem kost, kasir, ERP, dan sejenisnya) yang punya kolom pengaturan gateway, isi seperti berikut.

Nama field alternatif yang diterima: tujuan to / phone / target / number; isi pesan message / text / body; pengirim session / sender / from / device. Path alternatif: /send dan /send-message di bawah /api atau /api/v1.

Status sesi

Status tampil di menu Sesi WhatsApp dan diperbarui otomatis. Pesan hanya bisa dikirim saat status connected.

Kode respons

Setiap respons berupa JSON dengan kunci message. Gunakan kode status HTTP untuk menentukan langkah berikutnya.

Kuota dan paket

• Kuota berkurang satu untuk setiap pesan yang berhasil (respons 200). Request yang gagal tidak mengurangi kuota.
• Paket unlimited tidak memiliki batas jumlah pesan.
• Jumlah sesi WhatsApp dibatasi sesuai paket.
• Pesan dari paket gratis (harga Rp0) otomatis diberi watermark di akhir pesan. Paket berbayar tidak memakai watermark.
• Setelah masa aktif berakhir atau kuota habis, API membalas 402. Paket baru bisa dipilih setelah paket lama berakhir.

FAQ