تسجيل رسائل WhatsApp في HubSpot من رقم Coexistence

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

عبر ثلاث مراحل. تسلّم Meta الرسالة إلى وجهة webhook التي حددتها للرقم، وهي هنا عقدة Webhook في n8n. يبحث سير العمل في HubSpot عن جهة اتصال برقم هاتف المرسل، وينشئ واحدة إن لم يجد تطابقًا. ثم ينشئ سجل communication بنص الرسالة ويربطه بتلك الجهة.

بنى HubSpot كائن Communications لهذه الحالة. فهو يمثل رسالة على WhatsApp أو LinkedIn أو SMS أُرسلت أو استُقبلت خارج HubSpot، ويظهر في الجدول الزمني للسجل مثل مكالمة أو بريد إلكتروني مسجّل. الخصائص المطلوبة هي نوع القناة، وhs_communication_logged_from بقيمة CRM، والنص، والمالك، والطابع الزمني.

لا يحتاج أي من هذا إلى تطبيق من سوق HubSpot. تستطيع عقدة HTTP Request في n8n إعادة استخدام بيانات اعتماد HubSpot التي أعددتها لعقدة HubSpot، والاستدعاء طلب POST واحد لكل رسالة.

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

هل تُسجَّل الرسائل المكتوبة من الهاتف أيضًا؟

نعم يمكن ذلك، وهذا ما يضيفه رقم Coexistence. عندما يرد أحد أعضاء الفريق من تطبيق WhatsApp Business، ترسل Meta نسخة صدى من تلك الرسالة الصادرة إلى وجهة webhook نفسها. وسير العمل الذي يعالج الرسائل الواردة ونسخ الصدى معًا يكتب طرفي المحادثة في الجدول الزمني، فيرى مندوب المبيعات عند فتح جهة الاتصال في HubSpot ما سأل عنه العميل وما ردّ به المتجر.

افصل المسارات بحسب حقل webhook. تصل الرسائل الواردة ضمن messages، وتصل ردود الهاتف ضمن smb_message_echoes. سجّل الأولى على أنها مستلمة والثانية على أنها مرسلة، فيُقرأ الجدول الزمني بترتيبه الصحيح.

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

ماذا عن قناة صندوق WhatsApp الواردة في HubSpot نفسه؟

هذا تكامل مختلف. صندوق المحادثات في HubSpot يربط رقم WhatsApp بـ HubSpot نفسه، وتنص قاعدة المعرفة لديه على أن الرقم يجب ألا يكون مرتبطًا بتكامل WhatsApp آخر. وهو متاح في Marketing Hub أو Service Hub بخطتي Professional وEnterprise.

أما الرقم المتصل عبر EasyCoexistence فيعمل بالاتجاه المعاكس: توجّه Meta خطافات الويب الخاصة به إلى عنوان URL تملكه أنت، ويستقبل HubSpot السجلات عبر واجهة برمجة التطبيقات (API) الخاصة به. يُرد على المحادثة من الهاتف أو من سير العمل لديك، ويكون HubSpot نظام السجل الذي يحفظ التاريخ مقابل جهة الاتصال أو الصفقة أو التذكرة.

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

كيف يطابق سير العمل المرسل مع جهة اتصال؟

برقم الهاتف بعد توحيد صيغته قبل البحث. ترسل Meta المرسل أرقامًا مع رمز الدولة ودون علامة زائد، مثل 14155550188. أما جهات الاتصال في HubSpot فتُكتب يدويًا، فقد يُخزَّن الشخص نفسه بصيغة +1 415 555 0188 أو (415) 555-0188.

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

عندما لا يُرجع البحث شيئًا، أنشئ جهة الاتصال باسم الملف الشخصي من حمولة webhook اسمًا أول، والرقم أرقامًا فقط في الحقلين. يمكن لأحد الفريق الدمج أو إعادة التسمية لاحقًا، والمحادثة مرتبطة بها أصلًا.

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

• تسجيل الرسائل الواردة فقط. يعرض الجدول الزمني حينها أسئلة بلا إجابات، لأن الردود المكتوبة على الهاتف تصل بوصفها أحداث smb_message_echoes.
• ترك hs_communication_logged_from دون قيمة. يشترط HubSpot أن تكون CRM عند إنشاء communication عبر API.
• البحث عن جهات الاتصال في حقل الهاتف الخام. صيغة Meta أرقامًا فقط نادرًا ما تطابق ما كتبه الشخص، وكل إخفاق في المطابقة ينشئ جهة اتصال مكررة.

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

تابع القراءة