الانتقال إلى المحتوى الرئيسي

المقدمة

قم بتوصيل بيانات الدفع الخاصة بك مباشرةً بـ Close CRM لإدارة العملاء وتتبع المبيعات بسلاسة. أنشئ جهات اتصال وفرصًا تلقائيًا من المدفوعات الناجحة، مما يبقي فريق المبيعات لديك على اطلاع بالأنشطة المولدة للإيرادات.
يتطلب هذا التكامل مفتاح API لـ Close CRM بصلاحيات مناسبة.

البدء

1

Open the Webhook Section

في لوحة Dodo Payments الخاصة بك، انتقل إلى Webhooks → + Add Endpoint وقم بتوسيع قائمة التكاملات المنسدلة.
Add Endpoint and integrations dropdown
2

Select Close CRM

اختر بطاقة التكامل Close CRM.
3

Enter API Key

قدّم مفتاح API الخاص بـ Close CRM في التكوين.
4

Configure Transformation

حرّر كود التحويل لربط بيانات الدفع بالأجسام في Close CRM.
5

Test & Create

اختبر باستخدام الحمولات النموذجية وانقر على Create لتنشيط المزامنة.
6

Done!

🎉 ستقوم أحداث الدفع الآن تلقائيًا بإنشاء/تحديث السجلات في Close CRM.

أمثلة كود التحويل

إنشاء جهة اتصال من الدفع

create_contact.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.close.com/api/v1/contact/";
    webhook.payload = {
      name: p.customer.name,
      emails: [p.customer.email],
      phones: [p.customer.phone || ''],
      custom: {
        payment_amount: (p.total_amount / 100).toFixed(2),
        payment_method: p.payment_method || '',
        dodo_customer_id: p.customer.customer_id
      }
    };
  }
  return webhook;
}

إنشاء فرصة من الاشتراك

create_opportunity.js
function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://api.close.com/api/v1/opportunity/";
    webhook.payload = {
      lead_id: s.customer.customer_id,
      value: (s.recurring_pre_tax_amount / 100).toFixed(2),
      value_period: s.payment_frequency_interval,
      title: `Subscription - ${s.product_id}`,
      custom: {
        subscription_id: s.subscription_id,
        billing_frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date
      }
    };
  }
  return webhook;
}

نصائح

  • استخدم وثائق API الخاصة بـ Close CRM لفهم ربط الحقول
  • قم بتضمين الحقول المخصصة لبيانات الدفع المحددة
  • اربط مبالغ الاشتراك بقيم الفرص
  • استخدم معرفات العملاء لربط العملاء بشكل صحيح

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

  • تأكد من أن مفتاح API يملك أذونات الكتابة
  • تحقق من تضمين الحقول المطلوبة
  • تأكد من أن تنسيق البريد الإلكتروني صالح
  • راجع حدود معدلات Close CRM API
  • تحقق من أن بنية JSON تتطابق مع تنسيق Close CRM API
  • تأكد من وجود كافة الحقول المطلوبة
  • تأكد من أن أسماء الحقول تطابق مخطط Close CRM تمامًا