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

# Connettere Notion alla tua app

> Leggi e scrivi pagine e database di Notion, aggiungi commenti ed esegui workflow dalla tua app, con un account Notion condiviso o con l'account Notion di ogni persona.

Connetti la tua app a Notion per leggere e scrivere pagine e database, aggiungere commenti ed eseguire workflow quando qualcosa cambia nel tuo workspace Notion. Usa un unico account condiviso per tutta l'app, oppure lascia che ogni persona colleghi il proprio account Notion.

***

## Cosa puoi fare

Porta le tue pagine e i tuoi database di Notion nei workflow della tua app.

> [card] Sincronizza i database
>
> Mostra nella tua app le righe di un database Notion, oppure mantieni un database allineato con i record della tua app.

> [card] Scrivi pagine
>
> Crea pagine Notion dalla tua app, ad esempio una pagina per ogni nuovo cliente, oppure aggiungi aggiornamenti a una pagina esistente.

> [card] Lavora con i commenti
>
> Leggi i commenti di una pagina e aggiungine di nuovi dalla tua app.

> [card] [Esegui workflow](https://docs.base44.com/it/Building-your-app/Creating-workflows.md#connector)
>
> Avvia un workflow quando una pagina o un database viene creato, aggiornato, spostato o eliminato, oppure quando qualcuno commenta.

**Prompt di esempio**

Nella chat AI, descrivi la pagina o il database, cosa avvia l'azione ed eventuali campi dinamici. Per esempio:

```text wrap theme={null}
Sincronizza un database Notion con i record del mio CRM.
```

```text wrap theme={null}
Scrivi gli aggiornamenti dei progetti da questa app in una pagina Notion.
```

```text wrap theme={null}
Mostra nella mia dashboard l'avanzamento delle checklist Notion per l'onboarding del team.
```

```text wrap theme={null}
Crea nuove pagine Notion per ogni nuovo cliente aggiunto nella mia app.
```

***

## Connettere Notion

Scegli come si collegano le persone: un unico account condiviso per tutta l'app, oppure l'account personale di ogni persona.

> [tab] Connettore condiviso
>
> Collega un account Notion. Ogni app che usa la connessione, e chiunque usi quelle app, condivide l'account e le pagine che può vedere.
>
> **Per aggiungere un connettore Notion condiviso:**
>
> 1. Clicca **Connectors** nella barra laterale del workspace.
>
> 2. Clicca **Add connector**.
>
> 3. Cerca **Notion** e cliccaci sopra.
>
> 4. Seleziona **Shared connector**, poi clicca **Next**.
>
> 5. Inserisci un **Connection name**.
>
> 6. Scegli dove può essere usata la connessione in **Who can access**:
>    * **Apps and Super agent:** possono usarla sia le tue app sia il tuo Superagent. È l'opzione predefinita.
>    * **Apps only:** possono usarla solo le tue app.
>    * **Super agent only:** può usarla solo il tuo Superagent.
>
> 7. Scegli cosa può fare la tua app in **Permissions**. **read content** e **read comment** sono già selezionati. Aggiungi quelli che servono alla tua app:
>
>    * **insert content:** crea pagine e aggiunge righe ai database.
>    * **update content:** modifica pagine e righe di database esistenti.
>    * **insert comment:** aggiunge commenti.
>
>    ![Configurazione del connettore Notion condiviso con Connection name, Who can access e Permissions, con read content e read comment selezionati](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-shared-setup.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=4613834e2b9b1e12620ed0d4c2e5a189)
>
>    Configurare un connettore Notion condiviso
>
> 8. Clicca **Add connector**.
>
> 9. Accedi a Notion e scegli le pagine che la tua app può usare. Scopri di più nella guida di Notion per [installare una connessione](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).

> [tab] Connettore per utenti dell'app
>
> Ogni persona collega il proprio account Notion, così la tua app può lavorare con le pagine che sceglie di condividere.
>
> > [!WARNING]
> >
> > Solo proprietari e admin del workspace possono configurarlo.
>
> > [!TIP]
> >
> > **Prima di configurarlo:** ti servono un'integrazione Notion pubblica e il suo Client ID e Client Secret. Consulta [Usare il tuo client OAuth](https://docs.base44.com/it/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Per aggiungere un connettore Notion per utenti dell'app:**
>
> 1. Clicca **Connectors** nella barra laterale del workspace.
>
> 2. Clicca **Add connector**.
>
> 3. Cerca **Notion** e cliccaci sopra.
>
> 4. Seleziona **App user connector**, poi clicca **Next**.
>
> 5. Copia il **Callback URL**.
>
> 6. Aggiungi il Callback URL come URI di reindirizzamento nelle impostazioni della tua integrazione Notion.
>
> 7. Compila il modulo **Add Notion Connection**:
>
>    * **Connector name:** un nome che riconoscerai in seguito.
>    * **Client ID** e **Client Secret:** copiali dalle impostazioni della tua integrazione Notion.
>
>    ![Modulo Add Notion Connection con Callback URL, Connector name, Client ID e Client Secret](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-app-user-credentials.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=2d7f3ef817379a121bb34c45ca966c6a)
>
>    Inserire le credenziali della tua integrazione Notion
>
> 8. Clicca **Add Connector**.
>
> 9. Apri la tua app nell'editor dell'app.
>
> 10. Chiedi alla chat AI di aggiungere un modo per permettere alle persone di collegare il proprio account Notion.

***

## Scope e permessi

Controlli l'accesso della tua app a Notion in 2 posti. In Base44 scegli cosa può fare la tua app. In Notion, chi accede sceglie quali pagine può vedere.

> [card]
>
> **1. Scegli in Base44**
>
> Per un connettore condiviso, scegli cosa può fare la tua app in **Permissions**. Per impostazione predefinita, la tua app può leggere pagine, database e commenti. Aggiungi i permessi di scrittura quando deve anche creare o modificare pagine, righe o commenti.
>
> Per un connettore per utenti dell'app, ciò che la tua app può fare dipende dalle capacità impostate nella tua integrazione Notion.
>
> **2. Scegli in Notion**
>
> Chi accede a Notion sceglie le pagine che la tua app può usare. Per un connettore condiviso sei tu, per un connettore per utenti dell'app è ogni persona. Scopri di più nella guida di Notion per [installare una connessione](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).
>
> **Accesso:** la tua app lavora con le pagine e i database condivisi durante l'accesso, nel workspace Notion a cui la persona ha effettuato l'accesso. Ogni connessione mostra il nome del suo workspace Notion, così puoi distinguere le connessioni.

***

## Usare le funzioni backend

Una volta collegato Notion, le tue funzioni backend possono recuperare un token di accesso e chiamare direttamente la Notion API. Base44 gestisce l'accesso per te.

* Per una connessione condivisa, usa `getConnection()` per recuperare il token.
* Per una connessione per utenti dell'app, usa `getCurrentAppUserConnection()`, così ogni richiesta usa il token della persona che ha effettuato l'accesso.

Chiama la Notion API su `api.notion.com`. Passa il token nell'header `Authorization` e la versione dell'API nell'header `Notion-Version`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("notion");

const response = await fetch("https://api.notion.com/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Notion-Version": "2025-09-03",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "Clients" }),
});
const { results } = await response.json();
```

> [card] [Connettori condivisi](https://docs.base44.com/it/developers/backend/resources/connectors/shared-connectors.md)
>
> Configura, distribuisci e chiama una connessione condivisa da una funzione backend.

> [card] [Connettori per utenti dell'app](https://docs.base44.com/it/developers/backend/resources/connectors/app-user-connectors.md)
>
> Recupera un token per utente e chiama l'API come la persona che ha effettuato l'accesso.

***

## Risoluzione dei problemi

Se Notion smette di funzionare nella tua app, controlla la connessione e le pagine che può vedere.

> [accordion] La connessione deve essere ricollegata
>
> Se la tua app perde l'accesso a Notion o il suo accesso scade, la connessione mostra una sezione **Reconnect this connection**.
>
> * **Connettore condiviso:** [ricollegalo](https://docs.base44.com/it/Integrations/Connectors.md#managing-your-connectors) e accedi con lo stesso account Notion. Ogni app che lo usa torna a funzionare.
> * **Connettore per utenti dell'app:** ogni persona ricollega il proprio account Notion dall'interno della tua app.

> [accordion] La tua app non trova una pagina o un database
>
> La tua app vede solo le pagine condivise con la connessione. Ricollegala e scegli la pagina in Notion, oppure [aggiungi la connessione alla pagina](https://www.notion.com/help/add-and-manage-connections-with-the-api#add-connections-to-pages) in Notion.

> [accordion] Un workflow viene eseguito troppo spesso
>
> Notion invia un evento ogni volta che il contenuto di una pagina cambia, quindi un workspace molto attivo può avviare un workflow molte volte. Chiedi alla chat AI di aggiungere una condizione, così il workflow viene eseguito solo per una pagina o un database.

> [!NOTE]
>
> Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md).


## Related topics

- [Connettere Slack alla tua app](https://docs.base44.com/it/Integrations/slack-connectors.md)
- [Connettere Snowflake alla tua app](https://docs.base44.com/it/Integrations/snowflake-connector.md)
- [Connettere Databricks alla tua app](https://docs.base44.com/it/Integrations/databricks-connector.md)
- [Connettere Wix alla tua app](https://docs.base44.com/it/Integrations/wix-connector.md)
- [Connettere Google Maps alla tua app](https://docs.base44.com/it/Integrations/google-maps-connector.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.