Zoho CRM
اربط Zoho CRM بعميل OAuth من Zoho ومركز البيانات الصحيح ليستطيع الوكيل إنشاء العملاء المحتملين وإضافة الملاحظات.
ما الذي ستحققه
سيستطيع الوكيل إنشاء Lead في Zoho CRM وإضافة ملاحظات إلى السجلات.
نظرة عامة وحالات الاستخدام
- حفظ المتصلين كـ Leads في Zoho.
- إضافة ملاحظات المكالمات إلى Contact أو سجل آخر.
المتطلبات المسبقة
- حساب Zoho CRM، وصلاحية الوصول إلى API Console في Zoho لإنشاء عميل OAuth.
- معرفة أي مركز بيانات يوجد فيه حسابك:
comأوeuأوinأوcom.auأوjpأوca. وهو جزء من عنوان Zoho على الويب لديك.
إعداد الحساب الخارجي (في Zoho)
Zoho هي التي تتحكم في هذه الشاشات. دليل Zoho: OAuth overview.
- في API Console لدى Zoho (الخاصة بـمركز بياناتك)، أنشئ عميلًا قائمًا على الخادم.
- اضبط URI إعادة التوجيه (المصرَّح به) على الموجود في مربع Connect في Phynxa.
- انسخ Client ID وClient secret.
اربطه في Phynxa
- Integrations، Connect في Zoho CRM.
- أدخل Client ID وClient secret وData centre.
- تابع إلى Zoho ووافق. تعرض البطاقة Connected.
الأذونات والإعدادات
| Scope | السبب |
|---|---|
ZohoCRM.modules.ALL | قراءة السجلات وكتابتها في الوحدات |
ZohoCRM.settings.ALL | قراءة إعدادات الوحدات |
ZohoCRM.users.READ | قراءة المستخدمين |
توقّع Phynxa الطلبات بـ Zoho-oauthtoken (لا Bearer)، وتستخدم نطاق API الذي تعيده Zoho لمركز بياناتك. ويدوم رمز الوصول من Zoho ساعة واحدة وتجدده Phynxa.
استخدمه في مكالمة
| الإجراء | ما يفعله | يعمل |
|---|---|---|
| Create lead | ينشئ Lead. ويُملأ اسم العائلة أو الشركة الناقص بالقيمة "Unknown". | في الخلفية |
| Add note | يضيف ملاحظة؛ وإذا أُعطي معرّف جهة اتصال فتُربَط بذلك Contact. | في الخلفية |
| Fetch customer history | يسرد ملاحظات سجل. ويحتاج contact id؛ والبريد وحده يعيد "A contact_id is needed." | ينتظر |
| Update contact | يغيّر اسم جهة اتصال أو بريدها أو هاتفها أو شركتها؛ ولا يتغير إلا ما تعطيه. ويحتاج id جهة الاتصال من بحث في السجل. | في الخلفية |
| Create task | ينشئ مهمة متابعة لفريقك (subject وbody وdue_date اختياريان مثل 2026-11-02)، ويربطها بجهة اتصال عند إعطاء id الخاص بها. | في الخلفية |
| Create ticket | يفتح حالة دعم بـsubject وbody اختياري، ويربطها بجهة اتصال عند إعطاء id الخاص بها. | في الخلفية |
اختبره
Test connection، ثم اطلب من وكيل في Chat حفظ عميل محتمل وتحقق من وحدة Leads في Zoho.
النتيجة المتوقعة
يظهر Lead في Zoho CRM وتحسب البطاقة نجاحًا.
استكشاف الأخطاء
- invalid_client أو إعادة توجيه خاطئة. يجب أن يطابق URI إعادة التوجيه، ويجب إنشاء العميل في مركز البيانات نفسه الذي فيه حسابك.
- يفشل كل شيء بعد الربط. Data centre في Phynxa ليس مركز حسابك. استخدم Edit credentials وصحّحه.
- يعيد السجل خطأ بشأن معرّف. يحتاج سجل Zoho إلى معرّف لا يملكه الوكيل عادةً؛ فاعتمد على Create lead وAdd note مع Zoho.
الأمان وبيانات الاعتماد
يُخزَّن client secret مشفّرًا. وRemove ينساه؛ فاسحب إذن العميل في API Console إذا توقفت عن استخدامه.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.