Integrasi n8n

Kirim pesan WhatsApp dari alur kerja n8n Anda. Misalnya, kirim pesan ke prospek baru dari webhook, konfirmasi pesanan dari toko Anda, atau kirim peringatan saat sebuah pengecekan gagal.

Ada dua cara untuk menghubungkan:

• Community node Wbiztool (n8n-nodes-wbiztool): node siap pakai dengan field untuk setiap opsi.
• Node HTTP Request bawaan: berfungsi di instance n8n mana pun dan memberi Anda akses ke setiap endpoint API. Lihat Menggunakan node HTTP Request.

Sebelum memulai#

• Akun Wbiztool dengan nomor WhatsApp yang terhubung di WhatsApp settings.
• Client ID dan API key Anda dari Settings → API keys.
• WhatsApp Client ID dari nomor pengirim, yang ditampilkan di WhatsApp settings.

Memasang community node#

1. Buka community nodes

   Di n8n, buka Settings → Community Nodes lalu klik Install.

2. Masukkan nama paket

   Masukkan n8n-nodes-wbiztool, konfirmasi, lalu pasang. Mulai ulang n8n jika node tidak muncul.

Pada instance self-hosted, Anda juga dapat memasangnya dengan npm di folder custom nodes n8n Anda:

npm install n8n-nodes-wbiztool

Membuat kredensial#

Tambahkan kredensial baru dengan tipe WbizTool API:

Saat Anda menyimpan, n8n menguji kredensial terhadap Cek kredensial.

Node#

Paket ini menambahkan node berikut. Setiap node memanggil endpoint API Wbiztool dan mengeluarkan respons API.

WbizTool Send Message#

Node ini mengeluarkan messageId (msg_id dari API). Simpan jika Anda ingin memeriksa status atau membatalkan pesan nanti.

Contoh alur kerja#

1. Node Webhook menerima prospek baru dengan phone dan name.
2. WbizTool Send Message: atur Phone Number ke {{ $json.phone }} dan Message Text ke Hi {{ $json.name }}, thanks for signing up!.
3. Node IF: periksa bahwa {{ $json.messageId }} tidak kosong untuk melanjutkan ke langkah berikutnya, seperti memperbarui CRM Anda.

WbizTool Send Message yang berhasil mengeluarkan item seperti ini:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

Item tersebut juga berisi objek input dengan nilai yang dikirim node. Jika API mengembalikan error, node berhenti dan menampilkan message dari API. Aktifkan Continue On Fail untuk mendapatkan item dengan success: false dan teks error sebagai gantinya.

Untuk WbizTool WhatsApp Client Status, gunakan metode pengecekan General Status. Metode Status by ID mengembalikan error untuk setiap nomor karena ada bug di endpoint API tersebut. Dengan General Status, nomor yang tidak terhubung juga menghentikan node dengan error Disconnected, jadi aktifkan pengaturan Continue On Fail pada node jika Anda ingin membuat percabangan berdasarkan hasilnya.

Menggunakan node HTTP Request#

Tambahkan node HTTP Request dan konfigurasikan seperti ini:

Lalu tempelkan body seperti ini dan petakan nilai dari node sebelumnya dengan expression:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Panggilan yang berhasil mengembalikan {"status": 1, "message": "Created", "msg_id": 9817263}. Semua field dan pesan error ada di Kirim pesan.

Untuk memanggil endpoint lain, ubah URL dan body-nya. Misalnya, untuk menjadwalkan pesan, gunakan https://wbiztool.com/api/v1/schedule_msg/ dan tambahkan date dalam format DD/MM/YYYY, time dalam format HH:MM, serta timezone. Lihat Jadwalkan pesan.

Untuk mengirim pesan yang sama ke beberapa nomor atau grup dalam satu panggilan, gunakan https://wbiztool.com/api/v1/send_msg/multi/ dan letakkan penerima di phone sebagai satu string yang dipisahkan koma. Lihat Kirim ke banyak nomor.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Gunakan hanya angka di setiap nomor. Apa pun yang bukan bilangan bulat, seperti 98765 43210, dikirim sebagai nama grup.

Expression n8n berfungsi di dalam field teks apa pun. Misalnya, sapaan yang bergantung pada waktu, atau teks yang bergantung pada total pesanan:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now menggunakan zona waktu alur kerja (Workflow settings → Timezone), jadi atur zona waktu tersebut untuk menentukan kapan „morning“ berakhir.

Mendapat notifikasi saat pesan terkirim#

1. Buat alur kerja webhook

   Tambahkan node Webhook dengan metode HTTP POST dan salin URL produksinya.

2. Sertakan URL saat mengirim

   Letakkan URL tersebut di opsi Webhook URL pada node, atau di field webhook pada body HTTP request Anda.

3. Baca hasilnya

   Wbiztool memanggil URL tersebut setelah pesan terkirim atau gagal. Body-nya menggunakan encoding form dan hanya berisi msg_id dan status, yang bernilai SENT atau FAILED.

Lihat Webhook untuk percobaan ulang dan timeout.

Pemecahan masalah#