Coexistence नंबर पर WhatsApp को Bitrix24 CRM से जोड़ें

n8n, Bitrix24 से कैसे बात करता है?

इनबाउंड वेबहुक के ज़रिए, जो Bitrix24 में रिसीवर नहीं, बल्कि एक क्रेडेंशियल है। आप इसे Bitrix24 के डेवलपर रिसोर्स में बनाते हैं, वे स्कोप चुनते हैं जिनका यह उपयोग कर सकता है, और आपको एक यूआरएल मिलता है जिसमें आपके पोर्टल का पता, इसे बनाने वाले यूज़र की id और एक सीक्रेट कोड होता है। उस यूआरएल के अंत में किसी मेथड का नाम जोड़ने से REST एपीआई उसी यूज़र के रूप में, उसी की अनुमतियों के साथ कॉल होती है।

इसलिए n8n में Bitrix24 का हर स्टेप एक HTTP अनुरोध नोड है, जो उस यूआरएल पर crm.lead.add.json जैसे मेथड के साथ पोस्ट करता है। पूरा करने के लिए कोई OAuth फ़्लो नहीं है और प्रकाशित करने के लिए कोई ऐप नहीं। वेबहुक को सिर्फ़ CRM स्कोप दें, और इसे ऐसे यूज़र से बनाएं जिसकी अनुमतियाँ उन लीड और कॉन्टैक्ट को कवर करती हों जो वर्कफ़्लो को देखने हैं, क्योंकि Bitrix24 पहुँच की जाँच उसी यूज़र के रूप में करता है।

वर्कफ़्लो Bitrix24 के कौन से मेथड कॉल करता है?

तीन, इसी क्रम में, जब n8n का Webhook नोड Meta से मैसेज पा चुका हो।

crm.duplicate.findbycomm, type PHONE और भेजने वाले के नंबर के साथ, उन सभी लीड, कॉन्टैक्ट और कंपनी की id लौटाता है जिनके पास वह नंबर है। यह सही लुकअप है क्योंकि यह तीनों में एक साथ खोजता है और टेक्स्ट फ़ील्ड के बजाय संपर्क जानकारी पर मिलान के लिए बना है।

कुछ न मिलने पर crm.lead.add एक लीड बनाता है, जिसके शीर्षक में WhatsApp प्रोफ़ाइल का नाम और फ़ोन फ़ील्ड में नंबर होता है। फिर crm.timeline.comment.add मैसेज का टेक्स्ट रिकॉर्ड पर कमेंट के रूप में लिखता है, जिसमें ENTITY_TYPE, ENTITY_ID और COMMENT दिए जाते हैं। यह कमेंट रिकॉर्ड की टाइमलाइन में कॉल और ईमेल के बगल में दिखता है, जहाँ सेल्सपर्सन पहले से देखता है।

POST https://yourcompany.bitrix24.com/rest/1/<secret>/crm.duplicate.findbycomm.json
{ "type": "PHONE", "values": ["14155550188"] }

POST .../crm.lead.add.json
{ "fields": { "TITLE": "WhatsApp: Maria", "PHONE": [{ "VALUE": "14155550188", "VALUE_TYPE": "MOBILE" }] } }

POST .../crm.timeline.comment.add.json
{ "fields": { "ENTITY_TYPE": "lead", "ENTITY_ID": 4211, "COMMENT": "do you have anything friday?" } }

रेट लिमिट वर्कफ़्लो को कैसे प्रभावित करती है?

Bitrix24 REST कॉल को लीकी बकेट से मापता है। हर अनुरोध एक काउंटर बढ़ाता है, काउंटर हर सेकंड एक तय दर से घटता है, और सीमा पार होने पर अगला अनुरोध QUERY_LIMIT_EXCEEDED के साथ 503 पाता है। Enterprise प्लान पर काउंटर हर सेकंड 5 घटता है और सीमा 250 है; बाकी सभी प्लान पर वह 2 घटता है और सीमा 50 है।

हर इनबाउंड मैसेज पर दो या तीन कॉल लगती हैं, इसलिए धीमा, लगातार आता प्रवाह सीमा के पास भी नहीं पहुँचता। बर्स्ट पहुँचता है: एक मिनट में पचास ग्राहक एक ही टेम्पलेट का जवाब दें तो 150 तक कॉल हो जाती हैं। HTTP अनुरोध नोड को विफल होने पर थोड़ी देर रुककर रीट्राई करने के लिए सेट करें, और वर्कफ़्लो के एक्ज़ीक्यूशन एक-एक करके चलाएं, ताकि बर्स्ट Bitrix24 से टकराकर लौटने के बजाय उसमें धीरे-धीरे खाली हो।

क्या फ़ोन से टाइप किए गए जवाब Bitrix24 तक पहुँचते हैं?

पहुँच सकते हैं। Coexistence नंबर पर WhatsApp Business ऐप काम करता रहता है, और जब कोई उससे जवाब देता है तो Meta भेजे गए मैसेज की एक इको उसी वेबहुक डेस्टिनेशन पर smb_message_echoes फ़ील्ड में भेजता है।

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

जो जवाब वर्कफ़्लो खुद Cloud API से भेजता है, वे भेजते समय पहले से वर्कफ़्लो के पास होते हैं, इसलिए उन्हें उसी क्षण लॉग करें, किसी वेबहुक के लौटने का इंतज़ार न करें।

आम गड़बड़ियाँ

• इनबाउंड वेबहुक यूआरएल को क्लाइंट-साइड कोड या साझा दस्तावेज़ में चिपकाना। उसमें मौजूद सीक्रेट वेबहुक को दिए गए हर स्कोप की पहुँच देता है।
• वेबहुक को ऐसे यूज़र से बनाना जो सभी लीड नहीं देख सकता। तब लुकअप में रिकॉर्ड छूट जाते हैं और वर्कफ़्लो डुप्लिकेट बना देता है।
• रीट्राई के बिना कॉल का बर्स्ट भेजना। Bitrix24 QUERY_LIMIT_EXCEEDED के साथ 503 लौटाता है और वे मैसेज टाइमलाइन तक कभी नहीं पहुँचते।

अक्सर पूछे जाने वाले सवाल

पढ़ना जारी रखें