Panduan Lengkap

Dari Nol Sampai Integrasi Webhook dengan n8n

Selamat datang di panduan resmi Conexchat! Tutorial ini akan memandu Anda dari awal membuat akun, menghubungkan nomor WhatsApp bisnis Anda, mengirim pesan via API, hingga membuat sistem balasan otomatis menggunakan platform visual workflow n8n.

1 Mendapatkan API Key

API Key adalah kunci rahasia yang digunakan sistem Anda (atau n8n) untuk berkomunikasi dengan server Conexchat secara aman.

1. Login ke Dashboard Conexchat.
2. Buka menu Pengaturan di sidebar sebelah kiri.
3. Gulir ke bawah pada bagian API & Webhook.
4. Klik tombol "Generate New API Key" (atau salin API Key jika sudah ada).
5. Simpan kunci tersebut di tempat yang aman. Anda akan membutuhkannya di Langkah 3 dan 5.

2 Menghubungkan Nomor (Connect Number)

Berbeda dengan WhatsApp Official API yang rumit, di Conexchat Anda cukup melakukan scan QR Code layaknya menggunakan WhatsApp Web.

1. Masih di Dashboard Conexchat, buka menu Nomor WA.
2. Klik tombol + Tambah Perangkat.
3. Sebuah QR Code akan muncul di layar.
4. Buka aplikasi WhatsApp di HP bisnis Anda, masuk ke Settings > Linked Devices > Link a Device.
5. Scan QR Code di layar komputer Anda.

Setelah sukses, status perangkat Anda di dashboard akan berubah menjadi CONNECTED.

3 Mengirim Pesan Pertama via API

Mari kita tes apakah nomor Anda sudah bisa mengirim pesan menggunakan API. Anda bisa mengetesnya menggunakan cURL di terminal atau menggunakan Postman.

curl -X POST https://conexchat.com/api/send \
-H "Authorization: Bearer YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
  "number": "6281234567890",
  "message": "Halo! Ini pesan percobaan dari Conexchat API \u2728"
}'

Ganti YOUR_API_KEY_HERE dengan API key yang Anda dapat di Langkah 1, dan ganti nomor dengan nomor HP tujuan (pastikan menggunakan kode negara tanpa tanda plus, misal: 62 untuk Indonesia).

Jika berhasil, HP tujuan akan menerima pesan WhatsApp tersebut seketika!

4 Konsep Webhook (Menerima Pesan)

Untuk membuat bot auto-reply atau otomasi, sistem Anda harus tahu kapan pelanggan mengirim pesan. Di sinilah peran Webhook.

Saat nomor Anda menerima pesan baru, server Conexchat akan langsung "mengetuk pintu" server Anda (mengirim HTTP POST Request) dengan membawa isi pesan tersebut (payload). Tugas Anda hanyalah menyediakan URL (pintu) untuk diketuk.

5 Implementasi Webhook dengan n8n

Jika Anda tidak bisa coding dari nol, n8n adalah solusi visual yang brilian untuk menangkap Webhook dan membalas pesan.

A. Membuat Webhook Node di n8n

1. Buka workspace n8n Anda. Klik Add first step dan cari node Webhook.
2. Atur HTTP Method ke POST.
3. Ubah path sesuai selera (misal: conexchat-inbound).
4. Copy Test URL yang diberikan oleh n8n (Biasanya berawalan https://your-n8n-url.com/webhook-test/...).

B. Mendaftarkan Webhook URL di Conexchat

1. Kembali ke Dashboard Conexchat, lalu buka menu Nomor WA.
2. Klik tombol Edit (ikon pensil/pengaturan) pada nomor WhatsApp yang sudah Anda hubungkan.
3. Paste Test URL dari n8n ke kolom Webhook URL pada tab Pengaturan Dasar.
4. Klik Simpan.

C. Menangkap Data Pesan

Sekarang, klik tombol "Listen for Test Event" di node Webhook n8n Anda. Lalu cobalah kirim pesan WhatsApp (misalnya "Halo Bot") dari HP orang lain ke nomor bisnis Anda.

n8n akan menangkap payload JSON yang bentuknya kurang lebih seperti ini:

{
  "event": "messages.upsert",
  "data": {
    "from": "6281234567890",
    "pushName": "Budi Santoso",
    "body": "Halo Bot"
  }
}

D. Membalas Otomatis (Auto-Reply) dengan HTTP Request Node

Sekarang, tambahkan node baru di n8n (hubungkan dari output node Webhook). Cari node HTTP Request.

Lakukan konfigurasi berikut di node HTTP Request:

• Method: POST
• URL: https://conexchat.com/api/send
• Authentication: Pilih Generic Credential Type > Header Auth. (Isi Name: Authorization, Value: Bearer YOUR_API_KEY).
• Send Body: ON
• Body Type: JSON

Di bagian parameter Body, set nilainya seperti ini (Anda menggunakan variabel ekspresi dari node Webhook sebelumnya):

{
  "number": "={{ $json.body.data.from }}",
  "message": "Halo {{ $json.body.data.pushName }}! Terima kasih sudah menghubungi kami. Pesan Anda: '{{ $json.body.data.body }}' telah kami terima."
}

Simpan node tersebut. Saat ini, setiap kali ada orang yang mengirim chat, n8n akan menerimanya dan HTTP Request node akan menembak kembali API Conexchat untuk membalasnya dengan menyapa nama pengirim!

Kesimpulan

Sangat mudah bukan? Anda baru saja membangun sistem Chatbot responsif yang berjalan otomatis 24/7 menggunakan Conexchat dan n8n. Dari dasar ini, Anda bisa menambahkan logika yang lebih kompleks di n8n, seperti menyimpan pesanan ke Google Sheets, mengecek ketersediaan produk di database, hingga menyambungkannya dengan AI ChatGPT.

Jika butuh bantuan lebih lanjut, jangan ragu untuk melihat dokumentasi API lengkap kami di menu API Docs.