Arsitektur Resilien Instagram Comment-to-DM: Meta Graph API & PostgreSQL Idempotency

Banyak bisnis kehilangan momentum penjualan karena jeda waktu antara prospek berkomentar di postingan/Reels dan respons tim sales. Menggunakan bot tidak resmi (scraping/browser automation) menimbulkan risiko tinggi suspensi akun oleh Meta.

Ketika beralih ke Meta Graph API resmi, tim engineering kerap menghadapi dua kendala sistemik:

1. Webhook Retries & Duplicate Events: Meta secara agresif mengirim ulang webhook jika server lambat merespons (>3 detik), menyebabkan pengguna menerima DM ganda untuk satu komentar.
2. Rate Limit 200 Pesan/Jam: Kebijakan Meta membatasi automasi DM maksimal 200 pesan/jam per akun bisnis. Lonjakan viral tanpa antrean yang tepat akan memicu error 400/429 OAuthException.

Arsitektur yang tangguh memisahkan proses penerimaan webhook dengan eksekusi pengiriman pesan menggunakan pola Decoupled Ingestion Queue.

1. Ingress & Verifikasi Webhook

Setiap payload masuk divalidasi menggunakan HMAC-SHA256 (X-Hub-Signature-256) terhadap App Secret. Server langsung mengembalikan status HTTP 200 OK sebelum memproses logika bisnis.

2. Idempotency Boundary di PostgreSQL

Sebelum menembak API pengiriman DM, worker melakukan atomic upsert ke PostgreSQL:

INSERT INTO ig_dm_triggers (comment_id, recipient_id, payload, status)
VALUES ($1, $2, $3, 'QUEUED')
ON CONFLICT (comment_id) DO NOTHING
RETURNING id;

Jika query mengembalikan kosong (konflik ID), proses langsung dihentikan karena event tersebut sudah terdaftar/sedang diproses.

3. Eksekusi Private Reply / Direct Messaging

Pengiriman DM dilakukan via endpoint resmi: POST https://graph.facebook.com/v19.0/{page-id}/messages Dengan menyertakan recipient: {"comment_id": "<IG_COMMENT_ID>"}. Pendekatan ini secara otomatis membuka messaging window interaksi 24 jam.

• Zero Storage on PII: Data pribadi seperti username dan isi pesan tidak disimpan permanen kecuali hanya ID ephemeral yang diperlukan untuk penelusuran audit.
• Token Security: Page Access Token (PAT) dan App Secret disimpan dalam encrypted environment variables atau KMS (Key Management Service).
• Rate-Limit Throttling: Worker menerapkan algoritma Token Bucket atau Leaky Bucket untuk memastikan dispatch rate tidak melebihi 3 pesan per detik (menjaga batas aman <200/jam).

1. Setup Meta Developer App: Buat aplikasi tipe Business, hubungkan Instagram Business Account dan Facebook Page.
2. Konfigurasi Scope OAuth: Tambahkan izin instagram_manage_comments, instagram_manage_messages, dan pages_read_engagement.
3. Deploy Webhook Ingress: Implementasikan verifikasi token challenge (hub.challenge) dan signature validator HMAC-SHA256.
4. Inisialisasi Tabel Idempotency: Buat tabel instagram_comment_events dengan constraint UNIQUE(comment_id) di PostgreSQL.
5. Pasang Throttled Queue Worker: Jalankan queue processor (misal via n8n atau native Redis/PG-Boss worker) dengan rate limit 180 req/jam untuk buffer headroom.