介绍
Close CRM 集成会根据 Dodo Payments 事件在 Close 中创建记录。成功付款可以创建联系人,新订阅可以创建商机,让您的销售团队能够在潜在客户旁边查看收入活动。此集成需要一个具有创建联系人和商机权限的 Close API key。要在 Close 中创建 API key,请前往 设置 → 开发者 → API Keys,然后点击 New API Key。
开始使用
1
Open the Webhook Section
在 Dodo Payments 仪表板中,前往 Developer → Webhooks,然后点击 Add endpoint。

2
Select Close CRM
在 Integration 中,选择 CloseCRM。
3
Enter API Key
在 API key 中,粘贴您的 Close API key。Dodo Payments 会在每次传送的
Authorization header 中发送该 API key。4
Select Events
在 Subscribed events 中,选择您的 transformation 所处理的事件。本页面中的示例使用
payment.succeeded 和 subscription.active。5
Configure Transformation
在 Transformation code 下,编辑 handler,将付款数据映射到 Close 对象。请从示例开始。
6
Test & Create
在 Test this code 下,点击 Simulate,使用示例 payload 运行 handler。然后点击 Create endpoint。
7
Done
现在,每个已订阅事件都会在 Close 中创建一条记录。
Transformation Code Examples
每个 handler 都会将webhook.url 设置为 Close API endpoint,并将 webhook.payload 替换为 request body。Close 通过 custom.cf_<field_id> keys 设置自定义字段,因此请将示例中的 cf_ keys 替换为您自己的自定义字段 ID。Dodo Payments 的金额以最小货币单位表示,例如 USD 的 cents。
Create Contact from Payment
付款成功后,创建一个联系人。Close 接受以对象列表形式提供的emails 和 phones。如果 request 中没有 lead_id,Close 会创建一个以联系人姓名命名的新 lead。
create_contact.js
Create Opportunity from Subscription
订阅变为 active 后,创建一个商机。Close 接受以 cents 为单位的整数value,以及值为 one_time、monthly 或 annual 的 value_period,因此示例会将订阅的 payment_frequency_interval 映射到一个 period。lead_id 必须是 Close lead ID,而不是 Dodo Payments customer ID。示例会从订阅的 metadata 中读取该 ID,因此请在创建订阅时将 lead ID 存储在那里。如果没有 lead_id,Close 会创建一个没有标题的新 lead。
create_opportunity.js
Tips
- 在映射字段之前,请查看 Close API 文档,确认字段名称和类型。
- 将金额和付款方式等付款专属数据存储在自定义字段中。先在 Close 中创建这些字段,然后使用其 ID。
- 将订阅的
recurring_pre_tax_amount映射到商机的value,并将其 billing interval 映射到value_period。 - 使用 ID 关联记录:将 Dodo Payments
customer_id存储在 Close 联系人上,并将 Close lead ID 存储在 Dodo Paymentsmetadata中。 - 联系人示例会在每个
payment.succeeded上运行,包括续订和重复购买,因此回访客户会再次创建一个联系人。
Troubleshooting
Records Not Created in Close CRM
Records Not Created in Close CRM
- 确认 API key 具有写入权限。
- 检查是否包含必需字段。
- 检查每个 email address 是否有效。
- 查看 Close API 的速率限制。
- 如果传送因
401失败,Close 可能要求使用 Basic authentication。请在 endpoint 的 Advanced 标签页中调整Authorizationheader。 - 打开 endpoint 在 开发者 → Webhooks 的 Logs 标签页中的传送尝试,查看 Close 返回的响应。
Transformation Errors
Transformation Errors
- 检查 payload 是否符合 Close API 格式。
- 检查所有必需字段是否存在。
- 检查字段名称是否与 Close schema 完全匹配,并确认自定义字段使用
custom.cf_IDs。