Skip to main content

Giới thiệu

Tích hợp Close CRM tạo các bản ghi trong Close từ các sự kiện của Dodo Payments. Một khoản thanh toán thành công có thể tạo một liên hệ, còn một gói đăng ký mới có thể tạo một cơ hội, để đội ngũ bán hàng thấy hoạt động doanh thu bên cạnh các khách hàng tiềm năng.
Tích hợp này yêu cầu API key của Close có quyền tạo liên hệ và cơ hội. Để tạo API key trong Close, hãy đi đến Settings → Developer → API Keys và nhấp vào New API Key.

Bắt đầu

1

Open the Webhook Section

Trong dashboard Dodo Payments, đi đến Developer → Webhooks và nhấp vào Add endpoint.
Add endpoint dialog with CloseCRM selected in the Integration dropdown
2

Select Close CRM

Trong Integration, chọn CloseCRM.
3

Enter API Key

Trong API key, dán API key của Close. Dodo Payments gửi key này trong header Authorization của mỗi lần gửi.
4

Select Events

Trong Subscribed events, chọn các sự kiện mà transformation của bạn xử lý. Các ví dụ trên trang này sử dụng payment.succeeded và subscription.active.
5

Configure Transformation

Trong Transformation code, chỉnh sửa handler để ánh xạ dữ liệu thanh toán sang các đối tượng Close. Bắt đầu từ các ví dụ.
6

Test & Create

Trong Test this code, nhấp vào Simulate để chạy handler với một payload mẫu. Sau đó nhấp vào Create endpoint.
7

Done

Mỗi sự kiện đã đăng ký giờ đây sẽ tạo một bản ghi trong Close.

Các ví dụ về mã Transformation

Mỗi handler đặt webhook.url thành một endpoint API của Close và thay thế webhook.payload bằng request body. Close thiết lập các trường tùy chỉnh thông qua các key custom.cf_<field_id>, vì vậy hãy thay thế các key cf_ trong các ví dụ bằng ID của các trường tùy chỉnh của bạn. Số tiền của Dodo Payments được tính theo đơn vị tiền tệ nhỏ nhất, ví dụ như cent đối với USD.

Tạo liên hệ từ khoản thanh toán

Khi một khoản thanh toán thành công, hãy tạo một liên hệ. Close yêu cầu emails và phones dưới dạng danh sách các đối tượng. Nếu request không có lead_id, Close sẽ tạo một khách hàng tiềm năng mới được đặt tên theo liên hệ.
create_contact.js

Tạo cơ hội từ gói đăng ký

Khi một gói đăng ký trở nên hoạt động, hãy tạo một cơ hội. Close yêu cầu value dưới dạng số nguyên tính theo cent và value_period dưới dạng one_time, monthly hoặc annual, vì vậy ví dụ này ánh xạ payment_frequency_interval của gói đăng ký sang một chu kỳ. lead_id phải là ID khách hàng tiềm năng của Close, không phải ID khách hàng của Dodo Payments. Ví dụ này đọc ID đó từ metadata của gói đăng ký, vì vậy hãy lưu ID khách hàng tiềm năng ở đó khi bạn tạo gói đăng ký. Nếu không có lead_id, Close sẽ tạo một khách hàng tiềm năng mới không có tiêu đề.
create_opportunity.js

Mẹo

  • Kiểm tra tên và kiểu trường trong tài liệu API của Close trước khi ánh xạ các trường.
  • Lưu dữ liệu dành riêng cho khoản thanh toán, chẳng hạn như số tiền và phương thức thanh toán, trong các trường tùy chỉnh. Trước tiên hãy tạo các trường trong Close, sau đó sử dụng ID của chúng.
  • Ánh xạ recurring_pre_tax_amount của gói đăng ký sang value của cơ hội, và ánh xạ chu kỳ thanh toán của gói đăng ký sang value_period.
  • Sử dụng ID để liên kết các bản ghi: lưu customer_id của Dodo Payments trên liên hệ trong Close, và lưu ID khách hàng tiềm năng của Close trong metadata của Dodo Payments.
  • Ví dụ về liên hệ chạy trên mỗi payment.succeeded, bao gồm cả các lần gia hạn và mua lại, vì vậy khách hàng quay lại sẽ tạo thêm một liên hệ khác.

Khắc phục sự cố

  • Xác minh rằng API key có quyền ghi.
  • Kiểm tra xem các trường bắt buộc đã được đưa vào hay chưa.
  • Kiểm tra xem mỗi địa chỉ email có hợp lệ hay không.
  • Xem lại các giới hạn tốc độ của API Close.
  • Nếu lần gửi không thành công với 401, Close có thể yêu cầu xác thực Basic. Điều chỉnh header Authorization trên tab Advanced của endpoint.
  • Mở các lần thử gửi của endpoint trong tab Logs tại Developer → Webhooks để xem phản hồi từ Close.
  • Kiểm tra xem payload có khớp với định dạng API Close hay không.
  • Kiểm tra xem tất cả các trường bắt buộc đã có mặt hay chưa.
  • Kiểm tra xem tên trường có khớp chính xác với schema của Close hay không, đồng thời các trường tùy chỉnh có sử dụng ID custom.cf_ hay không.
Lần sửa đổi cuối 26 tháng 9, 2026