> ## 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 Entitlement

> Duplica un modello di Notion nello spazio di lavoro del cliente quando lo acquista.

<Info>
  L'entitlement di Notion duplica un modello che hai preparato nello spazio di lavoro del cliente pagante. Il cliente autorizza tramite OAuth, sceglie lo spazio di lavoro in cui vuole copiare il modello, e Dodo Payments gestisce la duplicazione.
</Info>

## Cosa viene consegnato

* Al cliente viene chiesto di connettere il proprio spazio di lavoro Notion tramite OAuth.
* Una volta autorizzato, Dodo Payments duplica il modello configurato nello spazio di lavoro scelto.
* In caso di cancellazione, il modello duplicato rimane nello spazio di lavoro del cliente (Notion non supporta la cancellazione remota). La concessione è segnata `revoked` per mantenere i registri.

Gli usi comuni includono modelli Notion a pagamento, sistemi di produttività e modelli OS/CRM.

## Connetti Notion

<Steps>
  <Step title="Open Entitlements">
    Nel dashboard di Dodo Payments, vai a **Entitlements** e clicca su **+**.
  </Step>

  <Step title="Pick Notion">
    Scegli **Notion Template** come integrazione. Se Notion non è ancora connesso, ti verrà chiesto di **Connettere 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="Nuovo pannello di entitlement che richiede al commerciante di connettere Notion" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1133" data-path="images/entitlements/notion/connect-prompt.png" />
    </Frame>

    Facendo clic si apre Notion in una nuova scheda. Accedi allo spazio di lavoro che possiede i tuoi modelli sorgente, rivedi i permessi richiesti da Dodo Payments e scegli le pagine (modelli) che l'integrazione può leggere e duplicare.

    <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="Schermata permessi OAuth di Notion per Dodo Payments" 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="Selezionatore di pagine Notion scegliendo quali modelli Dodo Payments può accedere" style={{ maxHeight: '420px', width: 'auto' }} width="2000" height="1138" data-path="images/entitlements/notion/oauth-select-pages.png" />
      </div>
    </Frame>

    Quando Notion reindirizza indietro, vedrai una conferma che lo spazio di lavoro è connesso.

    <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="Pagina di conferma Notion Template connesso con successo" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1143" data-path="images/entitlements/notion/connected.png" />
    </Frame>
  </Step>

  <Step title="Pick a template">
    Torna al dashboard, seleziona il **modello** da duplicare dal selezionatore di modelli. Solo le pagine che hai autorizzato nel passaggio precedente appaiono qui. Dai un **nome** all'entitlement e fai clic su **Crea Entitlement**.

    <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="Modulo di entitlement Notion con spazio di lavoro connesso, selezionatore di modelli e campo nome" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1135" data-path="images/entitlements/notion/create.png" />
    </Frame>
  </Step>

  <Step title="Save the entitlement">
    Salva e allega a qualsiasi prodotto.
  </Step>
</Steps>

## Flusso del cliente

1. Il cliente completa il pagamento.
2. Dodo Payments crea una concessione in stato `pending` con un Notion `oauth_url` per il cliente per connettere il proprio spazio di lavoro.
3. Il cliente autorizza tramite il link nella loro email o nel portale clienti e sceglie lo spazio di lavoro in cui desidera duplicare il modello.
4. Dodo Payments duplica il modello. La concessione passa a `delivered`.
5. In caso di revoca, la concessione è segnata `revoked`; la copia duplicata rimane nello spazio di lavoro del cliente.

<Note>
  Notion considera intenzionalmente una pagina duplicata come contenuto del destinatario. Dodo Payments non può eliminare la copia in caso di revoca.
</Note>

## Configurazione necessaria

| Campo                | Richiesto | Descrizione                                                  |
| -------------------- | --------- | ------------------------------------------------------------ |
| `notion_template_id` | Sì        | L'ID del modello. Il selezionatore del dashboard lo compila. |

## Creazione tramite 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>

## Webhook

Consulta [eventi webhook `entitlement_grant.*`](/developer-resources/webhooks/intents/entitlement-grant):

* `entitlement_grant.created` include il Notion `oauth_url`.
* `entitlement_grant.delivered` si attiva una volta duplicato il modello.
* `entitlement_grant.revoked` si attiva alla cancellazione; la copia del cliente rimane intatta.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Customer didn't get the template">
    La concessione rimane `pending` fino a quando il cliente non completa l'OAuth di Notion. Rimanda l'email di consegna; il link OAuth scade dopo una settimana, dopodiché puoi revocare e ricreare la concessione.
  </Accordion>

  <Accordion title="Template picker is empty">
    Riconnetti Notion da **Entitlements → Integrations → Notion** con lo spazio di lavoro che possiede i modelli sorgente.
  </Accordion>

  <Accordion title="Customer wants the template removed after refund">
    Notion non consente la cancellazione remota delle pagine duplicate. Il cliente deve eliminare la copia dal proprio spazio di lavoro.
  </Accordion>
</AccordionGroup>
