Webhook
Webhook Messenger
Inbound Webhook — Messenger
OmniStream menerima event dari Facebook Messenger melalui webhook yang terdaftar di Meta Developer Portal.
Endpoint
| Method | URL | Deskripsi |
|---|---|---|
| GET | /webhook/messenger | Verifikasi webhook (Meta challenge) |
| POST | /webhook/messenger | Menerima event Messenger |
Verifikasi Webhook
Meta mengirimkan GET request dengan parameter:
hub.mode— Harussubscribehub.challenge— Challenge string yang harus dikembalikanhub.verify_token— Token verifikasi yang cocok dengan konfigurasi
Validasi Signature
Setiap POST request memiliki header X-Hub-Signature-256 berisi HMAC-SHA256 dari payload menggunakan App Secret.
Event yang Didukung
| Event | Deskripsi |
|---|---|
| Pesan teks | Pesan teks dari pengguna |
| Attachment | Gambar, video, audio, file |
| Quick reply | Respons quick reply button |
| Postback | Button/menu postback |
| Referral | Klik dari iklan atau link |
| Reaction | Emoji reaction pada pesan |
| Delivery receipt | Konfirmasi pesan terkirim |
| Read receipt | Konfirmasi pesan dibaca |
Multi-Account Routing
OmniStream mendukung multiple halaman Facebook. Routing dilakukan berdasarkan entry[].id (Page ID) yang dicocokkan dengan integration_accounts di database.
Troubleshooting
- Webhook verification gagal — periksa
META_VERIFY_TOKENdi.envidentik dengan yang dimasukkan di Meta App Dashboard. - Payload ditolak
InvalidSignature—META_APP_SECRETtidak cocok. Perlu restart proseswebhook-ingestorsetelah mengubah.env. - Pesan tidak muncul di inbox — pastikan Page ID pada
entry[].idcocok dengan Integration Account yang terdaftar.
Rute terkait
- Integrasi Facebook Messenger — panduan setup
- Inbound WhatsApp — pola yang sama untuk WhatsApp
Last modified on