Developer Webhooks (Workflow)

Webhooks & Integration Workflow

Hubungkan aplikasi eksternal (seperti Lynk.id, WooCommerce, atau Zapier) ke Moonwa untuk memicu pengiriman pesan WhatsApp otomatis saat terjadi event tertentu.

Konsep Dasar

Fitur ini bekerja dengan mendengarkan data yang dikirim oleh aplikasi lain (Incoming Webhook), lalu memetakan data tersebut ke dalam Template Pesan yang sudah Anda buat.

Order Baru (External)

Webhook URL

Mapping Data

Kirim Notifikasi

Langkah Konfigurasi

1. Membuat Workflow

Masuk ke menu Webhooks, lalu buat workflow baru:

Name: Beri nama (misal: Notif Lynk.id).
Device (Sender): Pilih nomor WhatsApp pengirim.
Template Message: Pilih template pesan yang sudah berisi variabel (misal: {nama}, {total}).

2. Dapatkan URL Webhook

Setelah workflow dibuat, buka detailnya. Anda akan melihat Webhook Callback URL.

https://app.moonwa.id/api/workflow/123abc456-slug-unik

Salin URL ini dan tempelkan di pengaturan Webhook aplikasi pihak ketiga Anda (misal: di Dashboard Lynk.id > Settings > Webhook).

3. Capture Data (Test)

Agar Moonwa tahu struktur data yang dikirim aplikasi lain, kita perlu "menangkap" contoh datanya dulu.

Di halaman detail workflow Moonwa, klik tombol biru Capture Response.
Status akan berubah menjadi Waiting for response....
Lakukan tes transaksi atau kirim "Test Webhook" dari aplikasi pihak ketiga.
Jika berhasil, data mentah (Raw JSON) akan muncul di layar secara real-time.

Mapping Variable (Pemetaan Data)

Setelah data JSON tertangkap, Anda perlu memberi tahu sistem: "Data mana yang harus dimasukkan ke variabel {nama}?"

Data Masuk (JSON Path)

body.customer.name

body.customer.phone

body.transaction.total

Template Variable

{nama}

Receiver

{total}

Pada form Webhook Response Mapping:

Receiver: Isi dengan path menuju nomor telepon pelanggan (misal: body.data.customer.phone).
Variable Lain: Isi sesuai template Anda. Sistem biasanya memberikan saran (autocomplete) berdasarkan data yang sudah di-capture.

Mode Integrasi Khusus: Lynk.id

Jika Anda menggunakan platform Lynk.id, kami menyediakan mode khusus untuk mempermudah pengaturan.

Di detail workflow, centang "Aktifkan Mode Khusus Lynk.id".
Isi form yang muncul:
- Nomor Penerima Statis (Admin): Nomor WA Anda sendiri untuk menerima notifikasi admin.
- Merchant Key: Salin dari dashboard Lynk.id (untuk verifikasi keamanan).
- Template Pesan Admin: Template khusus untuk laporan ke admin (opsional).

Auto-Mapping: Dalam mode Lynk.id, Anda tidak perlu melakukan mapping manual yang rumit. Cukup pastikan template pesan Anda menggunakan variabel standar seperti {produk}, {qty}, dan {total}.