Chuyển đến nội dung chính

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

Bắt đầu

1

Open the Webhook Section

Trong bảng điều khiển Dodo Payments của bạn, điều hướng đến Webhooks → + Add Endpoint và mở rộng menu thả xuống các tích hợp.
Thêm điểm cuối và menu thả xuống tích hợp
2

Select Close CRM

Chọn thẻ tích hợp Close CRM.
3

Enter API Key

Cung cấp khóa API Close CRM của bạn trong phần cấu hình.
4

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.
5

Test & Create

Kiểm thử với các payload mẫu và nhấp Create để kích hoạt đồng bộ hóa.
6

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.

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

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

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

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

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

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ố

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