> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion エンタイトルメント

> お客様が購入すると、Notionテンプレートをワークスペースに複製します。

<Info>
  Notion エンタイトルメントは、準備したテンプレートを支払い済みのお客様のNotionワークスペースに複製します。お客様はOAuthを通じて認証し、テンプレートをコピーしたいワークスペースを選び、Dodo Paymentsが複製を処理します。
</Info>

## 納品内容

* お客様はOAuthを介して自分のNotionワークスペースを接続するよう求められます。
* 認証が完了すると、Dodo Paymentsが設定されたテンプレートを選んだワークスペースに複製します。
* キャンセル時には、複製されたテンプレートはお客様のワークスペースに残ります（Notionはリモート削除をサポートしていません）。その権限は記録保持のために`revoked`とマークされます。

一般的な用途は、有料Notionテンプレート、生産性システム、OS/CRMテンプレートです。

## Notionの接続

<Steps>
  <Step title="Open Entitlements">
    Dodo Paymentsダッシュボードで、**エンタイトルメント**を選択し、\*\*+\*\*をクリックします。
  </Step>

  <Step title="Pick Notion">
    統合として**Notionテンプレート**を選択します。Notionがまだ接続されていない場合は、**Notionを接続**するよう促されます。

    <Frame caption="Connect Notion prompt before the OAuth handoff.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/connect-prompt.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=90f1f2a60c96918a8da19665a24fcaca" alt="Notionを接続するよう促す新しいエンタイトルメントパネル" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1133" data-path="images/entitlements/notion/connect-prompt.png" />
    </Frame>

    クリックすると、新しいタブでNotionが開きます。ソーステンプレートを所有するワークスペースにサインインし、Dodo Paymentsが要求する権限を確認して、統合が読み取りと複製を許可されるページ（テンプレート）を選びます。

    <Frame caption="Notion OAuth: review permissions, then pick the template pages to share.">
      <div style={{ display: 'flex', gap: '12px', flexWrap: 'wrap', justifyContent: 'center' }}>
        <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/oauth-permissions.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=957e39812ac19bbf81cceb50f023a14a" alt="Dodo PaymentsのためのNotion OAuth権限画面" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1121" data-path="images/entitlements/notion/oauth-permissions.png" />

        <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/oauth-select-pages.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=1f8bd414d5900f9d246d96f15877aba1" alt="Dodo Paymentsがアクセスできるテンプレートを選択するNotionページピッカー" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1138" data-path="images/entitlements/notion/oauth-select-pages.png" />
      </div>
    </Frame>

    Notionがリダイレクトされると、ワークスペースが接続されたことを確認する画面が表示されます。

    <Frame caption="Workspace connected — return to the Dodo Payments dashboard to continue.">
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/connected.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=5e526d2cc12c27f526b2a6e469157bd8" alt="Notionテンプレートが正常に接続された確認ページ" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1143" data-path="images/entitlements/notion/connected.png" />
    </Frame>
  </Step>

  <Step title="Pick a template">
    ダッシュボードに戻り、テンプレートピッカーから重複させたい**テンプレート**を選択します。ここには前のステップで認可されたページのみが表示されます。エンタイトルメントに**名前**を付けて、**エンタイトルメントを作成**をクリックします。

    <Frame>
      <img src="https://mintcdn.com/dodopayments/do-W-dMDGVB_xzr_/images/entitlements/notion/create.png?fit=max&auto=format&n=do-W-dMDGVB_xzr_&q=85&s=82a51c79ed0c6937abf866c187673ab7" alt="接続されたワークスペース、テンプレートピッカー、名前フィールドを含むNotionエンタイトルメントフォーム" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1135" data-path="images/entitlements/notion/create.png" />
    </Frame>
  </Step>

  <Step title="Save the entitlement">
    保存して、任意の商品に添付します。
  </Step>
</Steps>

## お客様のフロー

1. お客様がチェックアウトを完了します。
2. Dodo Paymentsが、Notion `oauth_url`を追加した状態で、`pending`ステータスのグラントを作成します。
3. お客様がメールや顧客ポータルのリンクを通じて認証し、テンプレートを複製したいワークスペースを選びます。
4. Dodo Paymentsがテンプレートを複製します。グラントは`delivered`に移行します。
5. 取り消し時には、グラントが`revoked`とマークされ、複製されたコピーはお客様のワークスペースに残ります。

<Note>
  Notionは、複製されたページを受信者自身のコンテンツとして扱います。Dodo Paymentsは、取り消し時にコピーを削除できません。
</Note>

## 必要な設定

| フィールド                | 必須  | 説明                            |
| -------------------- | --- | ----------------------------- |
| `notion_template_id` | Yes | テンプレートID。ダッシュボードピッカーが自動入力します。 |

## APIによる作成

<CodeGroup>
  ```typescript TypeScript theme={null} theme={null}
  const entitlement = await client.entitlements.create({
    name: 'Study Notes',
    integration_type: 'notion',
    integration_config: {
      notion_template_id: 'tmpl_abc123',
    },
  });
  ```

  ```python Python theme={null} theme={null}
  client.entitlements.create(
      name="Study Notes",
      integration_type="notion",
      integration_config={"notion_template_id": "tmpl_abc123"},
  )
  ```

  ```go Go theme={null} theme={null}
  client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
    Name:            dodopayments.F("Study Notes"),
    IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeNotion),
    IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
      dodopayments.IntegrationConfigNotionConfigParam{
        NotionTemplateID: dodopayments.F("tmpl_abc123"),
      },
    ),
  })
  ```
</CodeGroup>

## Webhooks

See [`entitlement_grant.*` webhookイベント](/developer-resources/webhooks/intents/entitlement-grant):

* `entitlement_grant.created`にはNotion `oauth_url`が含まれます。
* `entitlement_grant.delivered`はテンプレートが複製されると発火します。
* `entitlement_grant.revoked`はキャンセル時に発火し、お客様のコピーはそのまま残ります。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="Customer didn't get the template">
    お客様がNotion OAuthを完了するまで、`pending`ステータスのままです。配信メールを再送します。OAuthリンクは1週間で有効期限が切れ、その後はグラントを取消し、再作成できます。
  </Accordion>

  <Accordion title="Template picker is empty">
    ソーステンプレートを所有するワークスペースで**エンタイトルメント → 統合 → Notion**から再接続します。
  </Accordion>

  <Accordion title="Customer wants the template removed after refund">
    Notionは複製されたページのリモート削除を許可していません。お客様自身がワークスペースからコピーを削除する必要があります。
  </Accordion>
</AccordionGroup>
