> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Close CRM

> مزامنة بيانات مدفوعات Dodo مع Close CRM لتتبع العملاء وإدارة مبيعاتك.

## المقدمة

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

<Info>
  يتطلب هذا التكامل مفتاح API لـ Close CRM بصلاحيات مناسبة.
</Info>

## البدء

<Steps>
  <Step title="Open the Webhook Section">
    في لوحة Dodo Payments الخاصة بك، انتقل إلى <b>Webhooks → + Add Endpoint</b> وقم بتوسيع قائمة التكاملات المنسدلة.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/close-crm.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=bd462e078ea95d7853eb066cdbaebb0f" alt="Add Endpoint and integrations dropdown" width="1710" height="948" data-path="images/integrations/close-crm.png" />
    </Frame>
  </Step>

  <Step title="Select Close CRM">
    اختر بطاقة التكامل <b>Close CRM</b>.
  </Step>

  <Step title="Enter API Key">
    قدّم مفتاح API الخاص بـ Close CRM في التكوين.
  </Step>

  <Step title="Configure Transformation">
    حرّر كود التحويل لربط بيانات الدفع بالأجسام في Close CRM.
  </Step>

  <Step title="Test & Create">
    اختبر باستخدام الحمولات النموذجية وانقر على <b>Create</b> لتنشيط المزامنة.
  </Step>

  <Step title="Done!">
    🎉 ستقوم أحداث الدفع الآن تلقائيًا بإنشاء/تحديث السجلات في Close CRM.
  </Step>
</Steps>

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

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

```javascript create_contact.js icon="js" expandable theme={null}
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;
}
```

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

```javascript create_opportunity.js icon="js" expandable theme={null}
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 لفهم ربط الحقول
* قم بتضمين الحقول المخصصة لبيانات الدفع المحددة
* اربط مبالغ الاشتراك بقيم الفرص
* استخدم معرفات العملاء لربط العملاء بشكل صحيح

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

<AccordionGroup>
  <Accordion title="Records not created in Close CRM">
    * تأكد من أن مفتاح API يملك أذونات الكتابة
    * تحقق من تضمين الحقول المطلوبة
    * تأكد من أن تنسيق البريد الإلكتروني صالح
    * راجع حدود معدلات Close CRM API
  </Accordion>

  <Accordion title="Transformation errors">
    * تحقق من أن بنية JSON تتطابق مع تنسيق Close CRM API
    * تأكد من وجود كافة الحقول المطلوبة
    * تأكد من أن أسماء الحقول تطابق مخطط Close CRM تمامًا
  </Accordion>
</AccordionGroup>