Connessioni API di Notion
Con l'API di Notion puoi creare connessioni interne personalizzate. Alcuni partner potrebbero richiedere un token API per collegare la loro piattaforma al tuo spazio di lavoro Notion: qui sotto ti spieghiamo come configurarlo.
Puoi gestire i token di accesso personale da Notion. Attiva la Modalità sviluppatore da Impostazioni, quindi apri i token di accesso personale dalla sezione sviluppatore nella barra laterale. Visita il nostro Centro per sviluppatori per documentazione, risorse e strumenti di gestione delle connessioni.
Nota: Ogni connessione ha uno o più proprietari e ogni proprietario può gestire la connessione e ottenere il relativo token API. Chi può creare una connessione dipende dal tuo piano e dalle impostazioni del tuo spazio di lavoro. Scopri di più sulle impostazioni delle connessioni Enterprise →
Cerchi token di amministratore? I token su questa pagina funzionano all'interno di uno spazio di lavoro e gestiscono il contenuto della pagina. Se devi eseguire attività di amministratore dell'organizzazione, come esporta, blocco legale o logout degli utenti, consulta le API di amministratore per le organizzazioni Enterprise.
Di quale token ho bisogno? Notion usa diversi tipi di token. Questo articolo spiega come usare il token API, che copi per una connessione interna. I token di accesso personale sono legati al tuo account. OAuth gestisce l'accesso alle app. Se una piattaforma partner ti chiede un token per una connessione che hai creato, usa il token API.
Nella barra laterale sinistra, vai su
Impostazionie poi sulla schedaConnessioni.Chi può creare una connessione dipende dal tuo spazio di lavoro. Nei piani Gratuito e Plus, solo i proprietari dello spazio di lavoro possono creare connessioni. Nei piani Business ed Enterprise, i proprietari dello spazio di lavoro possono anche consentire ai membri, o ai membri di determinati gruppi, di crearle. Se non riesci a creare una connessione, chiedi a un proprietario dello spazio di lavoro.
Attiva la Modalità sviluppatore, quindi apri i token di accesso personale dalla sezione sviluppatore nella barra laterale.
Clicca su
+ Nuova connessione.Fornisci un
Nomeper la tua connessione. Facoltativamente, puoi anche caricare un'immagine da utilizzare comeLogo.Usa il menu a tendina per specificare con quale
spazio di lavoro associatodesideri utilizzare questa connessione.
Nota: Assicurati di aver effettuato l'accesso a Notion nella tua sessione web con lo stesso account utilizzato sul desktop. In caso contrario, non vedrai l'account e gli spazi di lavoro corretti!

La tua connessione interna è stata aggiunta correttamente! Ora potrai vederla nel tuo spazio di lavoro, nel menu
Impostazioni→Connessioni.Fai clic su
•••accanto alla connessione interna per copiare il suo token API. Avrai bisogno di questo token per qualsiasi automazione o workflow basato su API creato dal tuo team, o per collegare il tuo spazio di lavoro ad alcune piattaforme partner.

Nota: Le connessioni interne sono specifiche dello spazio di lavoro, pertanto per modificare lo spazio di lavoro associato, dovrai creare una nuova connessione.

