Connessioni API di Notion

Visita il nostro hub per sviluppatori per documentazione, risorse e strumenti di gestione delle connessioni.

1. Nella barra laterale sinistra, vai su Impostazioni e poi sulla scheda Connessioni.

2. Solo i proprietari dello spazio di lavoro potranno accedere alla scheda Connessioni e creare integrazioni. Se non sei un amministratore, contatta l'amministratore dello spazio di lavoro o utilizza uno spazio di lavoro diverso.

3. Fai clic sul link Sviluppa le tue connessioni in basso.

4. Le mie connessioni si apriranno nel tuo browser predefinito. Fai clic sul pulsante + Nuova connessione.

5. Fornisci un Nome per la tua connessione. Facoltativamente, puoi anche caricare un'immagine da utilizzare come Logo.

6. Usa il menu a tendina per specificare con quale spazio di lavoro associato desideri 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!

   

7. La tua connessione interna è stata aggiunta correttamente! Ora potrai vederla nel tuo spazio di lavoro, nel menu Impostazioni → Connessioni.

8. Fai clic su ••• accanto alla connessione interna per recuperare il token di connessione interna. 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.

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.

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.

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.