API Documentation
Integrate WhatsApp Gateway with your applications.
Catatan Penting: Untuk mengurangi risiko *banned*, seluruh API pengiriman pesan memiliki jeda (*delay*) variatif secara acak (3, 5, 8, atau 10 detik) disertai status *Typing* sebelum pesan benar-benar terkirim.
1. Authentication
Semua permintaan API (API requests) wajib menyertakan API Key pada Header HTTP dengan nama kunci x-api-key.
Headers:
{
"x-api-key": "API_KEY_ANDA_DI_SINI",
"Content-Type": "application/json"
}
2. Send Text Message
Endpoint: POST https://sigap.disdikbud.id/api/messages/send
Contoh menggunakan cURL:
curl -X POST https://sigap.disdikbud.id/api/messages/send \
-H "x-api-key: API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"device_id": 1,
"target_number": "6281234567890",
"message": "Hello from API!"
}'
3. Send Image Message
Endpoint: POST https://sigap.disdikbud.id/api/messages/send-image
{
"device_id": 1,
"target_number": "6281234567890",
"image_url": "https://example.com/image.jpg",
"caption": "Image description"
}
4. Send Button Message
Endpoint: POST https://sigap.disdikbud.id/api/messages/send-button
{
"device_id": 1,
"target_number": "6281234567890",
"text": "Please choose an option:",
"footer": "Powered by SIGAP",
"buttons": [
{ "id": "btn_1", "display_text": "Yes" },
{ "id": "btn_2", "display_text": "No" }
]
}
5. Send Reaction
Endpoint: POST https://sigap.disdikbud.id/api/messages/send-reaction
{
"device_id": 1,
"target_number": "6281234567890",
"message_id": "message-id-from-webhook",
"emoji": "👍"
}
6. Webhook (Pull)
When you set a Webhook URL for a device, incoming messages will trigger a POST request to your URL with this payload:
{
"device_id": 1,
"sender": "6281234567890@s.whatsapp.net",
"message": "User reply text here",
"timestamp": 1723015488
}