इनबाउंड वेबहुक एकीकरण

बनाया गया15 मार्च, 2021

टाइमलाइन एआई आपको उन उपकरणों में घटनाओं या कार्यों के जवाब में व्हाट्सएप संदेश भेजने को स्वचालित करने की अनुमति देता है जो आप पहले से ही उपयोग कर रहे हैं: सीआरएम, समर्थन, भर्ती प्रणाली, आदि।

"संदेश भेजें" इवेंट

टाइमलाइनएआई को किसी विशिष्ट संपर्क (एक समूह हो सकता है) को संदेश (फ़ाइल अनुलग्नक के साथ या बिना) भेजने का निर्देश देना संभव है। यदि आपके कार्यस्थान में कई WhatsApp खाते कनेक्ट हैं, तो संदेश भेजने के लिए उपयोग करने के लिए एक विशेष WhatsApp खाता निर्दिष्ट करना भी संभव है.

एकीकरण को सेटअप करने के लिए, एक कार्यस्थान स्वामी को "एकीकरण / इनबाउंड वेबहुक्स" स्क्रीन पर नेविगेट करना चाहिए और नया यूआरएल उत्पन्न करना चाहिए। बाहरी सिस्टम को उस URL पर विशिष्ट प्रारूप (नीचे विवरण देखें) में संदेश पोस्ट करना चाहिए।

सीमाओं

अधिकतम अनुलग्नक आकार 2 MB है.
प्राप्तकर्ता के फ़ोन नंबर प्रारूप या WhatsApp से कनेक्शन का तत्काल सत्यापन नहीं है. संदेशों को भेजने/पढ़ने की स्थिति सत्यापित करने के लिए टाइमलाइन यूआई पर नेविगेट करें।

इनबाउंड वेबहूक के माध्यम से फ़ाइलें भेजना

फ़ाइल भेजना: सीधे डाउनलोड बनाम फ़ाइल होस्टिंग सेवाएं

डायरेक्ट डाउनलोड लिंक का उपयोग करके फ़ाइलें भेजना अनिवार्य है। यह प्राप्तकर्ता को वास्तव में फ़ाइल प्राप्त करने की अनुमति देता है।

जबकि एक फ़ाइल होस्टिंग सेवा का उपयोग किया जाना चाहिए ताकि यह एक सीधा डाउनलोड लिंक प्रदान कर सके। इस तरह के लिंक को गुप्त / निजी ब्राउज़िंग के माध्यम से सबसे अच्छा परीक्षण किया जाता है; खोज पट्टी में लिंक चिपकाकर. यदि फ़ाइल डाउनलोड तुरंत शुरू होता है, तो लिंक स्वीकार्य है। यदि इसके बजाय, किसी भी प्रकार का वेब पेज प्रदर्शित किया जाता है, तो, लिंक का उपयोग फ़ाइलों को भेजने के लिए नहीं किया जा सकता है।

फ़ाइल होस्टिंग सेवा लिंक के साथ मामला यह है कि फ़ाइलें डाउनलोड नहीं की जा सकतीं। इसके बजाय जो डाउनलोड और भेजा जाता है, वह एक साझाकरण वेब पेज है, जिससे "दूषित" फ़ाइल हो सकती है।

यह, बदले में, आपके संदेश को प्रभावित करेगा क्योंकि प्राप्तकर्ता आपके द्वारा भेजे गए मीडिया तक नहीं पहुंच सकते हैं, जिससे फाइलें अनुपयोगी हो जाती हैं। इस प्रकार, यह महत्वपूर्ण है कि आप यह सुनिश्चित करें कि आप सीधे डाउनलोड लिंक भेज रहे हैं, क्योंकि यह उन्हें बिना किसी समस्या के फ़ाइल तक पहुंचने की अनुमति देगा।

आप अपने किसी टेस्ट नंबर पर वेहुक मैसेज भेजकर भी इस टेस्ट को चला सकते हैं। आप यह निर्धारित करने में सक्षम होंगे कि हमने यहां जो समीक्षा की है, उसके आधार पर फ़ाइल कैसे व्यवहार करेगी; यदि आपको "फ़ाइल दूषित है", "असंगत फ़ाइल" जैसा त्रुटि संदेश मिलता है; या "एक्स दस्तावेज़ लोड करने में विफल", अनुलग्नक पर क्लिक करने के बाद, तो यह एक फ़ाइल होस्टिंग सेवा लिंक है और इसे सीधे डाउनलोड लिंक के साथ प्रतिस्थापित किया जाना चाहिए।

ऋण का उपयोग

संदेश भेजने से संदेश भेजने के कोटे से 1 क्रेडिट की खपत होती है।
गैर-खाली पाठ और अनुलग्नक के साथ संदेश भेजना संदेश भेजने वाले कोटा से 2 क्रेडिट की खपत करता है।
यदि कोई संदेश नहीं भेजा जा सकता है (अमान्य या व्हाट्सएप नंबर, व्हाट्सएप सर्वर त्रुटि से जुड़ा नहीं है), तो संदेश भेजने का कोटा बहाल हो जाएगा (आमतौर पर कुछ घंटों के भीतर)।

संदेश भेजने की दर

