دليل ربط واتساب بنظام CRM: 3 طرق للتكامل والمزامنة
شرح ربط واتساب بنظام CRM: الموصلات الجاهزة، أو الوسيط، أو الـ API والـ webhooks، مع تدفق البيانات وربط الحقول ومزامنة الموافقة وقائمة تساعدك على الاختيار.
بقلم OmniChannels.ai Editorial Team · مراجعة BroadNet Messaging Solutions Team
التكامل
الإجابة المختصرة
يربط تكامل واتساب مع نظام CRM واجهة WhatsApp Business API بنظام إدارة العملاء بحيث تُرتبط الرسائل الواردة وحالات التسليم والرسائل الصادرة بسجلات جهات الاتصال. توجد ثلاث طرق للبناء: موصّل جاهز، أو وسيط وأدوات أتمتة، أو API وwebhooks مباشرة. اختر بحسب حجم المنطق المطلوب، ومن سيتولى الصيانة، ومدى صرامة مزامنة الموافقة.
في هذه الصفحة
- ما المقصود بتكامل واتساب مع CRM؟
- ما الذي تحتاجه قبل أن تبدأ؟
- ما الطرق الثلاث لربط واتساب بنظام CRM؟
- كيف تتدفق البيانات؟ صورة خطوة بخطوة
- ما الحقول التي ينبغي ربطها بين واتساب وCRM؟
- كيف تزامن الموافقة بين واتساب وCRM؟
- كيف تجعل التكامل موثوقاً؟
- ما أنظمة CRM والأدوات التي نوثّقها؟
- هل يمكن لوكلاء الذكاء الاصطناعي العمل مع CRM وواتساب؟
- مثال تطبيقي: وكالة عقارات في جدة
- ما الأخطاء التي ينبغي تجنبها؟
- كيف تساعدك OmniChannels.ai
أهم النقاط
- يعني ربط واتساب بنظام CRM تدفقين للبيانات: النظام يطلق الرسائل الصادرة عبر API، وتعود الرسائل الواردة وحالات التسليم عبر webhook لتحديّث جهة الاتصال.
- الطرق الثلاث هي الموصّل الجاهز (الأسرع والأقل مرونة)، والوسيط أو أدوات الأتمتة (متوازن)، والـ API مع الـ webhooks مباشرة (أكبر تحكم ويحتاج مطورين).
- طابِق الأشخاص برقم هاتف موحَّد بصيغة E.164 لا بالاسم، واحفظ مصدر الموافقة ووقتها كحقول في CRM.
- قد تصل أحداث الـ webhook مرتين أو بترتيب مختلف، لذا احفظ الحدث الخام، وأكّد الاستلام بسرعة، وعالجه بشكل غير متزامن مع إزالة التكرار.
- الرسائل التي تبدؤها الشركة خارج نافذة خدمة العملاء البالغة 24 ساعة تتطلب قوالب معتمدة، لذا يجب أن يتتبع CRM وقت آخر رسالة واردة.
هذا الدليل موجَّه إلى فرق عمليات المبيعات ومسؤولي أنظمة CRM والمطورين الذين يريدون أن تعيش محادثات واتساب ورسائله داخل نظام CRM. يشرح الطرق الثلاث للربط، والبيانات التي ينبغي أن تنتقل في كل اتجاه، وقواعد الموافقة والموثوقية التي تغفل عنها معظم المشاريع.
ما المقصود بتكامل واتساب مع CRM؟
تكامل واتساب مع CRM هو ربط بين WhatsApp Business API ونظام CRM بحيث تُلحق الرسائل وحالات التسليم والموافقة بجهة الاتصال أو العميل المحتمل أو التذكرة الصحيحة.
وهو يتضمن دائماً تدفقين:
- الصادر: يطلق حدث في CRM (إرسال نموذج، أو مرحلة صفقة، أو تاريخ) رسالة واتساب عبر API.
- الوارد: تُدفع ردود العملاء وحالات التسليم عبر webhook، وتُطابق مع جهة اتصال وتُكتب في CRM.
لا تخلط بينه وبين أداة جانبية تعرض المحادثات فقط. القيمة تأتي من التدفقين مع مطابقة نظيفة لجهات الاتصال. ولمعرفة آلية الـ webhooks بالتفصيل اقرأ كيف تربط نظام CRM بصندوق وارد متعدد القنوات عبر webhooks.
ما الذي تحتاجه قبل أن تبدأ؟
تحتاج إلى رقم على WhatsApp Business API، وقوالب معتمدة للرسائل التي تبدؤها الشركة، ونظام CRM يستطيع استدعاء API أو تشغيل webhooks، وعملية موثقة للموافقة.
قائمة التحقق:
- رقم مسجّل على WhatsApp Business Platform (لا تطبيق Business المجاني؛ راجع الـ API مقابل تطبيق Business). راجع كيف تُعدّ WhatsApp Business API وقائمة الجاهزية.
- قوالب معتمدة للرسائل التي سيطلقها CRM، في الفئة الصحيحة.
- أرقام هواتف مخزنة بصيغة E.164 (رمز الدولة، دون مسافات أو أصفار بادئة).
- سجل موافقة (opt-in) لكل جهة اتصال.
- مسؤول عن التكامل وقناة تنبيه للأعطال.
ما الطرق الثلاث لربط واتساب بنظام CRM؟
يمكنك استخدام موصّل جاهز، أو وسيط وأدوات أتمتة، أو API وwebhooks مباشرة. وهي تبادل السرعة بالتحكم.
| موصّل جاهز | وسيط أو أداة أتمتة | API وwebhooks مباشرة | |
|---|---|---|---|
| ما هو | تطبيق جاهز أو ميزة مدمجة تربط مزود المراسلة بـ CRM | أداة سير عمل مرئية (مثل Zapier أو Make أو n8n) بين CRM والـ API | شيفرتك الخاصة التي تستدعي REST API وتستقبل الـ webhooks |
| سرعة البدء | الأسرع | سريع | الأبطأ |
| المرونة | محدودة بما يتيحه الموصّل | عالية للتدفقات المعتادة | الأعلى |
| من يتولى الصيانة | مزود الموصّل | محلل أعمال | مطوروك |
| الحد المعتاد | ربط حقول ثابت؛ وقد لا يغطي كل قناة أو كائن مخصص | حدود المهام والتأخير وعدد مرات التشغيل في الأداة | يحتاج وقتاً هندسياً ومراقبة واختبارات |
| الأنسب لـ | الاحتياجات القياسية على CRM مدعوم | الفرق بلا مطورين؛ والنماذج الأولية | المنطق المعقد، والحجم الكبير، وقواعد الموافقة الصارمة |
احذر من أي ادعاء بأن الموصّل «يعمل ببساطة». اسأل ماذا يفعل حين يصل webhook مرتين، وماذا يفعل حين يطابق رقم واحد جهتي اتصال، وكيف تُفحص الموافقة.
ملاحظة عن نهجنا: تتكامل OmniChannels.ai عبر REST API والـ webhooks وأدوات الأتمتة، وتذكر صفحات التكامل لدينا صراحةً أنه لا يوجد تطبيق في متجر التطبيقات لأنظمة CRM هذه.
أي طريقة تختار؟
- إذا كان لدى CRM موصّل يغطي حالتك وحقول الموافقة، فابدأ به.
- إذا احتجت محفزات وتحديثات حقول بلا شيفرة مخصصة، فاستخدم وسيطاً.
- إذا احتجت منطقاً مخصصاً أو حجماً كبيراً أو قابلية للتدقيق، فاستخدم الـ API مباشرة، ولو بوسيط كخطوة انتقالية.
- أياً اخترت، اختبر أولاً على أرقامك الموثقة.
كيف تتدفق البيانات؟ صورة خطوة بخطوة
يسير التدفق بالتسلسل التالي.
الصادر
- يعمل سير عمل في CRM (مثلاً عميل محتمل جديد وافق على المراسلة).
- يفحص سير العمل أو الوسيط الموافقة ووقت آخر رسالة واردة.
- يستدعي واجهة المراسلة برقم جهة الاتصال بصيغة E.164 وقالب معتمد، أو برسالة حرة إذا كانت نافذة الـ 24 ساعة مفتوحة.
- تعيد الواجهة معرّف الرسالة، فتحفظه في الجدول الزمني لجهة الاتصال.
الوارد والحالات 5. يسلّم واتساب رد العميل إلى المنصة، فتدفع حدثاً إلى عنوان الـ webhook لديك. 6. تحفظ نقطتك الجسم الخام، وترد بـ 2xx، وتضع الحدث في طابور. 7. يطابق عامل المعالجة رقم المرسل مع جهة اتصال، وينشئ واحدة إن سمحت العملية، ويسجل الرسالة. 8. تحدّث أحداث الحالة (SUBMITTED وSENT وDELIVERED وREAD وFAILED وREJECTED بصيغتنا الموحدة) الرسالة المخزنة، ولا تُرجع الحالة إلى الوراء أبداً. 9. تُطلق القواعد: إسناد مالك، أو إنشاء مهمة، أو نقل مرحلة صفقة، أو وسم جهة الاتصال.
تصف Meta الـ webhook الخاص برسائل واتساب بأنه يغطي الرسائل الواردة من المستخدمين وحالة الرسائل التي أرسلتها. وتغطي وثائق الـ webhooks لدينا حالات التسليم وإعادة المحاولة وما يجب فعله عند فقدان الأحداث. تختلف حقول الحمولة بحسب القناة، لذا سجّل الأحداث الخام واربط الحقول من عينات حقيقية من حسابك.
ما الحقول التي ينبغي ربطها بين واتساب وCRM؟
اربط مجموعة صغيرة من المعرّفات الثابتة وحقول الحالة، وأبقِ محتوى الرسائل خارج CRM ما لم تحتجه.
| حقل CRM (مقترح) | المصدر | الاتجاه | ملاحظات |
|---|---|---|---|
| الهاتف المحمول (E.164) | CRM أو نموذج | CRM ← API | وحّد الصيغة قبل الإرسال؛ وتحقق بعمليات البحث عند الحاجة |
| موافقة واتساب (نعم/لا/مسحوبة) | التقاط الموافقة | CRM هو المرجع | افحصه قبل كل إرسال تسويقي |
| مصدر الموافقة ووقتها | نموذج أو QR أو محادثة أو خانة اختيار | CRM | احتفظ بالصياغة التي عُرضت على العميل |
| اللغة المفضلة | CRM | CRM ← API | تحدد لغة القالب |
| وقت آخر رسالة واردة | Webhook | API ← CRM | تخبرك هل نافذة الـ 24 ساعة مفتوحة |
| حالة آخر رسالة | Webhook | API ← CRM | تحديثات في اتجاه واحد للأمام فقط |
| معرّف الرسالة | استجابة API | API ← CRM | لازم لمطابقة الحالات مع عناصر الجدول الزمني |
| رابط المحادثة | صندوق الوارد | API ← CRM | يتيح للمندوب فتح المحادثة بنقرة |
| المالك أو الموظف المسند | CRM أو صندوق الوارد | الاتجاهان | حدّد أي النظامين يغلب عند التعارض |
| مرحلة دورة الحياة أو الوسوم | CRM | CRM ← صندوق الوارد | يتيح للموظفين رؤية سياق الصفقة |
أنشئ هذه الحقول كخصائص مخصصة منذ البداية؛ فتغيير أنواع الحقول بعد الإطلاق مؤلم.
كيف تزامن الموافقة بين واتساب وCRM؟
اعتبر CRM المرجع الرسمي للموافقة (opt-in) وافحصه قبل كل رسالة تسويقية تبدؤها الشركة. تسمح سياسة واتساب للأعمال بمراسلة الأشخاص فقط إذا قدّموا رقمهم ووافقوا على سماع أخبارك، وتتوقع منك احترام طلبات الحظر أو التوقف أو إلغاء الاشتراك.
مجموعة قواعد عملية:
- التقط الموافقة ببيان واضح لما سيتلقاه الشخص وعلى أي قناة.
- خزّن الموافقة لكل قناة، مع المصدر والوقت والصياغة.
- حدّث الموافقة فوراً عند رسالة إلغاء الاشتراك أو الحظر.
- اجعل خطوة الإرسال تقرأ الحقل، لا قائمة مخزنة مؤقتاً.
- افصل محادثات الخدمة (الرد على رسالة العميل نفسه) عن الإرسال التسويقي.
اقرأ الموافقة المسبقة في الحملات متعددة القنوات وولّد الصياغة بـمولّد صيغ الموافقة.
كيف تجعل التكامل موثوقاً؟
أكّد استلام الـ webhooks بسرعة، واحفظ قبل المعالجة، واجعل المعالجة آمنة عند التكرار (idempotent).
- احفظ، ثم أكّد، ثم عالج. الاستدعاءات البطيئة لـ CRM داخل المعالج تسبب إعادة محاولات وتكراراً.
- أزل التكرار بحسب معرّف الرسالة؛ وتعامل مع الحدث نفسه مرتين على أنه لا يستلزم إجراءً.
- توقع أحداثاً غير مرتبة. حدث SENT متأخر يجب ألا يطمس DELIVERED.
- حدّد معدل استدعاءات CRM وتراجع عند الأخطاء.
- طابق جهات الاتصال بأمان. وحّد الأرقام، وتعامل عمداً مع جهتي اتصال بالرقم نفسه، ولا تدمج بالاسم وحده أبداً.
- لا تُعد الإرسال من معالج الـ webhook. قرر إعادة المحاولات في مهمة منفصلة بعد فحص الحالة.
- أمّن نقطة الاستقبال. استخدم HTTPS ومساراً يصعب تخمينه والتحقق من شكل الجسم. توثق Meta استخدام mTLS لـ webhooks الخاصة بها؛ أما لدينا فراجع صفحة الـ webhooks.
- راقب. نبّه عند فشل الـ webhooks وعمق الطابور وانخفاض الأحداث الواردة.
ما أنظمة CRM والأدوات التي نوثّقها؟
نوثّق أنماطاً لعدة أنظمة في صفحات التكامل لدينا. لا يصف أي منها تطبيقاً في متجر تطبيقات؛ كل صفحة تشرح كيفية استخدام REST API والـ webhooks مع ذلك المنتج.
| النظام | النمط المعتاد | الصفحة |
|---|---|---|
| HubSpot | شيفرة مخصصة في سير العمل أو إجراء webhook، أو أداة أتمتة | HubSpot |
| Salesforce | استدعاء HTTP من Flow أو استدعاء Apex مع Named Credential | Salesforce |
| Zoho CRM | webhook في سير العمل أو دالة Deluge | Zoho CRM |
| Microsoft Dynamics 365 | تدفق Power Automate | Dynamics 365 |
| Zendesk | webhook يطلقه Trigger؛ وأداة أتمتة للردود | Zendesk |
| Freshdesk | webhook لقاعدة أتمتة؛ وأداة أتمتة للردود | Freshdesk |
| أدوات الأتمتة | Zapier وMake وn8n | Zapier وMake وn8n |
تعتمد الإجراءات المتاحة داخل CRM على باقتك لدى ذلك المزود، فتأكد من وثائقه.
هل يمكن لوكلاء الذكاء الاصطناعي العمل مع CRM وواتساب؟
نعم، إذا منحت الوكيل أدوات خاضعة للتحكم. Model Context Protocol (MCP) معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي استدعاء أدوات خارجية. يتيح خادم MCP لدينا واجهة المراسلة (الإرسال والقوالب وتقارير التسليم) لعملاء MCP بصلاحيات الرمز الذي تقدمه؛ أما قراءة سجلات CRM أو تحديثها فتحتاج إلى موصّل تتحكم به. ابدأ بعمليات بحث للقراءة فقط، وأضف إجراءات الكتابة واحداً بعد الآخر، وسجّل كل شيء. راجع دليل خادم MCP لواتساب ووكلاء الذكاء الاصطناعي لخدمة العملاء.
مثال تطبيقي: وكالة عقارات في جدة
«ريد سي هومز» وكالة افتراضية تريد أن يحصل كل استفسار عقاري على رد عبر واتساب، وأن تظهر كل محادثة في سجل العميل المحتمل.
- استفسار من بوابة عقارية ينشئ عميلاً محتملاً برقم هاتف بصيغة E.164 وخانة موافقة من النموذج.
- يفحص سير العمل الموافقة، ثم يرسل قالب Utility معتمداً يقرّ باستلام الاستفسار، ويحفظ معرّف الرسالة.
- يرد العميل؛ فيحدّث الـ webhook «وقت آخر رسالة واردة» ويسند مالك العميل المحتمل.
- يرد المالك لمدة 24 ساعة من صندوق الوارد برسائل حرة. وبعد الصمت تكون المتابعة التالية قالباً معتمداً ومصنفاً وبموافقة.
- تغيّر المرحلة إلى «تم حجز المعاينة» يرسل قالب تذكير قبل يوم.
- أسبوعياً، يراجع الفريق عمليات الإرسال الفاشلة والأرقام غير المتطابقة.
راجع متابعة العملاء المحتملين العقاريين على واتساب لجانب المراسلة.
ما الأخطاء التي ينبغي تجنبها؟
- مطابقة جهات الاتصال بالأسماء أو بأرقام غير موحدة الصيغة.
- تخطي حقل الموافقة والاعتماد على الذاكرة.
- المعالجة داخل معالج الـ webhook ثم انتهاء المهلة.
- إرسال محتوى تسويقي داخل قالب مصنف Utility؛ فMeta هي التي تقرر الفئة.
- نسيان أنه خارج نافذة الـ 24 ساعة لا يمكن إرسال غير القوالب.
- ترك النظامين يعدلان الحقل نفسه دون قاعدة لمن تكون الغلبة.
- غياب التنبيهات، فيمر webhook معطل أسابيع دون أن يلحظه أحد.
كيف تساعدك OmniChannels.ai
تقدم OmniChannels.ai، المدعومة من BroadNet Technologies، واجهة REST/JSON وwebhooks لحالات التسليم، و Omni Inbox لمحادثات الموظفين، وخادم MCP لوكلاء الذكاء الاصطناعي. BroadNet مزود حلول أعمال رسمي لدى Meta (Meta Business Solution Provider)، ويتولى فريقنا تهيئة واتساب والتسجيلات معك. يستطيع المطورون البدء من وثائق الـ API ودليل WhatsApp API؛ ويقتصر الوصول التجريبي على أرقامك الموثقة، ولا يوجد تسجيل ذاتي فوري.
الأسئلة الشائعة
ما المقصود بتكامل واتساب مع CRM؟
هو ربط بين WhatsApp Business API ونظام CRM بحيث تُنسب المحادثات وحالات الرسائل والموافقة إلى جهة الاتصال أو العميل المحتمل الصحيح. غالباً يطلق CRM الرسائل الصادرة من سير العمل، وتعيد الـ webhooks الرسائل الواردة وحالات التسليم لتحديّث السجلات والجداول الزمنية. أما تطبيق WhatsApp Business وحده فلا يوفر اتصال API كهذا.
هل أستطيع ربط تطبيق WhatsApp Business بنظام CRM؟
عموماً لا. تعمل تكاملات CRM عبر WhatsApp Business Platform، وهي واجهة API التي يستخدمها مزودو حلول الأعمال، لا عبر تطبيق Business المجاني. تسجّل رقماً على المنصة، وهذا يغيّر طريقة استخدامه. راجع مقارنتنا بين الـ API والتطبيق قبل نقل رقم يستخدمه الموظفون حالياً على هاتف.
ما أنظمة CRM التي يمكن ربطها بواتساب؟
أي نظام CRM يستطيع استدعاء HTTP API أو تشغيل webhooks يمكنه الاتصال بـ WhatsApp Business API، مباشرة أو عبر أداة أتمتة. نوثّق أنماط HubSpot وSalesforce وZoho CRM وMicrosoft Dynamics 365 وZendesk وFreshdesk في صفحات التكامل لدينا. وتوفّر الإجراءات المدمجة تعتمد على اشتراكك في النظام، فتحقق من باقتك.
هل أحتاج إلى مطور لربط واتساب بنظام CRM؟
ليس دائماً. المحفزات البسيطة، مثل إرسال قالب عند تغيّر مرحلة الصفقة، يمكن تشغيلها في أداة أتمتة أو سير عمل CRM. تحتاج إلى مطور لمنطق الحقول المخصص، والمزامنة باتجاهين مع إزالة التكرار، وفحوص الموافقة، وإعادة المحاولة، وكل ما يجب أن يتوسع. خطّط للمراقبة في الحالتين، فالتكاملات تفشل بصمت ما لم تكن هناك تنبيهات.
كيف أدير الموافقة على تلقي الرسائل (opt-in) في CRM؟
احفظ حقل موافقة لكل قناة، مع المصدر والوقت والصياغة التي عُرضت على العميل. افحصه قبل كل إرسال تسويقي، وحدّثه فوراً عند انسحاب الشخص. تسمح سياسة واتساب للأعمال بمراسلة الأشخاص فقط إذا قدّموا رقمهم ووافقوا على التواصل، لذا ينبغي أن يكون CRM المرجع الرسمي لهذه الحالة.
هل يستطيع وكيل ذكاء اصطناعي قراءة CRM وتحديثه من واتساب؟
يستطيع وكيل الذكاء الاصطناعي استخدام أدوات للبحث عن السجلات وتحديثها إذا ربطته بأنظمتك، مثلاً عبر Model Context Protocol (MCP). امنحه صلاحيات ضيقة، وسجّل كل إجراء، وأبقِ مساراً إلى موظف بشري. يتيح خادم MCP لدينا واجهة المراسلة لعملاء MCP؛ أما إجراءات CRM فتحتاج إلى موصّل تتحكم به أنت.
المصادر
تابع القراءة
مزيد من الأدلةالتكامل
دليل webhooks واتساب: الأحداث والأمان وإعادة المحاولة
كيف تعمل webhooks واتساب: أحداث الرسائل والحالات، ومعالج موثوق، والتحقق من توقيع Meta، وإعادة المحاولة، وعدم التكرار، والاسترداد عند فقدان الأحداث.
10 دقائق للقراءة
التكامل
كيف تربط نظام CRM بصندوق وارد متعدد القنوات باستخدام webhooks؟
اربط نظام CRM بصندوق وارد متعدد القنوات عبر webhooks: الأحداث التي تُزامَن، وعدم التكرار (idempotency)، وإعادة المحاولة، ومطابقة جهات الاتصال، وخصوصية البيانات.
8 دقائق للقراءة
واتساب
رموز أخطاء WhatsApp Cloud API: معانيها وطرق إصلاحها
أكثر رموز أخطاء WhatsApp Cloud API شيوعًا، من 131047 و131026 إلى 132001 و130429: معنى كل رمز، وطريقة إصلاحه، ومتى لا يجوز إعادة المحاولة.
8 دقائق للقراءة