Ogni connessione interna ha almeno un proprietario. I proprietari possono modificare le impostazioni della connessione e ottenere il relativo token API. Puoi condividere la proprietà per consentire a più persone di gestire la stessa connessione. Così il lavoro non si interrompe se qualcuno cambia ruolo o lascia lo spazio di lavoro.
Per aggiungere o rimuovere un proprietario:
Apri il portale per sviluppatori e seleziona la tua connessione.
Apri la scheda
Proprietari della connessione.Aggiungi un membro o un gruppo come proprietario, oppure rimuovilo.
Ecco cosa sapere sui proprietari delle connessioni:
Solo i membri a pieno titolo e i proprietari dello spazio di lavoro possono essere proprietari. Gli ospiti e i membri con accesso limitato non possono esserlo.
Le impostazioni del tuo spazio di lavoro su chi può creare connessioni determinano anche chi puoi aggiungere come proprietario.
Ogni connessione deve avere almeno un proprietario, quindi non puoi rimuovere l'ultimo.
Se sei proprietario dello spazio di lavoro e devi assumere la gestione di una connessione, aggiungiti prima come proprietario.
Se l'ultimo proprietario lascia lo spazio di lavoro, il token API della connessione smette di funzionare immediatamente.
Puoi condividere la proprietà con i piani Plus, Business ed Enterprise, usando Notion nel browser o nell'app per desktop.
Tutte le connessioni appena aggiunte sono inizialmente interne. Se sei uno sviluppatore che lavora a una connessione pubblica, utilizza prima le istruzioni sopra riportate per creare una connessione interna.
Quindi, segui le istruzioni nella nostra guida per gli sviluppatori per convertirla in una connessione pubblica.
Quando crei una connessione pubblica, scegli chi può installarla:
Qualsiasi spazio di lavoro: chiunque può installare la tua connessione nel proprio spazio di lavoro Notion.Spazi di lavoro selezionati: la tua connessione può essere installata solo negli spazi di lavoro che hai indicato.
Scegli Spazi di lavoro selezionati se crei una connessione solo per la tua azienda e non vuoi che altre organizzazioni la installino.
Notion esegue questo controllo ogni volta che qualcuno installa la tua connessione. Se il loro spazio di lavoro non è nel tuo elenco, l'installazione si interrompe e visualizzano un errore.
Solo le connessioni che chiunque può installare possono essere elencate nella galleria delle connessioni. Una connessione limitata a spazi di lavoro selezionati non verrà visualizzata lì.
Nota: Scegli questa opzione quando crei la connessione. Se in seguito ti serve un'impostazione diversa, crea una nuova connessione.
Una connessione di tua proprietà compare nel portale per sviluppatori di ogni spazio di lavoro autorizzato a installarla, in cui è già installata o in cui l’hai creata.
Ogni connessione pubblica ha uno spazio di lavoro in cui la crei e la testi. Puoi passare a uno diverso senza ricominciare da capo.
Apri la tua connessione nel portale per sviluppatori.
Vai alle impostazioni della connessione.
Scegli lo spazio di lavoro in cui vuoi creare la connessione.
Notion collega la tua connessione allo spazio di lavoro che hai scelto. Non devi creare una nuova connessione.
Durante il processo di configurazione dell'app, gli sviluppatori potranno scegliere il livello di accesso richiesto all'utente.
Funzionalità del contenuto:
Solo lettura del contenuto
Solo scrittura del contenuto
Inserisci contenuto
Funzionalità dell'utente
Nessuna informazione dell'utente
Leggi le informazioni utente (escluso l'indirizzo email dell'utente)
Leggi le informazioni utente (inclusa l'email)
Quando gli utenti installano le connessioni, questo livello di accesso verrà visualizzato. Apparirà anche nel menu Condividi di qualsiasi pagina a cui è stata aggiunta la connessione. Scopri di più sull'installazione delle connessioni in uno spazio di lavoro →
I webhook di connessione consentono alle connessioni di monitorare e rispondere alle modifiche negli spazi di lavoro Notion in tempo reale.
Quando si verificano modifiche nelle pagine o nei database condivisi con la tua connessione, Notion invia automaticamente notifiche al tuo endpoint webhook, consentendo alla tua connessione di aggiornare istantaneamente altri strumenti, eseguire attività automatizzate o visualizzare le ultime modifiche.
Per le istruzioni, visita la nostra documentazione per sviluppatori.
I webhook di connessione attualmente non supportano le notifiche per:
Modifiche utente (incluse modifiche all'appartenenza allo spazio di lavoro, aggiornamenti di email/nome e modifiche ai permessi).
Modifiche alle impostazioni dello spazio di lavoro e del teamspace.
Per questi tipi di notifiche, utilizza invece il registro di controllo.
Le azioni webhook e i webhook di connessione presentano alcune somiglianze: entrambi hanno trigger e possono inviare eventi a servizi di terze parti. Tuttavia, i webhook di connessione offrono funzionalità più ampie:
Possono monitorare l'attività in più spazi di lavoro.
Possono gestire un numero illimitato di azioni.
Al contrario, le azioni webhook sono progettate per casi d'uso più semplici e vengono configurate tramite automazioni di database con un set limitato di trigger.
