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.

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 đặtwebhook.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ầuemails 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ầuvalue 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_amountcủa gói đăng ký sangvaluecủa cơ hội, và ánh xạ chu kỳ thanh toán của gói đăng ký sangvalue_period. - Sử dụng ID để liên kết các bản ghi: lưu
customer_idcủ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 trongmetadatacủ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ố
Records Not Created in Close CRM
Records Not Created in Close CRM
- 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 headerAuthorizationtrê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.
Transformation Errors
Transformation Errors
- 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.