AIFENG DCS · Integrasi Resmi Meta

Penjelasan Endpoint Penerima Webhook

Callback URL (diisi di dashboard Meta)

https://app.aifengdcs.com/api/meta/webhook

Token verifikasi

META_VERIFY_TOKEN: string acak yang kita tentukan sendiri, hanya ada di variabel lingkungan server; saat mengatur callback di Meta, isi sama di kedua sisi.

Field langganan (pesan baru terkirim hanya setelah dicentang)

Objek Page (Halaman FB)

Objek Instagram (akun profesional IG)

Alur penerimaan (kerangka sudah diimplementasikan modul ini)

1. Meta mengirim GET verifikasi: bila hub.verify_token cocok dengan META_VERIFY_TOKEN, server membalas hub.challenge
2. Setelah itu Meta mengirim event pesan via POST (contoh JSON di bawah)
3. Server memverifikasi tanda tangan X-Hub-Signature-256 dengan META_APP_SECRET
4. Parse entry[].messaging[] dan changes[] (komentar), lalu tulis ke uc_meta_messages_v109
5. Constraint unik message_mid membuat dedup idempoten; pengiriman ulang tidak menggandakan pesan

Contoh payload (event DM)

{
  "object": "page",
  "entry": [{
    "id": "<PAGE_ID>",
    "time": 1735689600000,
    "messaging": [{
      "sender": {"id": "<USER_PSID>"},
      "recipient": {"id": "<PAGE_ID>"},
      "timestamp": 1735689600000,
      "message": {"mid": "m_abc123", "text": "Halo, tanya harga"}
    }]
  }]
}