ربط WhatsApp بجهات اتصال GoHighLevel على رقم Coexistence

كيف تصل رسالة WhatsApp إلى جهة اتصال في HighLevel؟

ترسل Meta كل رسالة تصل إلى الرقم إلى وجهة webhook التي حددتها، وهي هنا عقدة Webhook في n8n. يمرر سير العمل رقم المرسل واسم ملفه الشخصي في WhatsApp إلى عقدة HighLevel في n8n، وفي مورد جهات الاتصال لديها عملية إنشاء أو تحديث، فيصبح المرسل الجديد جهة اتصال ويُعثر على المرسل المعروف بدل تكرار سجله.

وبعد الحصول على معرّف جهة الاتصال، ترسل عقدة HTTP Request نص الرسالة إلى المسار /contacts/{contactId}/notes لتُنشأ الملاحظة. تظهر الملاحظة في سجل جهة الاتصال، فيرى كل من يفتحه ما كتبه العميل. وإذا استدعت الرسالة متابعة، تستطيع عقدة HighLevel أيضًا إنشاء مهمة على جهة الاتصال أو فرصة في مسار مبيعات، وكلاهما مدعوم مباشرة.

ويواصل الفريق الرد من تطبيق WhatsApp Business طوال الوقت.

أي رمز يجب أن يستخدمه سير العمل؟

رمز Private Integration. تتاح API v2 في HighLevel عبر OAuth أو عبر أحد هذه الرموز، أما مفاتيح API القديمة من الإصدار v1 فقد انتهى عمرها. يُنشأ الرمز من إعدادات الحساب الفرعي، ويقتصر على الصلاحيات التي تحددها، ويُرسل في ترويسة Authorization مثل أي رمز وصول.

لا يتجدد هذا الرمز من تلقاء نفسه، وهذا يناسب الأتمتة: يظل يعمل حتى يدوّره أحد. وعند تدويره يُبقي HighLevel الرمزين القديم والجديد صالحين معًا لمدة سبعة أيام، وهي المهلة المتاحة للصق الرمز الجديد في n8n قبل أن يتوقف القديم.

فعّل النطاقات التي يحتاجها سير العمل فقط: جهات الاتصال والملاحظات، وإن استخدمتها الفرص والمهام. وإذا لم تجد Private Integrations في الإعدادات، تنص وثائق HighLevel على تفعيلها من Labs أولًا.

كيف يخدم سير عمل واحد عدة حسابات فرعية للعملاء؟

بالتوجيه حسب الرقم المستقبِل. يتضمن كل webhook ترسله Meta قيمة phone_number_id لرقم النشاط التجاري الذي استقبل الرسالة. وجّه رقم كل عميل إلى webhook n8n نفسه، واحتفظ بجدول صغير يربط كل phone_number_id بالحساب الفرعي لذلك العميل ورمزه، وابحث عن الرمز في بداية كل تشغيل.

يعني هذا سير عمل واحدًا فقط للصيانة عبر كل العملاء، وهو أمر يهم الوكالات أكثر من غيرها. فأي إصلاح لمنطق المطابقة أو لشكل الملاحظة يصل إلى الجميع دفعة واحدة.

تُحتسب حدود الاستخدام لكل تطبيق ولكل حساب فرعي، فلا يستهلك العملاء حصص بعضهم: لكل منهم 100 طلب كل عشر ثوانٍ و200,000 طلب يوميًا.

هل تصل الردود المكتوبة على الهاتف إلى HighLevel؟

يمكن ذلك. في رقم Coexistence يبقى تطبيق WhatsApp Business قيد الاستخدام، وعندما يرد أحد منه ترسل Meta نسخة من الرسالة الصادرة إلى وجهة webhook نفسها، ضمن الحقل smb_message_echoes في الإشعار.

أضف فرعًا لهذه النسخ واكتبها كملاحظات معلّمة بأنها مُرسلة. عندها يحتوي سجل جهة الاتصال على كلام العميل وردود النشاط التجاري بالترتيب، وهذا ما يتوقع العميل رؤيته عند فتح نظام CRM الخاص به.

وعندما يرسل سير العمل نفسه رسالة عبر Cloud API، مثل قالب معتمد بعد حجز موعد، اكتب الملاحظة لحظة الإرسال، فسير العمل يملك النص ومعرّف جهة الاتصال أصلًا.

الأخطاء الشائعة

• استخدام مفتاح API من الإصدار v1. انتهى عمر API v1 في HighLevel، وتتطلب API v2 رمز Private Integration أو OAuth بدلًا من ذلك.
• تدوير رمز Private Integration دون تحديث n8n خلال مهلة الأيام السبعة. تفشل كل الاستدعاءات بمجرد انتهاء صلاحية الرمز القديم.
• كتابة رسائل كل العملاء برمز حساب فرعي واحد. اربط phone_number_id بالحساب الفرعي الصحيح أولًا، وإلا وصلت السجلات إلى العميل الخطأ.

الأسئلة الشائعة

تابع القراءة