संदेश प्रत्येक दो संदेशों के बीच लगभग 2 सेकंड की यादृच्छिक देरी के साथ भेजे जाएंगे (व्हाट्सएप स्पैम डिटेक्शन तंत्र से बचने के लिए)।
यदि आप 2 सेकंड से कम की आवृत्ति के साथ वेपहुक को सक्रिय करते हैं, तो संदेशों को कतार बद्ध किया जा सकता है और देरी से भेजा जा सकता है। प्रत्येक पंक्तिबद्ध संदेश क्रेडिट भेजने वाले संदेश का उपभोग करेगा, इसलिए पंक्तिबद्ध संदेशों की संख्या उपलब्ध कोटा से अधिक नहीं हो सकती है।

वेबहुक कॉन्फ़िगरेशन और क्रियाएँ

"वेपहुक सक्षम" - इसे पूरी तरह से हटाए बिना वेबहुक को अक्षम करने की अनुमति देता है
"नया URL जनरेट करें" - एक नया अद्वितीय URL बनाएगा, जो सूचनाओं को स्वीकार करेगा। पिछला URL अब उपलब्ध नहीं होगा.
"अंतिम भेजने के प्रयास" - अंतिम वेबहुक सक्रियण प्रयासों की स्थिति
"डाउनलोड लॉग" - 100 अंतिम सक्रियण प्रयासों का एक विस्तृत लॉग, स्वरूपण समस्याओं का निवारण करने में सहायक।

वेबहूक अनुरोध प्रारूप

वेबहुक पोस्ट अनुरोध के माध्यम से जेएसओएन प्रारूप में डेटा स्वीकार करता है।

"कार्रवाई" (अनिवार्य) - वर्तमान में, केवल एक संभावित मान "भेजें" समर्थित है
"पाठ" (अनिवार्य) - एक सादा पाठ यूटीएफ -8 एन्कोडेड संदेश भेजा जाना है ("एन" लाइन विभाजक को छोड़कर कोई मार्कडाउन समर्थित नहीं), खाली छोड़ा जा सकता है, यदि फ़ाइल निर्दिष्ट है।
"file_url" (वैकल्पिक) - एक फ़ाइल का सार्वजनिक रूप से सुलभ URL जिसे डाउनलोड किया जाएगा और अनुलग्नक के रूप में भेजा जाएगा।
"file_name" (वैकल्पिक) - अनुलग्नक के लिए एक नाम (यदि URL निर्दिष्ट किया गया है, तो प्रदान किया जाना चाहिए)।

प्राप्तकर्ता निम्न मापदंडों में से एक प्रदान करके निर्दिष्ट किया जा सकता है:

"chat_id" - चैट की एक आईडी जैसा कि टाइमलाइनएआई में दिखाई देता है (चैट पेज के यूआरएल में या आउटबाउंड वेबहुक के पेलोड में पाया जा सकता है)। यह किसी समूह को संदेश भेजने का समर्थन करता है.
"jid" - एक WhatsApp JID जो संपर्क या समूह निर्दिष्ट करता है
"फोन" - एक फोन नंबर, अंतरराष्ट्रीय फोन नंबर मानक के अनुसार स्वरूपित, यानी:
[+] [देश कोड] [क्षेत्र कोड] [स्थानीय फोन नंबर] (उदाहरण के लिए: +14151231234)
"chat_name" - चैट का एक सटीक नाम जैसा कि टाइमलाइनएआई में दिखाई देता है

यदि कार्यस्थान में एकाधिक WhatsApp खाते कनेक्ट हैं, तो उपयोग किए जाने वाले WhatsApp खाते निर्दिष्ट करने के लिए निम्न अतिरिक्त पैरामीटर का उपयोग करें:

"व्हाट्सएप अकाउंट फोन" (वैकल्पिक) - भेजने के लिए व्हाट्सएप अकाउंट (एक फोन नंबर के रूप में, अंतर्राष्ट्रीय प्रारूप में) निर्दिष्ट करता है। यदि छोड़ दिया जाता है, तो कार्यस्थान में सबसे हाल ही में कनेक्ट किए गए सक्रिय व्हाट्सएप खाते का उपयोग भेजने के लिए किया जाएगा। नोट: यदि "chat_id" पैरामीटर निर्दिष्ट किया गया है, तो "व्हाट्सएप अकाउंट फोन" की अवहेलना की जाएगी, क्योंकि प्रत्येक चैट पहले से ही एक विशिष्ट व्हाट्सएप खाते से जुड़ा हुआ है।

वेबहूक प्रतिक्रिया

सफलता के मामले में (अनुरोध को सत्यापित किया गया था और भेजने के लिए स्वीकार किया गया था), वेपहुक HTTP स्थिति 200 और JSON के साथ प्रतिक्रिया देगा, जिसमें बनाए गए संदेश का message_id शामिल है:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

त्रुटि के मामले में, वेपहुक त्रुटि के विवरण के साथ HTTP स्थिति 40X और JSON के साथ जवाब देगा, उदाहरण के लिए:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

उदाहरण

उदाहरण 1 - एक विशिष्ट WA खाते के माध्यम से एक विशिष्ट फ़ोन नंबर पर संदेश भेजना:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

उदाहरण 2 - आईडी द्वारा निर्दिष्ट चैट (या समूह) में पाठ और अनुलग्नक के साथ एक संदेश भेजना:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://150588669.v2.pressablecdn.com/logo.png",
"file_name" : "logo.png"
}

लेखक
हाल के पोस्ट

शासन

व्यवस्थापक द्वारा नवीनतम पोस्ट (सभी देखें)

हम आपकी किस प्रकार सहायता कर सकते हैं?