Skip to main content

المقدمة

ينشئ تكامل 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.
Add endpoint dialog with CloseCRM selected in the Integration dropdown
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، بما في ذلك عمليات التجديد وعمليات الشراء المتكررة، لذا ينشئ العميل العائد جهة اتصال أخرى.

استكشاف الأخطاء وإصلاحها

  • تحقّق من أن مفتاح API لديه صلاحيات الكتابة.
  • تحقّق من تضمين الحقول المطلوبة.
  • تحقّق من صحة كل عنوان بريد إلكتروني.
  • راجع حدود معدل طلبات Close API.
  • إذا فشلت عمليات التسليم مع 401، فقد يتوقع Close مصادقة Basic. اضبط ترويسة Authorization في علامة التبويب Advanced لنقطة النهاية.
  • افتح محاولات تسليم نقطة النهاية في علامة التبويب Logs ضمن Developer → Webhooks للاطلاع على الاستجابة من Close.
  • تحقّق من توافق الحمولة مع تنسيق Close API.
  • تحقّق من وجود جميع الحقول المطلوبة.
  • تحقّق من تطابق أسماء الحقول مع مخطط Close تمامًا، ومن استخدام الحقول المخصصة لمعرّفات custom.cf_.
آخر تعديل في ٢٨ سبتمبر ٢٠٢٦