التكاملات
افتح الإعدادات، ثم اختر مجال التكاملات لربط كسبلي بالقنوات والأدوات والتطبيقات والإضافات.
يحتوي مجال التكاملات على الأهداف التالية:
- إضافة إعداد جاهز — ثبّت حزمة من المتجر.
- ربط واتساب والأدوات والتطبيقات — أدر تكاملات الواجهة البرمجية وقدرات المساعد.
- ربط واتساب للأعمال — أدر حسابات الأعمال والأرقام والقوالب والتحقق.
- فحص صحة الاتصال — راجع فحوصات صحة القنوات والتكاملات.
- تنبيهات النشاط — اختر طريقة توصيل الإشعارات والتنبيهات.
- تشغيل/إيقاف الميزات — أدر علامات ميزات مساحة العمل المتقدمة.
- الإضافات الصناعية — افتح الإضافات المثبّتة وإعداداتها.
استخدم ابحث في الإعدادات… للوصول مباشرةً إلى أحد هذه الأهداف. افتح بطاقة الهدف لرؤية ملخصه وعناصر التحكم، واستخدم إجراء الصفحة الكاملة مثل إدارة التكاملات عندما يظهر لفتح المحرّر الكامل.
للوصول البرمجي بمفاتيحك الخاصة، افتح هدف مفاتيح المطوّرين في مجال الأشخاص والوصول، أو راجع مفاتيح API.
عقد API لـ CRM مخصص
Section titled “عقد API لـ CRM مخصص”اختر CRM مخصص (API) عندما يوفّر CRM لديك نقطة REST. يرسل كسبلي الترويسة
Authorization: Bearer <API key> وJSON إلى المسارات التالية:
GET /health(أو رابط الأساس) لفحص الاتصال.- يستقبل
POST /contactsالقيمة{ contacts: [...] }؛ ويتضمن كل عميلidوphoneوnameوemailوcityوlanguageوtagsوcustomFieldsوleadScore. - يعيد
GET /contacts?since=<ISO-8601>مصفوفة أو{ data: [...] }أو{ contacts: [...] }أو{ results: [...] }باستخدام الحقول نفسها. - يستقبل
POST /dealsالقيمة{ deals: [...] }؛ ويتضمن كل عرضidوcustomerIdوcustomerPhoneوcustomerNameوstageوvalueوcurrencyوtitle. - يعيد
GET /deals?since=<ISO-8601>أحد أغلفة المصفوفة نفسها وبالحقول نفسها. - يحدّث
POST /deals/{id}/stageمرحلة عرض واحد. أرسل{ stageId, externalStageId }بالقيمة نفسها لمعرّف المرحلة الخارجي في الحقلين. قيمةstageIdهي معرّف المرحلة الخارجي الذي تدخله في جدول ربط مراحل CRM.
للمزامنة ثنائية الاتجاه، أعد id ثابتاً وcustomerPhone لكل عرض. استخدم جدول
ربط مراحل CRM لربط كل قيمة stage واردة بمرحلة دورة حياة في كسبلي. احذف الحقل
الذي لا يعرفه CRM لديك بدلاً من إرسال قيمة فارغة تستبدل بيانات موجودة.
خطافات الويب الواردة لـ CRM المخصص
Section titled “خطافات الويب الواردة لـ CRM المخصص”لإرسال تغيير مرحلة أو جهة اتصال من CRM إلى كسبلي، أرسل طلب POST إلى
/v1/webhooks/crm/custom. أضف في الترويسة X-Tenant-Id معرّف مساحة عمل كسبلي
التي تستخدم CRM مخصص (API).
صادِق الطلب بإحدى الطريقتين التاليتين:
Authorization: Bearer <API key>باستخدام مفتاح API المضبوط لاتصال CRM المخصص.X-Webhook-Secret: <signature>، حيث تكونsignatureقيمة HMAC-SHA256 بصيغة hex صغيرة لمحارف نص JSON الخام للطلب، باستخدام سر Webhook المخصص الذي يظهر مرة واحدة بعد حفظ اتصال CRM المخصص. انسخ السر قبل مغادرة صفحة الإعدادات. تبقى عمليات التكامل الحالية التي توقّع بمفتاح API المضبوط مدعومة للتوافق، لكن ينبغي أن تستخدم عمليات التكامل الجديدة سر Webhook المخصص.
يمكن أن تكون بيانات الحدث في المستوى الأعلى أو داخل data أو payload. استخدم
event أو type لتحديد الحدث؛ تعامَل القيم التي تحتوي deal أو opportunity
كأحداث عروض، والقيم التي تحتوي contact أو lead كأحداث جهات اتصال. لتغيير
مرحلة، أرسل معرّف العرض الخارجي في أحد الحقول id أو external_id أو objectId
أو object_id أو record_id أو resource_id، والمرحلة الخارجية في أحد الحقول
newStageId أو new_stage_id أو newStageName أو new_stage_name أو
externalStageId أو external_stage_id أو externalStageName أو
external_stage_name أو externalStage أو external_stage أو stage_id أو
deal_stage أو pipeline_stage أو stage أو pipeline. تقبل مطابقة جهات الاتصال
phone أو phone_number أو customerPhone أو customer_phone أو person_phone
أو contact_phone، كما تقبل email أو customerEmail أو customer_email أو
person_email أو contact_email.
HubSpot CRM
Section titled “HubSpot CRM”يستخدم HubSpot CRM OAuth وينشئ الخصائص التي يحتاجها كسبلي أثناء الاتصال. راجع دليل الإعداد لمعرفة معرّف الصفقة المطلوب وطريقة إعادة ربط بوابة منعت صلاحيات المسؤول فيها الإعداد.
Pipedrive CRM
Section titled “Pipedrive CRM”يستخدم Pipedrive CRM OAuth وينشئ حقول الصفقات والأشخاص التي يحتاجها كسبلي أثناء الاتصال. راجع دليل الإعداد لمعرفة أسماء الحقول اليدوية إذا احتاج المسؤول إلى إكمال الإعداد.