n8n इंटीग्रेशन

अपने n8n वर्कफ़्लो से WhatsApp संदेश भेजें। उदाहरण के लिए, वेबहुक से आई नई लीड को संदेश भेजें, अपने स्टोर से ऑर्डर कन्फर्म करें, या कोई जांच फेल होने पर अलर्ट भेजें।

कनेक्ट करने के दो तरीके हैं:

• Wbiztool कम्युनिटी नोड (n8n-nodes-wbiztool): हर विकल्प के लिए फील्ड वाले तैयार नोड।
• बिल्ट-इन HTTP Request नोड: किसी भी n8n इंस्टेंस पर काम करता है और हर API एंडपॉइंट तक पहुंच देता है। HTTP Request नोड का उपयोग देखें।

शुरू करने से पहले#

• एक Wbiztool अकाउंट, जिसमें WhatsApp सेटिंग्स पर एक कनेक्टेड WhatsApp नंबर हो।
• सेटिंग्स → API Keys से आपका Client ID (क्लाइंट ID) और API key (API की)।
• जिस नंबर से भेजना है उसका WhatsApp Client ID (WhatsApp क्लाइंट ID), जो WhatsApp सेटिंग्स पर दिखता है।

कम्युनिटी नोड इंस्टॉल करें#

1. कम्युनिटी नोड खोलें

   n8n में Settings → Community Nodes पर जाएं और Install पर क्लिक करें।

2. पैकेज का नाम दर्ज करें

   n8n-nodes-wbiztool दर्ज करें, पुष्टि करें और इंस्टॉल करें। अगर नोड न दिखें तो n8n को रीस्टार्ट करें।

self-hosted इंस्टेंस पर आप इसे अपने n8n custom nodes फोल्डर में npm से भी इंस्टॉल कर सकते हैं:

npm install n8n-nodes-wbiztool

क्रेडेंशियल बनाएं#

WbizTool API टाइप का एक नया क्रेडेंशियल जोड़ें:

सेव करने पर n8n क्रेडेंशियल को क्रेडेंशियल जांचें से टेस्ट करता है।

नोड#

पैकेज ये नोड जोड़ता है। हर नोड एक Wbiztool API एंडपॉइंट कॉल करता है और API का रिस्पॉन्स आउटपुट करता है।

WbizTool Send Message#

नोड messageId (API से मिला msg_id) आउटपुट करता है। अगर आप बाद में स्टेटस जांचना या संदेश कैंसल करना चाहते हैं, तो इसे सेव कर लें।

उदाहरण वर्कफ़्लो#

1. Webhook नोड phone और name के साथ एक नई लीड पाता है।
2. WbizTool Send Message: Phone Number को {{ $json.phone }} और Message Text को Hi {{ $json.name }}, thanks for signing up! पर सेट करें।
3. IF नोड: जांचें कि {{ $json.messageId }} खाली नहीं है, ताकि अगला स्टेप चले, जैसे अपना CRM अपडेट करना।

सफल WbizTool Send Message इस तरह का आइटम आउटपुट करता है:

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

आइटम में एक input ऑब्जेक्ट भी होता है, जिसमें नोड की भेजी गई वैल्यू होती हैं। अगर API एरर लौटाता है, तो नोड रुक जाता है और API का message दिखाता है। इसकी जगह success: false और error टेक्स्ट वाला आइटम पाने के लिए Continue On Fail चालू करें।

WbizTool WhatsApp Client Status के लिए General Status check method इस्तेमाल करें। उस API endpoint में एक बग की वजह से Status by ID method हर नंबर के लिए एरर लौटाता है। General Status के साथ, जो नंबर कनेक्टेड नहीं है वह भी नोड को Disconnected एरर के साथ रोक देता है, इसलिए अगर आप नतीजे पर ब्रांच करना चाहते हैं तो नोड की Continue On Fail सेटिंग चालू करें।

HTTP Request नोड का उपयोग#

एक HTTP Request नोड जोड़ें और उसे इस तरह सेट करें:

फिर इस तरह का body पेस्ट करें और expressions से पिछले नोड की वैल्यू मैप करें:

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

सफल कॉल {"status": 1, "message": "Created", "msg_id": 9817263} लौटाती है। सभी फील्ड और एरर मैसेज संदेश भेजें पर हैं।

दूसरे एंडपॉइंट कॉल करने के लिए URL और body बदलें। उदाहरण के लिए, संदेश शेड्यूल करने के लिए https://wbiztool.com/api/v1/schedule_msg/ इस्तेमाल करें और date को DD/MM/YYYY, time को HH:MM के रूप में और timezone जोड़ें। संदेश शेड्यूल करें देखें।

एक ही संदेश एक कॉल में कई नंबरों या ग्रुप को भेजने के लिए https://wbiztool.com/api/v1/send_msg/multi/ इस्तेमाल करें और सभी प्राप्तकर्ताओं को phone में कॉमा से अलग की गई एक स्ट्रिंग के रूप में डालें। कई नंबरों पर भेजें देखें।

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

हर नंबर में सिर्फ अंक डालें। जो कुछ भी पूर्ण संख्या नहीं है, जैसे 98765 43210, वह ग्रुप के नाम के रूप में भेजा जाता है।

n8n expressions किसी भी टेक्स्ट फील्ड में काम करते हैं। उदाहरण के लिए, दिन के समय के हिसाब से बदलने वाला अभिवादन, या ऑर्डर के कुल अमाउंट के हिसाब से बदलने वाला टेक्स्ट:

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

$now वर्कफ़्लो के टाइमज़ोन (Workflow settings → Timezone) का इस्तेमाल करता है, इसलिए "morning" कब खत्म होगी, यह तय करने के लिए इसे सेट करें।

संदेश भेजे जाने पर सूचना पाएं#

1. वेबहुक वर्कफ़्लो बनाएं

   HTTP method POST के साथ एक Webhook नोड जोड़ें और उसका production URL कॉपी करें।

2. भेजते समय URL दें

   वह URL नोड के Webhook URL विकल्प में, या अपने HTTP रिक्वेस्ट body के webhook फील्ड में डालें।

3. नतीजा पढ़ें

   संदेश भेजे जाने या फेल होने पर Wbiztool उस URL को कॉल करता है। body form-encoded होता है और उसमें सिर्फ msg_id और status होते हैं, जिसकी वैल्यू SENT या FAILED होती है।

retry और timeout के लिए वेबहुक देखें।

समस्या निवारण#