Skip to main content

介绍

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。
Add endpoint dialog with CloseCRM selected in the Integration dropdown
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 Payments metadata 中。
  • 联系人示例会在每个 payment.succeeded 上运行,包括续订和重复购买,因此回访客户会再次创建一个联系人。

Troubleshooting

  • 确认 API key 具有写入权限。
  • 检查是否包含必需字段。
  • 检查每个 email address 是否有效。
  • 查看 Close API 的速率限制。
  • 如果传送因 401 失败,Close 可能要求使用 Basic authentication。请在 endpoint 的 Advanced 标签页中调整 Authorization header。
  • 打开 endpoint 在 开发者 → Webhooks 的 Logs 标签页中的传送尝试,查看 Close 返回的响应。
  • 检查 payload 是否符合 Close API 格式。
  • 检查所有必需字段是否存在。
  • 检查字段名称是否与 Close schema 完全匹配,并确认自定义字段使用 custom.cf_ IDs。
最后修改于 2026年9月26日