मुख्य सामग्री पर जाएं
Wbiztool

इंटीग्रेशन

किसी भी ऑटोमेशन टूल से WhatsApp संदेश भेजें

ज़्यादातर ऑटोमेशन प्लेटफॉर्म में HTTP रिक्वेस्ट भेजने वाला एक एक्शन होता है, जिसे अक्सर HTTP Request, API request या Outgoing webhook कहा जाता है। उस एक्शन को Wbiztool के संदेश भेजें एंडपॉइंट पर पॉइंट करें, और आपका वर्कफ़्लो हर बार चलने पर आपके कनेक्टेड नंबर से एक WhatsApp संदेश भेजेगा।

यह पेज सेटअप एक बार समझाता है, फिर दिखाता है कि Pabbly Connect, Albato, Activepieces और Make में यह एक्शन कहां मिलेगा।

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

आपको अपने Wbiztool अकाउंट से तीन वैल्यू चाहिए:

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

विस्तार से जानने के लिए ऑथेंटिकेशन देखें।

HTTP एक्शन सेट करें#

  1. HTTP रिक्वेस्ट एक्शन जोड़ें

    अपने ट्रिगर (नई फॉर्म एंट्री, नई स्प्रेडशीट पंक्ति, नया ऑर्डर) के बाद अपने प्लेटफॉर्म का HTTP या API रिक्वेस्ट एक्शन जोड़ें।

  2. Method और URL सेट करें

    Method POST, URL https://wbiztool.com/api/v1/send_msg/। ऑथेंटिकेशन को none ही रहने दें: क्रेडेंशियल body में जाते हैं।

  3. Body टाइप चुनें

    अगर आपका टूल JSON देता है तो उसे चुनें। Form data (फॉर्म फील्ड) भी काम करता है, इसलिए जो आपके टूल में आसान हो वह इस्तेमाल करें। किसी अतिरिक्त header की ज़रूरत नहीं है।

  4. Body फील्ड जोड़ें

    नीचे दी गई टेबल के फील्ड जोड़ें। अपने क्रेडेंशियल फिक्स्ड वैल्यू के रूप में लिखें और phonemsg को अपने ट्रिगर के डेटा से मैप करें।

  5. स्टेप टेस्ट करें

    टेस्ट डेटा के साथ स्टेप को एक बार चलाएं। "status": 1 वाले रिस्पॉन्स का मतलब है कि संदेश कतार में जुड़ गया है।

Body फील्ड#

फील्डज़रूरीवैल्यू
client_idहांआपका API क्लाइंट ID।
api_keyहांआपकी API की।
whatsapp_clientसुझाया गयाजिस WhatsApp नंबर से भेजना है उसका ID। इसे सिर्फ तभी छोड़ सकते हैं जब आपके वर्कस्पेस में ठीक एक कनेक्टेड नंबर हो। अगर वह नंबर डिसकनेक्ट है, तो इसे छोड़ने पर Invalid whatsapp client id. लौटता है।
phoneहांप्राप्तकर्ता का नंबर, जैसे किसी फॉर्म या शीट कॉलम से मैप किया गया।
country_codeसुझाया गयाबिना + के कॉलिंग कोड, जैसे 91 या 1। यह phone के आगे जोड़ा जाता है, जब तक नंबर पहले से इससे शुरू न होता हो। इसलिए जो लोकल नंबर संयोग से कंट्री कोड वाले अंकों से ही शुरू होता है, उसके आगे कोड नहीं जुड़ता। अपवाद कोड 91 है, जिसमें 10 अंकों वाले नंबरों के आगे हमेशा कोड जुड़ता है। जब भी हो सके, पूरे इंटरनेशनल नंबर भेजें।
msgटेक्स्ट संदेशों के लिएसंदेश का टेक्स्ट, 3,000 कैरेक्टर तक। इस फील्ड के दूसरे नाम के रूप में message भी स्वीकार होता है।
msg_typeनहीं0 टेक्स्ट (डिफ़ॉल्ट), 1 इमेज, 2 फाइल।
img_urlmsg_type 1 के लिएइमेज का पब्लिक URL।
file_urlmsg_type 2 के लिएफाइल का पब्लिक URL।
file_nameनहींप्राप्तकर्ता को दिखने वाला फाइल का नाम, जैसे invoice.pdf
webhookनहींवह URL जिसे संदेश भेजे जाने या फेल होने पर कॉल किया जाता है।
expire_after_secondsनहींअगर संदेश इतने सेकंड में नहीं भेजा गया, जैसे 3600, तो उसे Expired मार्क कर दिया जाता है और भेजा नहीं जाता।

