Integrasi n8n

Hantar mesej WhatsApp dari aliran kerja n8n anda. Contohnya, hantar mesej kepada prospek baharu daripada webhook, sahkan pesanan dari kedai anda, atau hantar makluman apabila sesuatu semakan gagal.

Terdapat dua cara untuk bersambung:

• Nod komuniti Wbiztool (n8n-nodes-wbiztool): nod siap sedia dengan medan untuk setiap pilihan.
• Nod HTTP Request terbina dalam: berfungsi pada mana-mana instans n8n dan memberi anda akses ke setiap endpoint API. Lihat Menggunakan nod HTTP Request.

Sebelum anda bermula#

• Akaun Wbiztool dengan nombor WhatsApp yang bersambung di WhatsApp settings.
• Client ID dan kunci API anda dari Settings → API keys.
• WhatsApp Client ID bagi nombor yang menghantar, ditunjukkan di WhatsApp settings.

Pasang nod komuniti#

1. Buka nod komuniti

   Dalam n8n, pergi ke Settings → Community Nodes dan klik Install.

2. Masukkan nama pakej

   Masukkan n8n-nodes-wbiztool, sahkan dan pasang. Mulakan semula n8n jika nod tidak muncul.

Pada instans yang dihos sendiri, anda juga boleh memasangnya dengan npm dalam folder nod tersuai n8n anda:

npm install n8n-nodes-wbiztool

Cipta kelayakan#

Tambah kelayakan baharu jenis WbizTool API:

Apabila anda menyimpan, n8n menguji kelayakan dengan Semak kelayakan.

Nod#

Pakej ini menambah nod berikut. Setiap satu memanggil endpoint API Wbiztool dan mengeluarkan respons API.

WbizTool Send Message#

Nod mengeluarkan messageId (msg_id daripada API). Simpannya jika anda mahu menyemak status atau membatalkan mesej kemudian.

Contoh aliran kerja#

1. Nod Webhook menerima prospek baharu dengan phone dan name.
2. WbizTool Send Message: tetapkan Phone Number kepada {{ $json.phone }} dan Message Text kepada Hi {{ $json.name }}, thanks for signing up!.
3. Nod IF: semak bahawa {{ $json.messageId }} tidak kosong untuk meneruskan ke langkah seterusnya, seperti mengemas kini CRM anda.

WbizTool Send Message yang berjaya mengeluarkan item seperti ini:

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

Item itu juga termasuk objek input dengan nilai yang dihantar oleh nod. Jika API memulangkan ralat, nod berhenti dan menunjukkan message API. Hidupkan Continue On Fail untuk mendapatkan item dengan success: false dan teks error sebaliknya.

Untuk WbizTool WhatsApp Client Status, gunakan kaedah semakan General Status. Kaedah Status by ID memulangkan ralat bagi setiap nombor kerana pepijat dalam endpoint API itu. Dengan General Status, nombor yang tidak bersambung juga menghentikan nod dengan ralat Disconnected, jadi hidupkan tetapan Continue On Fail nod itu jika anda mahu bercabang berdasarkan hasilnya.

Menggunakan nod HTTP Request#

Tambah nod HTTP Request dan konfigurasikannya seperti ini:

Kemudian tampal badan seperti ini dan petakan nilai daripada nod sebelumnya dengan ungkapan:

{
  "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 berjaya memulangkan {"status": 1, "message": "Created", "msg_id": 9817263}. Semua medan dan mesej ralat ada di Hantar mesej.

Untuk memanggil endpoint lain, tukar URL dan badan. Contohnya, untuk menjadualkan mesej gunakan https://wbiztool.com/api/v1/schedule_msg/ dan tambah date sebagai DD/MM/YYYY, time sebagai HH:MM dan timezone. Lihat Jadualkan mesej.

Untuk menghantar mesej yang sama ke beberapa nombor atau kumpulan dalam satu panggilan, gunakan https://wbiztool.com/api/v1/send_msg/multi/ dan letakkan penerima dalam phone sebagai satu rentetan yang dipisahkan dengan koma. Lihat Hantar ke banyak nombor.

{
  "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!"
}

Letakkan digit sahaja dalam setiap nombor. Apa-apa yang bukan nombor bulat, seperti 98765 43210, dihantar sebagai nama kumpulan.

Ungkapan n8n berfungsi di dalam mana-mana medan teks. Contohnya, ucapan yang bergantung pada waktu, atau teks yang bergantung pada jumlah pesanan:

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

$now menggunakan zon waktu aliran kerja (Workflow settings → Timezone), jadi tetapkannya untuk menentukan bila "morning" berakhir.

Dapatkan notifikasi apabila mesej dihantar#

1. Cipta aliran kerja webhook

   Tambah nod Webhook dengan kaedah HTTP POST dan salin URL pengeluarannya.

2. Hantar URL itu semasa menghantar mesej

   Letakkan URL itu dalam pilihan Webhook URL nod, atau dalam medan webhook badan permintaan HTTP anda.

3. Baca hasilnya

   Wbiztool memanggil URL itu sebaik sahaja mesej dihantar atau gagal. Badannya berkod borang dan hanya mengandungi msg_id dan status, iaitu SENT atau FAILED.

Lihat Webhook untuk cubaan semula dan tamat masa.

Penyelesaian masalah#