Skip to main content

はじめに

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 をクリックします。
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 は、すべての 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 として再度作成されます。

トラブルシューティング

  • API key に write permissions があることを確認します。
  • 必須 fields が含まれていることを確認します。
  • 各 email address が有効であることを確認します。
  • Close API rate limits を確認します。
  • delivery が 401 で失敗する場合、Close が Basic authentication を要求している可能性があります。endpoint の Advanced tab で Authorization header を調整してください。
  • Developer → Webhooks の Logs tab で endpoint の delivery attempts を開き、Close からの response を確認します。
  • payload が Close API format と一致していることを確認します。
  • 必須 fields がすべて存在することを確認します。
  • field names が Close schema と完全に一致し、custom fields に custom.cf_ IDs が使用されていることを確認します。
最終更新日 2026年9月28日