HubSpot
اربط HubSpot بتطبيق OAuth الخاص بك ليستطيع الوكيل حفظ العملاء المحتملين وإضافة الملاحظات والبحث عن جهة اتصال أثناء المكالمة.
ما الذي ستحققه
سيستطيع الوكيل إنشاء جهة اتصال في HubSpot، وإضافة ملاحظة إليها، وقراءة سجل جهة اتصال والمتصل على الخط.
نظرة عامة وحالات الاستخدام
- حفظ كل متصل جديد كجهة اتصال في HubSpot بالاسم والبريد والهاتف والشركة.
- إضافة ملاحظة المكالمة إلى جهة الاتصال الصحيحة بعد المحادثة.
- الترحيب بمتصل عائد بما تعرفه HubSpot عنه.
المتطلبات المسبقة
- حساب HubSpot، وحساب مطوّر HubSpot لإنشاء تطبيق OAuth. لم تعد HubSpot تقدّم مفاتيح API (أُوقفت في نوفمبر 2022)، فـ OAuth هو الطريق الوحيد.
- دور owner أو admin في Phynxa.
إعداد الحساب الخارجي (في HubSpot)
HubSpot هي التي تتحكم في هذه الشاشات؛ وقد تتغير الصياغة. دليل HubSpot: HubSpot CRM API.
- في حساب مطوّر HubSpot الخاص بك، أنشئ تطبيقًا لـ Phynxa.
- في إعدادات المصادقة للتطبيق، أضف عنوان إعادة التوجيه الذي يعرضه مربع Connect في Phynxa (انسخه تمامًا كما هو).
- أضف النطاقات (scopes) المذكورة أدناه.
- انسخ Client ID وClient secret الخاصَّين بالتطبيق.
اربطه في Phynxa
- افتح Integrations واختر Connect في HubSpot.
- الصق Client ID وClient secret.
- تابع إلى HubSpot، واختر حسابك ووافق.
- تعود إلى Phynxa وتعرض البطاقة Connected.
الأذونات والإعدادات
| Scope | السبب |
|---|---|
crm.objects.contacts.read وcrm.objects.contacts.write | البحث عن جهات الاتصال وإنشاؤها وتحديثها |
crm.objects.deals.read وcrm.objects.deals.write | الصفقات (محجوزة للاستخدام لاحقًا؛ لا تُعرض كأداة للوكيل بعد) |
tickets | التذاكر (تستخدمها Create ticket) |
استخدمه في مكالمة
في تبويب Tools الخاص بالوكيل، Add tool، Integration، HubSpot:
| الإجراء | ما يفعله | يعمل |
|---|---|---|
| Create lead | ينشئ جهة اتصال من الاسم الأول واسم العائلة والبريد والهاتف والشركة. | في الخلفية |
| Add note | يضيف ملاحظة. أعطه معرّف جهة الاتصال لتُربَط بها؛ وبدونه لا ترتبط الملاحظة بأي جهة اتصال. | في الخلفية |
| Fetch customer history | يقرأ جهة اتصال (بالبريد أو المعرّف) مع ملاحظاتها ومهامها وصفقاتها وتذاكرها. | ينتظر الجواب |
| Update contact | يغيّر اسم جهة اتصال أو بريدها أو هاتفها أو شركتها؛ ولا يتغير إلا ما تعطيه. ويحتاج id جهة الاتصال من بحث في السجل. | في الخلفية |
| Create task | ينشئ مهمة متابعة لفريقك (subject وbody وdue_date اختياريان مثل 2026-11-02)، ويربطها بجهة اتصال عند إعطاء id الخاص بها. | في الخلفية |
| Create ticket | يفتح حالة دعم بـsubject وbody اختياري، ويربطها بجهة اتصال عند إعطاء id الخاص بها. | في الخلفية |
اختبره
- في قائمة ⋯ للبطاقة اختر Test connection. توقّع "HubSpot is responding."
- اربط Create lead بوكيل، وافتح Chat، وقل "My name is Sam Lee, email sam@example.com, phone +14155550100"، وابحث في HubSpot عن جهة الاتصال الجديدة.
النتيجة المتوقعة
تظهر جهة الاتصال في HubSpot خلال ثوانٍ، وتحسب صفحة Integrations طلبًا ناجحًا.
استكشاف الأخطاء
- تقول HubSpot إن عنوان إعادة التوجيه لا يطابق. يجب أن يكون العنوان في تطبيق HubSpot الخاص بك هو العنوان نفسه الذي عرضته Phynxa تمامًا.
- 403 أو "missing scopes". أضف النطاقات أعلاه إلى التطبيق ثم Reconnect.
- ينشئ Add note ملاحظة لا يراها أحد. لم يكن لها معرّف جهة اتصال؛ فاستخدم Fetch customer history أولًا أو اجعل التعليمات تمرّر المعرّف.
- تعرض البطاقة Error. اختر Reconnect؛ وتعرض البطاقة سبب HubSpot.
الأمان وبيانات الاعتماد
يُخزَّن Client secret مشفّرًا ولا يُعرض مجددًا. ويقتصر الوصول الذي تحصل عليه Phynxa على النطاقات أعلاه في الحساب الذي وافقت عليه. وRemove يحذف الربط المحفوظ وبيانات الاعتماد؛ فاسحب أيضًا إذن التطبيق في HubSpot إذا توقفت عن استخدامه.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.