Webhooks

Webhook Meta → Wapedia

Meta mengirim event ke endpoint Wapedia (GET verify + POST payload). Signature HMAC diverifikasi dengan META_APP_SECRET (atau secret per tenant bila dikonfigurasi).

Verifikasi

Meta mengirim hub.mode, hub.verify_token, hub.challenge. Token harus cocok dengan yang dikonfigurasi di tenant / env.

Event masuk

Setelah diverifikasi, pesan inbound disimpan, percakapan/kontak di-touch, lalu opsional:

Chatbot keyword / auto-reply (lewat alur outbound ber-billing)
Forward ke webhook_forward_url tenant

Forward ke sistem Anda

Set webhook_forward_url di settings tenant. Syarat keamanan:

HTTPS saja
Host publik (bukan localhost, IP privat, link-local, atau metadata cloud)

Payload JSON contoh:

{
  "event": "message.inbound",
  "tenant_id": "uuid",
  "message_id": "wamid....",
  "from": "6281234567890",
  "type": "text",
  "content_preview": "Halo",
  "payload": {}
}

Timeout forward singkat; kegagalan di-log tanpa menggagalkan ingest utama.

Untuk verifikasi signature Meta di endpoint Anda sendiri, gunakan verifyMetaSignature dari TypeScript SDK.

Status delivery

Update status outbound (sent / delivered / read / failed) diproses dari webhook status Meta dan idempotent per message_id + status.