ربط WhatsApp بـ Zoho CRM على رقم Coexistence

كيف تتحول رسالة WhatsApp إلى سجل في Zoho CRM؟

ترسل Meta كل رسالة تصل إلى الرقم إلى وجهة webhook التي حددتها، وهي هنا عقدة Webhook في n8n. يأخذ سير العمل رقم المرسل من الحمولة ويستدعي نقطة النهاية (endpoint) الخاصة بالبحث في Zoho مع تعيين phone إلى هذا الرقم، وذلك في وحدتي Leads وContacts على التوالي. يفحص Zoho كل حقول الهاتف في الوحدة، فيُحتسب التطابق على Mobile أو Phone، ولا تحتاج إلى تخمين الحقل الذي استخدمه مندوب المبيعات.

عندما لا تأتي أي نتيجة، تنشئ عقدة Zoho CRM في n8n سجل Lead باسم الملف الشخصي في WhatsApp ورقم المرسل. وفي الحالتين صار لدى سير العمل معرّف سجل، فيكتب الرسالة كملاحظة على ذلك السجل عبر POST /Notes. لا تحتاج الملاحظة إلا إلى Note_Content وParent_Id الذي يسمّي الوحدة والسجل.

{
  "data": [
    {
      "Note_Title": "WhatsApp, inbound",
      "Note_Content": "do you have anything friday?",
      "Parent_Id": {
        "module": { "api_name": "Leads" },
        "id": "4876876000000624001"
      }
    }
  ]
}

ما أذونات Zoho التي تحتاجها بيانات اعتماد n8n؟

القراءة والإنشاء على الوحدات التي تبحث فيها وتكتب إليها، إضافة إلى الإنشاء على Notes. يسمّي Zoho نطاق الملاحظات ZohoCRM.modules.notes.CREATE ويشترط نطاق الإنشاء للوحدة الأم بجانبه، لذلك تفشل في الخطوة الأخيرة بخطأ تفويض أي بيانات اعتماد تستطيع إنشاء Leads دون أن تُمنح نطاق الملاحظات.

تغطي عقدة Zoho CRM في n8n الوحدات Leads وContacts والحسابات والصفقات وعدة مستندات مبيعات، مع الإنشاء والإنشاء أو التحديث والجلب وجلب الكل والتحديث والحذف. الملاحظات ليست ضمن مواردها، ولهذا تمر الملاحظة عبر عقدة HTTP Request. تتيح n8n لهذه العقدة إعادة استخدام بيانات اعتماد Zoho المتصلة بالفعل، فيكون لديك تفويض OAuth واحد تديره بدلاً من اثنين.

اضبط نطاق API على مركز بيانات Zoho الخاص بك. إذا أُنشئت بيانات الاعتماد في منطقة الاتحاد الأوروبي، فاستخدم zohoapis.eu بدل zohoapis.com في كل استدعاء.

كم رسالة يستوعب Zoho CRM؟

يقيس Zoho استخدام API بالأرصدة لكل 24 ساعة متجددة، وتعتمد الميزانية على الإصدار وعدد المستخدمين. يحصل إصدار Free على 5,000. أما Standard فيحصل على 50,000 مضافاً إليها 250 لكل مستخدم، وProfessional على 50,000 مضافاً إليها 500 لكل مستخدم، وEnterprise على 50,000 مضافاً إليها 1,000 لكل مستخدم، ولكل إصدار حد أقصى.

تكلّف كل رسالة واردة عملية بحث وكتابة ملاحظة، إضافة إلى إنشاء Lead للمرسلين لأول مرة. وهذا يقع براحة ضمن ميزانية إصدار مدفوع لرقم نشاط تجاري صغير. أما الحد الذي يظهر أولاً فهو عادة التزامن: يسمح Free بـ 5 استدعاءات متزامنة وStandard بـ 10، لذلك قد تصطف دفعة الرسائل الناتجة عن الرد على بث جماعي. اضبط سير عمل n8n على معالجة التنفيذات واحداً تلو الآخر إذا رأيت Zoho يعيد أخطاء الحد.

هل تصل الردود المرسلة من الهاتف إلى Zoho CRM؟

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

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

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

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

• منح بيانات الاعتماد نطاقات Leads دون نطاق ZohoCRM.modules.notes.CREATE، فينجح البحث وإنشاء Lead ثم تفشل كل ملاحظة.
• استدعاء zohoapis.com من حساب في مركز بيانات Zoho آخر. استخدم نطاق API الخاص بالمنطقة التي يوجد فيها الحساب.
• البحث في Leads فقط. العملاء المحوّلون يصبحون Contacts، وكل واحد منهم يراسلك يتحول إلى Lead مكرر جديد.

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

تابع القراءة