المقدمة
ينشئ تكامل Close CRM سجلات في Close انطلاقًا من أحداث Dodo Payments. يمكن لعملية دفع ناجحة إنشاء جهة اتصال، ويمكن لاشتراك جديد إنشاء فرصة، بحيث يرى فريق المبيعات لديك نشاط الإيرادات بجوار العملاء المحتملين.يتطلب هذا التكامل مفتاح API من Close مع صلاحية إنشاء جهات الاتصال والفرص. لإنشاء مفتاح في Close، انتقل إلى Settings → Developer → API Keys وانقر على New API Key.
البدء
1
Open the Webhook Section
في لوحة تحكم Dodo Payments، انتقل إلى Developer → Webhooks وانقر على Add endpoint.

2
Select Close CRM
في Integration، حدد CloseCRM.
3
Enter API Key
في API key، الصق مفتاح API من Close. يرسله Dodo Payments في ترويسة
Authorization لكل عملية تسليم.4
Select Events
في Subscribed events، حدد الأحداث التي يعالجها التحويل. تستخدم الأمثلة في هذه الصفحة
payment.succeeded وsubscription.active.5
Configure Transformation
ضمن Transformation code، عدّل المعالج لربط بيانات الدفع بكائنات Close. ابدأ من الأمثلة.
6
Test & Create
ضمن Test this code، انقر على Simulate لتشغيل المعالج باستخدام حمولة نموذجية. ثم انقر على Create endpoint.
7
Done
ينشئ كل حدث مشترك الآن سجلًا في Close.
أمثلة على كود التحويل
يعيّن كل معالجwebhook.url إلى نقطة نهاية API في Close ويستبدل webhook.payload بجسم الطلب. يعيّن Close الحقول المخصصة من خلال مفاتيح custom.cf_<field_id>، لذا استبدل مفاتيح cf_ في الأمثلة بمعرّفات الحقول المخصصة الخاصة بك. تكون مبالغ Dodo Payments بوحدة العملة الأصغر، مثل السنتات بالنسبة إلى USD.
إنشاء جهة اتصال من عملية دفع
عند نجاح عملية دفع، أنشئ جهة اتصال. يتطلب Close أن يكون كل منemails وphones قائمتين من الكائنات. إذا لم يتضمن الطلب lead_id، ينشئ Close عميلًا محتملًا جديدًا باسم جهة الاتصال.
create_contact.js
إنشاء فرصة من اشتراك
عندما يصبح الاشتراك نشطًا، أنشئ فرصة. يتطلب Close أن تكون قيمةvalue عددًا صحيحًا بالسنتات، وأن تكون قيمة value_period إحدى القيم one_time أو monthly أو annual، لذا يربط المثال قيمة payment_frequency_interval الخاصة بالاشتراك بفترة. يجب أن يكون lead_id معرّف عميل محتمل في Close، وليس معرّف عميل في Dodo Payments. يقرأ المثال هذا المعرّف من metadata الخاص بالاشتراك، لذا خزّن معرّف العميل المحتمل هناك عند إنشاء الاشتراك. من دون lead_id، ينشئ Close عميلًا محتملًا جديدًا بلا عنوان.
create_opportunity.js
نصائح
- تحقّق من أسماء الحقول وأنواعها في وثائق Close API قبل ربط الحقول.
- خزّن البيانات الخاصة بالدفع، مثل المبلغ وطريقة الدفع، في الحقول المخصصة. أنشئ الحقول في Close أولًا، ثم استخدم معرّفاتها.
- اربط
recurring_pre_tax_amountالخاص بالاشتراك بـvalueالخاص بالفرصة، وفترة الفوترة بـvalue_period. - استخدم المعرّفات لربط السجلات: خزّن
customer_idالخاص بـ Dodo Payments على جهة اتصال Close، وخزّن معرّف العميل المحتمل في Close ضمنmetadataالخاص بـ Dodo Payments. - يعمل مثال جهة الاتصال عند كل
payment.succeeded، بما في ذلك عمليات التجديد وعمليات الشراء المتكررة، لذا ينشئ العميل العائد جهة اتصال أخرى.
استكشاف الأخطاء وإصلاحها
Records Not Created in Close CRM
Records Not Created in Close CRM
- تحقّق من أن مفتاح API لديه صلاحيات الكتابة.
- تحقّق من تضمين الحقول المطلوبة.
- تحقّق من صحة كل عنوان بريد إلكتروني.
- راجع حدود معدل طلبات Close API.
- إذا فشلت عمليات التسليم مع
401، فقد يتوقع Close مصادقة Basic. اضبط ترويسةAuthorizationفي علامة التبويب Advanced لنقطة النهاية. - افتح محاولات تسليم نقطة النهاية في علامة التبويب Logs ضمن Developer → Webhooks للاطلاع على الاستجابة من Close.
Transformation Errors
Transformation Errors
- تحقّق من توافق الحمولة مع تنسيق Close API.
- تحقّق من وجود جميع الحقول المطلوبة.
- تحقّق من تطابق أسماء الحقول مع مخطط Close تمامًا، ومن استخدام الحقول المخصصة لمعرّفات
custom.cf_.