Webhook Pesan Masuk WhatsApp
Setiap pesan yang diterima perangkat Anda bisa diteruskan ke URL server Anda secara real-time.
Mengaktifkan webhook
Di dashboard, buka pengaturan perangkat dan isi Webhook URL (harus bisa diakses publik, disarankan HTTPS).
Format data
Synerwa mengirim POST dengan body JSON:
{
"device": "6281200000000",
"sender": "6281234567890",
"name": "Budi",
"message": "Halo, stok masih ada?",
"isgroup": false,
"member": null,
"timestamp": 1790127135,
"id": 5521,
"type": "image",
"attachment": true,
"url": "https://synerwa.net/file/5521/abcd1234",
"filename": "foto.jpg",
"extension": "jpg",
"mimetype": "image/jpeg",
"location": ""
}
| Field | Keterangan |
|---|---|
type | text, image, video, audio, document, sticker, location, contact |
attachment | true bila pesan membawa file |
url | Tautan unduh file (kosong untuk teks) |
isgroup / member | Pesan grup dan nomor pengirim di grup |
location | Koordinat bila pesan berupa lokasi |
Contoh penerima (PHP)
<?php
$in = json_decode(file_get_contents('php://input'), true);
http_response_code(200);
if (!empty($in['attachment'])) {
file_put_contents('/data/wa/' . basename($in['filename']), file_get_contents($in['url']));
}
// simpan $in['sender'], $in['message'] ke database Anda
Praktik yang baik
- Balas HTTP 200 secepatnya (batas tunggu 10 detik), proses berat di latar belakang.
- Gunakan
iduntuk mencegah pemrosesan ganda. - Rahasiakan URL webhook atau tambahkan token rahasia di query string.