24 jam terakhir
Webhook di Meta
Meta App → WhatsApp → Configuration → Webhook. Langganan (subscribe) ruas messages.
Alamat API untuk aplikasi
Isi di layar pengaturan gerbang ERP/FAIMA/SDM sebagai URL endpoint, bersama token aplikasi dari tab Aplikasi.
Nomor WhatsApp Business
| # | Nama | Nomor | Phone Number ID | Kualitas | Template cadangan | Status |
|---|
Aplikasi pemakai gerbang
| # | Nama | Token | Nomor pengirim | Webhook | Terakhir dipakai | Status |
|---|
Log pesan
| Waktu | Arah | Kontak | Aplikasi | Jenis | Isi | Status |
|---|
Kiriman webhook ke aplikasi
| Waktu | Aplikasi | Acara | Percobaan | HTTP | Status | Galat |
|---|
Aturan 24 jam Meta
Pesan bebas (teks, dokumen) hanya diterima Meta bila penerima mengirim pesan ke nomor ini dalam 24 jam terakhir. Di luar itu wajib template yang sudah disetujui. Gerbang memeriksa ini otomatis:
- Jendela terbuka → dikirim sebagai pesan biasa.
- Jendela tertutup → dikirim lewat template cadangan nomor tersebut. Baris baru pada pesan diganti " · " karena isian template tidak boleh berisi baris baru.
- Template cadangan belum diatur → ditolak dengan galat
outside_24h_window(HTTP 409).
Template cadangan yang diajukan di WhatsApp Manager
Kategori Utility, bahasa Indonesian (id). Nama dan isinya bebas, asalkan bentuknya sama: satu isian {{1}} di badan.
Ada pemberitahuan baru untuk Anda:
{{1}}
Pesan ini dikirim otomatis oleh sistem.
Berikut dokumen untuk Anda: {{1}}.
Pesan ini dikirim otomatis oleh sistem.
Contoh isian saat mengajukan: PO/0002 menunggu persetujuan Anda · Total Rp 12.500.000.
API
Sama dengan gerbang lama. Header: Authorization: Bearer wag_…
Jawaban sukses { ok: true, message_id, wa_message_id, via } — via = text, document, image, atau template. Jawaban galat { ok: false, error, message }; meta_unavailable (HTTP 503) aman diulang, send_failed (HTTP 422) tidak.
Webhook ke aplikasi
Bentuk dan tanda tangannya sama dengan gerbang lama: header X-Wag-Event dan X-Wag-Signature: sha256=HMAC(rahasia webhook, badan).
{ "event": "message.incoming", "timestamp": 1760460000, "device_id": 1,
"data": { "sender": "6281234567890", "name": "Budi", "message": "Ya, setuju",
"type": "chat", "is_group": false, "message_id": "wamid.…", "timestamp": 1760460000 } }
{ "event": "message.status", "timestamp": 1760460000, "device_id": 1,
"data": { "message_id": 42, "wa_message_id": "wamid.…", "to": "6281234567890",
"status": "delivered" } } // sent | delivered | read | failed (+ error_code, error)