Setup Meta & WhatsApp Business (Cloud API)

Convord menangani pesanan dan pesan masuk melalui WhatsApp Cloud API. Nilai di bawah dibaca dari .env server ke grup config whatsapp.

Prasyarat

1. Aplikasi Meta Business dengan produk WhatsApp diaktifkan, dan nomor WhatsApp Business aktif (test atau live).
2. URL HTTPS publik yang stabil untuk webhook (gunakan tunnel seperti ngrok untuk testing lokal).
3. Dokumentasi resmi: WhatsApp Cloud API — Get Started.

Variabel server (.env)

Key yang digunakan untuk panggilan Graph dan verifikasi webhook:

• WHATSAPP_API_TOKEN — Token sementara atau system user dari Meta. Ingat untuk merotasi token yang kedaluwarsa di produksi.
• WHATSAPP_PHONE_NUMBER_ID — Dari WhatsApp → API Setup: Phone number ID.
• WHATSAPP_VERIFY_TOKEN — String rahasia yang Anda buat; field webhook "Verify" Meta harus menggunakan nilai yang sama.
• WHATSAPP_API_URL — Opsional; mis. https://graph.facebook.com/v18.0 (naikkan versi saat upgrade).

URL Webhook

Gunakan URL lengkap ini sebagai "Callback URL" Meta: https://convord.com/webhook/whatsapp

• Verifikasi GET: hub.verify_token harus cocok dengan WHATSAPP_VERIFY_TOKEN.
• Event POST: pesan masuk mengenai endpoint ini; aplikasi menangani validasi dan pemrosesan.

Setelah setup

Setelah "Verify" berhasil di Meta, kirim pesan test dari nomor yang diizinkan dan periksa log aplikasi. Error Graph biasanya menyertakan detail di body respons.

Informasi lebih lanjut

Baca bersama Panduan integrasi untuk linking pelanggan dan operasi.

Panduan Meta Developer lengkap (Tahap 1–7, repo) →