> ## 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

> Đồng bộ dữ liệu Dodo Payments với Close CRM để theo dõi khách hàng tiềm năng và quản lý quy trình bán hàng.

## Giới thiệu

Kết nối dữ liệu thanh toán của bạn trực tiếp với Close CRM để quản lý khách hàng tiềm năng và theo dõi doanh số một cách liền mạch. Tự động tạo liên hệ và cơ hội từ các khoản thanh toán thành công, giữ cho đội ngũ bán hàng của bạn được thông báo về các hoạt động tạo doanh thu.

<Info>
  Tích hợp này yêu cầu một khóa API Close CRM với các quyền phù hợp.
</Info>

## Bắt đầu

<Steps>
  <Step title="Open the Webhook Section">
    Trong bảng điều khiển Dodo Payments của bạn, điều hướng đến <b>Webhooks → + Thêm Endpoint</b> và mở rộng menu thả xuống tích hợp.

    <Frame>
      <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/close-crm.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=bd462e078ea95d7853eb066cdbaebb0f" alt="Thêm Endpoint và menu thả xuống tích hợp" style={{ maxHeight: '500px', width: 'auto' }} width="1710" height="948" data-path="images/integrations/close-crm.png" />
    </Frame>
  </Step>

  <Step title="Select Close CRM">
    Chọn thẻ tích hợp <b>Close CRM</b>.
  </Step>

  <Step title="Enter API Key">
    Cung cấp khóa API Close CRM của bạn trong phần cấu hình.
  </Step>

  <Step title="Configure Transformation">
    Chỉnh sửa mã chuyển đổi để ánh xạ dữ liệu thanh toán vào các đối tượng của Close CRM.
  </Step>

  <Step title="Test & Create">
    Kiểm thử với các payload mẫu và nhấp <b>Create</b> để kích hoạt đồng bộ hóa.
  </Step>

  <Step title="Done!">
    🎉 Các sự kiện thanh toán giờ sẽ tự động tạo/cập nhật bản ghi trong Close CRM.
  </Step>
</Steps>

## Ví dụ Mã Biến đổi

### Tạo Liên hệ từ Thanh toán

```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;
}
```

### Tạo Cơ hội từ Đăng ký

```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;
}
```

## Mẹo

* Sử dụng tài liệu API của Close CRM để hiểu ánh xạ trường
* Bao gồm các trường tùy chỉnh cho dữ liệu cụ thể của thanh toán
* Ánh xạ số tiền đăng ký đến giá trị cơ hội
* Sử dụng ID khách hàng để liên kết đúng với khách hàng tiềm năng

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="Records not created in Close CRM">
    * Xác minh khóa API có quyền ghi
    * Kiểm tra rằng các trường bắt buộc đã được bao gồm
    * Đảm bảo định dạng email hợp lệ
    * Xem lại giới hạn tần suất API Close CRM
  </Accordion>

  <Accordion title="Transformation errors">
    * Xác nhận cấu trúc JSON khớp với định dạng API Close CRM
    * Kiểm tra rằng tất cả các trường bắt buộc đều có mặt
    * Đảm bảo tên trường trùng khớp chính xác với sơ đồ Close CRM
  </Accordion>
</AccordionGroup>