किसी नंबर की जगह WhatsApp ग्रुप में भेजने के लिए phone की जगह group_name भेजें। ग्रुप में भेजें देखें। बाकी सभी विकल्प संदेश भेजें पर दिए गए हैं।

JSON body का उदाहरण#

कैपिटल अक्षरों वाली वैल्यू बदलें और placeholder को अपने ट्रिगर के फील्ड से मैप करें। ट्रिगर डेटा डालने का सटीक तरीका हर टूल में अलग होता है; ज़्यादातर टूल में आप डेटा पिकर से किसी फील्ड पर क्लिक कर सकते हैं।

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "msg": "Hi NAME_FROM_TRIGGER, thanks for your order. We will update you here on WhatsApp."
}

ग्रुप में भेजने के लिए phone और country_code की जगह group_name डालें:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "group_name": "Sales Team Mumbai",
  "msg": "New lead: NAME_FROM_TRIGGER, PHONE_FROM_TRIGGER"
}

इमेज भेजने के लिए msg_type को 1 पर सेट करें और img_url जोड़ें; तब msg कैप्शन बन जाता है। फाइल के लिए msg_type को 2 पर सेट करें और file_urlfile_name जोड़ें:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 2,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "file_url": "https://example.com/invoices/INV-1042.pdf",
  "file_name": "INV-1042.pdf",
  "msg": "Here is your invoice."
}

रिस्पॉन्स#

सफल रिक्वेस्ट यह लौटाती है:

{
  "status": 1,
  "message": "Created",
  "msg_id": 9817263
}

"status": 1 का मतलब है कि संदेश कतार में जुड़ गया है, अभी भेजा नहीं गया। कुछ गलत होने पर API HTTP 400 के साथ "status": 0 और Auth Error: invalid api key या Invalid phone number जैसा message लौटाता है। कुछ टूल 400 रिस्पॉन्स पर वर्कफ़्लो रोक देते हैं; message पढ़ने के लिए स्टेप का आउटपुट खोलें। पूरी सूची संदेश भेजें → एरर पर है।

यह जानने के लिए कि संदेश असल में कब भेजा गया, एक webhook URL दें (जैसे उसी टूल का कोई वेबहुक ट्रिगर)। उसे msg_id और status के साथ एक form-encoded POST मिलता है, जिसमें status की वैल्यू SENT या FAILED होती है। वेबहुक देखें।

Pabbly Connect#

  1. API एक्शन जोड़ें

    अपने वर्कफ़्लो में एक एक्शन स्टेप जोड़ें, ऐप API (Pabbly) और action event Execute API Request चुनें।

    Pabbly Connect वर्कफ़्लो, जिसमें Google Sheets का New or Updated Spreadsheet Row ट्रिगर और API (Pabbly) का Execute API Request एक्शन है

  2. रिक्वेस्ट सेट करें

    Action Event Method को POST, API Endpoint URL को https://wbiztool.com/api/v1/send_msg/, Payload Type को Form Data या JSON, और Authentication को No Auth पर सेट करें।

    Pabbly Connect API रिक्वेस्ट, जिसमें method POST, Wbiztool send_msg URL, payload type Form Data और No Auth सेट है

  3. पैरामीटर सेट करें

    Set Parameters पर टिक करें और हर body फील्ड के लिए एक पंक्ति जोड़ें: client_id, api_key, whatsapp_client, phone, country_code, msg और msg_typephone और msg को अपने ट्रिगर से मैप करें।

    Pabbly Connect में Set Parameters, जिसमें client_id, api_key, whatsapp_client, phone, msg_type और msg की पंक्तियां हैं

    स्क्रीनशॉट में country_code नहीं है, क्योंकि टेस्ट नंबर में कंट्री कोड पहले से शामिल है।

  4. सेव करें और टेस्ट रिक्वेस्ट भेजें

    जांचें कि रिस्पॉन्स में "status": 1 है।

