はじめに
Close CRM integration は、Dodo Payments のイベントから Close にレコードを作成します。支払いが成功するとコンタクトを作成でき、新しいサブスクリプションが開始されると商談を作成できるため、営業チームはリードの隣で収益アクティビティを確認できます。この integration には、コンタクトと商談を作成する権限を持つ Close API key が必要です。Close で作成するには、Settings → Developer → 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 は、すべての delivery の
Authorization header にこの key を含めて送信します。4
Select Events
Subscribed events で、transformation が処理するイベントを選択します。このページの例では
payment.succeeded と subscription.active を使用します。5
Configure Transformation
Transformation code で handler を編集し、支払いデータを Close objects にマッピングします。examples から始めてください。
6
Test & Create
Test this code で Simulate をクリックし、sample payload に対して handler を実行します。次に Create endpoint をクリックします。
7
Done
これで、サブスクライブした各イベントによって Close にレコードが作成されます。
Transformation Code の例
各 handler はwebhook.url を Close API endpoint に設定し、webhook.payload を request body に置き換えます。Close は custom.cf_<field_id> keys を使用して custom fields を設定するため、例に含まれる cf_ keys を独自の custom fields の ID に置き換えてください。Dodo Payments の金額は最小通貨単位で表されます。たとえば USD では cents です。
Payment から Contact を作成する
支払いが成功したら、コンタクトを作成します。Close はemails と phones を objects の list として受け取ります。request に lead_id がない場合、Close はコンタクト名を使用して新しいリードを作成します。
create_contact.js
Subscription から Opportunity を作成する
サブスクリプションがアクティブになったら、商談を作成します。Close はvalue を cents 単位の integer として受け取り、value_period を one_time、monthly、または annual として受け取るため、この例ではサブスクリプションの payment_frequency_interval を期間にマッピングしています。lead_id は Dodo Payments customer ID ではなく、Close lead ID である必要があります。この例では、サブスクリプションの metadata からその値を読み取るため、サブスクリプションを作成する際に lead ID をそこへ保存してください。lead_id がない場合、Close は名前のない新しいリードを作成します。
create_opportunity.js
ヒント
- fields をマッピングする前に、Close API documentation で field names と types を確認してください。
- 金額や payment method など、支払い固有のデータは custom fields に保存します。まず Close で fields を作成し、その ID を使用してください。
- サブスクリプションの
recurring_pre_tax_amountを opportunity のvalueに、billing interval をvalue_periodにマッピングします。 - レコードのリンクには ID を使用します。Dodo Payments の
customer_idを Close contact に保存し、Close lead ID を Dodo Payments のmetadataに保存してください。 - contact の例は renewals や repeat purchases を含むすべての
payment.succeededで実行されるため、returning customer は別の contact として再度作成されます。
トラブルシューティング
Records Not Created in Close CRM
Records Not Created in Close CRM
- API key に write permissions があることを確認します。
- 必須 fields が含まれていることを確認します。
- 各 email address が有効であることを確認します。
- Close API rate limits を確認します。
- delivery が
401で失敗する場合、Close が Basic authentication を要求している可能性があります。endpoint の Advanced tab でAuthorizationheader を調整してください。 - Developer → Webhooks の Logs tab で endpoint の delivery attempts を開き、Close からの response を確認します。
Transformation Errors
Transformation Errors
- payload が Close API format と一致していることを確認します。
- 必須 fields がすべて存在することを確認します。
- field names が Close schema と完全に一致し、custom fields に
custom.cf_IDs が使用されていることを確認します。