Salesforce

اربط Salesforce بتطبيق OAuth الخاص بك ليستطيع الوكيل إنشاء العملاء المحتملين وإرفاق الملاحظات وقراءة النشاط أثناء المكالمة.

ما الذي ستحققه

سيستطيع الوكيل إنشاء Lead في Salesforce، وإرفاق ملاحظة بسجل، وقراءة النشاط الأخير.

نظرة عامة وحالات الاستخدام

تحويل كل متصل جديد إلى Lead في Salesforce.
إرفاق ملاحظة مكالمة بسجل.
البحث عمّا سُجّل لجهة اتصال بحسب البريد الإلكتروني.

المتطلبات المسبقة

مؤسسة Salesforce تستطيع فيها إنشاء تطبيق OAuth (Connected App أو External Client App)، وعادةً يكون المسؤول.
لاستخدام sandbox، مضيف تسجيل الدخول الخاص به.

إعداد الحساب الخارجي (في Salesforce)

Salesforce هي التي تتحكم في هذه الشاشات. مرجع Salesforce: REST API resources.

في Setup، أنشئ تطبيق OAuth بعنوان callback (إعادة التوجيه) الذي يعرضه مربع Connect في Phynxa.
اسمح بالنطاقات api وrefresh_token وoffline_access.
انسخ Consumer Key (Client ID) وConsumer Secret (Client secret).

اربطه في Phynxa

Integrations، Connect في Salesforce.
أدخل Client ID وClient secret وLogin host: https://login.salesforce.com للإنتاج، وhttps://test.salesforce.com لـ sandbox.
تابع إلى Salesforce ووافق. تعرض البطاقة Connected.

الأذونات والإعدادات

العنصر	السبب
النطاق `api`	قراءة السجلات وكتابتها
النطاقان `refresh_token` و`offline_access`	البقاء متصلًا دون أن نسألك مجددًا
Login host	تسجّل بيئات sandbox الدخول عبر `test.salesforce.com`

تستدعي Phynxa instance URL الذي تعيده Salesforce مع الرمز (ولا تستدعي مضيف تسجيل الدخول أبدًا)، على إصدار API v67.0.

استخدمه في مكالمة

الإجراء	ما يفعله	يعمل
Create lead	ينشئ Lead. ويُملأ اسم العائلة أو الشركة الناقص بالقيمة "Unknown".	في الخلفية
Add note	ينشئ Note على سجل. ويحتاج contact id؛ وبدونه يعيد "A contact_id is needed to attach the note."	في الخلفية
Fetch customer history	يسرد المهام الأخيرة لجهة الاتصال، بمعرّفها أو ببريدها.	ينتظر
Update contact	يغيّر اسم جهة اتصال أو بريدها أو هاتفها أو شركتها؛ ولا يتغير إلا ما تعطيه. ويحتاج id جهة الاتصال من بحث في السجل.	في الخلفية
Create task	ينشئ مهمة متابعة لفريقك (subject وbody وdue_date اختياريان مثل `2026-11-02`)، ويربطها بجهة اتصال عند إعطاء id الخاص بها.	في الخلفية
Create ticket	يفتح حالة دعم بـsubject وbody اختياري، ويربطها بجهة اتصال عند إعطاء id الخاص بها.	في الخلفية

اختبره

Test connection في البطاقة. ثم اربط Create lead بوكيل، واطلب منه في Chat حفظ عميل محتمل، وتحقق من Leads في Salesforce.

النتيجة المتوقعة

يظهر Lead في Salesforce، وتحسب البطاقة طلبًا ناجحًا.

استكشاف الأخطاء

invalid_client أو عدم تطابق إعادة التوجيه. يجب أن يطابق عنوان callback في تطبيقك عنوان Phynxa تمامًا.
لا تستطيع بيئة sandbox تسجيل الدخول. استخدم https://test.salesforce.com كمضيف لتسجيل الدخول.
رُفض الوصول إلى REST. يحتاج المستخدم الذي سجّل الدخول إلى وصول API، ويجب أن يسمح تطبيقك بالنطاق api.

الأمان وبيانات الاعتماد

يُخزَّن consumer secret مشفّرًا. اربط بصفة مستخدم تطابق صلاحياته ما تريد أن يفعله الوكيل. وRemove ينسى الربط؛ فاسحب إذن التطبيق في Salesforce إذا توقفت عن استخدامه.

أدلة ذات صلة

هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.