Coexistence نمبر پر WhatsApp کو Bitrix24 CRM سے جوڑیں

n8n، Bitrix24 سے کیسے بات کرتا ہے؟

ان باؤنڈ ویب ہک کے ذریعے، جو Bitrix24 میں میسج وصول کرنے والا اینڈ پوائنٹ نہیں بلکہ ایک اسناد ہے۔ آپ اسے Bitrix24 کے ڈیولپر ریسورسز میں بناتے ہیں، وہ اسکوپس چنتے ہیں جو یہ استعمال کر سکے، اور آپ کو ایک URL ملتا ہے جس میں آپ کے پورٹل کا پتا، بنانے والے صارف کی آئی ڈی اور ایک خفیہ کوڈ ہوتا ہے۔ اس URL کے آخر میں میتھڈ کا نام جوڑنے سے REST API اسی صارف کے طور پر، اسی کی اجازتوں کے ساتھ کال ہوتی ہے۔

اس لیے n8n میں Bitrix24 کا ہر مرحلہ ایک HTTP درخواست نوڈ ہوتا ہے جو اس URL اور crm.lead.add.json جیسے میتھڈ پر POST کرتا ہے۔ نہ OAuth کا کوئی مرحلہ ہے اور نہ کوئی ایپ پبلش کرنی پڑتی ہے۔ ویب ہک کو صرف CRM اسکوپ دیں، اور اسے ایسے صارف سے بنائیں جس کی اجازتیں ان لیڈز اور کانٹیکٹس تک پہنچتی ہوں جو ورک فلو کو دیکھنے ہیں، کیونکہ Bitrix24 رسائی اسی صارف کے حساب سے جانچتا ہے۔

ورک فلو Bitrix24 کے کون سے میتھڈز کال کرتا ہے؟

تین، اسی ترتیب سے، جب n8n کا ویب ہک نوڈ Meta سے میسج وصول کر لے۔

crm.duplicate.findbycomm کو type PHONE اور بھیجنے والے کے نمبر کے ساتھ کال کریں تو یہ ان تمام لیڈز، کانٹیکٹس اور کمپنیوں کی آئی ڈیز لوٹاتا ہے جن کے پاس یہ نمبر ہے۔ یہی درست تلاش ہے کیونکہ یہ تینوں میں ایک ساتھ ڈھونڈتی ہے اور عام ٹیکسٹ فیلڈ کے بجائے رابطے کی تفصیل پر ملان کے لیے بنی ہے۔

کچھ نہ ملے تو 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 کالز کو لیکی بکٹ سے ناپتا ہے۔ ہر درخواست کاؤنٹر بڑھاتی ہے، کاؤنٹر ہر سیکنڈ ایک مقررہ رفتار سے گھٹتا ہے، اور حد پار ہونے پر اگلی درخواست کو 503 اور QUERY_LIMIT_EXCEEDED ملتا ہے۔ Enterprise پلانز پر کاؤنٹر ہر سیکنڈ 5 سے گھٹتا ہے اور حد 250 ہے، باقی تمام پلانز پر یہ 2 سے گھٹتا ہے اور حد 50 ہے۔

ہر آنے والے میسج پر دو یا تین کالز لگتی ہیں، اس لیے آہستہ آہستہ آنے والے میسجز کبھی حد کے قریب نہیں پہنچتے۔ اچانک ہجوم پہنچتا ہے: ایک ہی ٹیمپلیٹ کا جواب ایک منٹ میں پچاس گاہک دیں تو یہ 150 کالز تک بنتی ہیں۔ HTTP درخواست نوڈز کو ناکامی پر مختصر وقفے کے ساتھ دوبارہ کوشش پر رکھیں، اور ورک فلو کی ایگزیکیوشنز ایک ایک کر کے چلائیں، تاکہ ہجوم Bitrix24 میں آہستہ آہستہ اترے اور واپس نہ ٹکرائے۔

کیا فون سے ٹائپ کیے گئے جوابات Bitrix24 تک پہنچتے ہیں؟

پہنچ سکتے ہیں۔ Coexistence نمبر پر WhatsApp Business ایپ چلتی رہتی ہے، اور جب کوئی اس سے جواب دیتا ہے تو Meta اسی ویب ہک منزل پر بھیجے گئے میسج کی ایک echo بھیجتا ہے، فیلڈ smb_message_echoes کے تحت۔

ورک فلو کی دوسری شاخ ان echoes کو آنے والے میسجز کی طرح سنبھالتی ہے، بس کمنٹ پر جانے والے کا نشان لگ جاتا ہے۔ یوں ریکارڈ میں پوری گفتگو ترتیب سے نظر آتی ہے، گاہک کی باتیں بھی اور دکان کے جوابات بھی۔

جو جوابات ورک فلو خود Cloud API سے بھیجتا ہے وہ بھیجتے وقت پہلے ہی ورک فلو کے پاس ہوتے ہیں، اس لیے انہیں ویب ہک کے واپس آنے کا انتظار کیے بغیر اسی لمحے لاگ کریں۔

عام غلطیاں

• ان باؤنڈ ویب ہک URL کو کلائنٹ سائیڈ کوڈ یا مشترکہ دستاویز میں پیسٹ کرنا۔ اس میں موجود خفیہ کوڈ ویب ہک کو دیے گئے ہر اسکوپ کی رسائی دے دیتا ہے۔
• ویب ہک کو ایسے صارف سے بنانا جو تمام لیڈز نہیں دیکھ سکتا۔ تب تلاش میں ریکارڈ چھوٹ جاتے ہیں اور ورک فلو ڈپلیکیٹس بنا دیتا ہے۔
• دوبارہ کوشش کے بغیر کالز کا ہجوم بھیجنا۔ Bitrix24 جواب میں 503 QUERY_LIMIT_EXCEEDED دیتا ہے اور وہ میسجز ٹائم لائن تک کبھی نہیں پہنچتے۔

اکثر پوچھے جانے والے سوالات

مزید پڑھیں