Albato#

  1. HTTP एक्शन जोड़ें

    अपने ऑटोमेशन में एक एक्शन जोड़ें और HTTP Request/Outgoing webhook चुनें, फिर उसका Send request एक्शन चुनें। उदाहरण के लिए, हर नई पंक्ति पर संदेश भेजने के लिए Google Sheets का New row created ट्रिगर इस्तेमाल करें।

    Albato का Add an action डायलॉग, जिसमें ऐप सूची में सबसे ऊपर HTTP Request/Outgoing webhook है

  2. कनेक्शन बनाएं

    कनेक्शन को "Wbiztool" जैसा कोई नाम दें। आप इसके URL के रूप में https://wbiztool.com/api/v1/send_msg/ दर्ज कर सकते हैं और content type को JSON पर सेट कर सकते हैं।

  3. अपने फील्ड मैप करें

    URL को https://wbiztool.com/api/v1/send_msg/ पर सेट करें (खाली छोड़ने पर कनेक्शन का URL इस्तेमाल होता है) और Request method को POST पर। Request parameters में client_id, api_key, whatsapp_client, msg_type, country_code, phone और msg जोड़ें, और phonemsg को अपने ट्रिगर के फील्ड से चुनें।

    Albato में Map your fields, जिसमें Wbiztool send_msg URL और request method POST सेट है

    Albato के request parameters, जिनमें phone को ट्रिगर के Google Sheets कॉलम से मैप किया गया है

    स्क्रीनशॉट में message इस्तेमाल किया गया है, जो msg की जगह काम करता है। उसमें country_code नहीं है, क्योंकि टेस्ट नंबर में कंट्री कोड पहले से शामिल है।

  4. टेस्ट करें और शुरू करें

    एक टेस्ट चलाएं, पक्का करें कि रिस्पॉन्स में "status": 1 है, फिर ऑटोमेशन शुरू करें।

    Albato ऑटोमेशन, जिसमें Step 1 में Google Sheets New row created और Step 2 में HTTP Request Wbiztool Send request है

Activepieces#

  1. HTTP piece जोड़ें

    अपने ट्रिगर के बाद + पर क्लिक करें और HTTPSend HTTP request चुनें।

  2. रिक्वेस्ट सेट करें

    Method को POST और URL को https://wbiztool.com/api/v1/send_msg/ पर सेट करें। Body Type के रूप में JSON या Form Data चुनें।

    Activepieces का Send HTTP request स्टेप, जिसमें method POST, Wbiztool send_msg URL और body type Form Data सेट है

  3. Body फील्ड जोड़ें

    हर फील्ड के लिए एक आइटम जोड़ें। अपने ट्रिगर की वैल्यू phone और msg में डालने के लिए Data Selector इस्तेमाल करें। अगर phone में पहले से कंट्री कोड है (जैसे 919876543210), तो आप country_code छोड़ सकते हैं।

  4. स्टेप टेस्ट करें

    Test Step पर क्लिक करें और जांचें कि रिस्पॉन्स में "status": 1 है, फिर flow पब्लिश करें।

Make#

Make का HTTP मॉड्यूल Make a request एक्शन के साथ इस्तेमाल करें। Method को POST, URL को https://wbiztool.com/api/v1/send_msg/, body type को JSON (raw, content type application/json) या form data पर सेट करें, और ऊपर दिए गए body फील्ड भरें।

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

समस्याक्या जांचें
Auth Error: invalid api keyकी डिलीट हो गई है, उसमें टाइपो है, या वह client_id वाले वर्कस्पेस के बजाय किसी दूसरे वर्कस्पेस की है।
Invalid whatsapp client या Invalid whatsapp client id.WhatsApp सेटिंग्स से WhatsApp क्लाइंट ID इस्तेमाल करें। यह ज़रूरी है, जब तक आपके वर्कस्पेस में ठीक एक कनेक्टेड नंबर न हो।
Invalid phone numberवैल्यू में अक्षर हैं या स्पेस, डॉट, डैश, ब्रैकेट और + के अलावा कोई चिह्न है, या उसमें 6 से कम या 17 से ज़्यादा अंक हैं। नाम वाला कॉलम नहीं, फोन वाला कॉलम मैप करें।
Invalid Contact Number "…"कंट्री कोड जुड़ने के बाद नंबर 15 अंकों से लंबा है। जांचें कि फोन वैल्यू में पहले से कोई दूसरा कंट्री कोड तो नहीं है।
Either phone or group_name parameter is requiredइस रन में मैप की गई फोन वैल्यू खाली थी।
Msg cant be nullइस रन में मैप किया गया संदेश फील्ड खाली था।
Image Url Can't be null या File Url Can't be nullmsg_type 1 या 2 है, लेकिन इस रन में मैप किया गया img_url या file_url खाली था।
Invalid file url, Can't download या Invalid file urlURL से कोई फाइल नहीं मिली। वह पब्लिक होना चाहिए: जिन लिंक के लिए लॉगिन चाहिए, जैसे प्राइवेट Google Drive लिंक, वे काम नहीं करते।
रिस्पॉन्स "status": 1 है लेकिन कुछ नहीं पहुंचताजब तक आपका WhatsApp नंबर कनेक्ट नहीं होता, संदेश कतार में रहता है। WhatsApp सेटिंग्स और संदेश का स्टेटस जांचें।