Cosa configurerai
- Una connessione OAuth che dà a Elido accesso solo alle pagine e ai database Notion che selezioni.
- Un quadro chiaro di ciò che la connessione Beta fa oggi e di ciò che resta pianificato.
- Un flusso fai da te che riempie una tabella Notion con i webhook di Elido e l'API di analytics.
L'integrazione Notion è una connessione OAuth in Beta. Puoi collegare un workspace e scegliere quali pagine e database Elido può vedere, e Elido conserva il token di accesso. Non vengono create righe né scritti conteggi dei clic. La sincronizzazione dei database è pianificata. Le sezioni seguenti mostrano cosa funziona oggi e una via DIY che puoi costruire subito. Per la ricetta completa, leggi Notion database link sync.
Cosa funziona oggi
- Collegare un workspace tramite OAuth da Dashboard → Integrations → Notion → Connect.
- Scegliere nel selettore di pagine di Notion a quali pagine e database Elido può accedere. Elido non vede nulla che tu non abbia selezionato.
- Vedere se la connessione è attiva e scollegarla. Scollegando, Elido la contrassegna come revocata. Rimuovi la connessione anche in Notion, in Settings → Connections, così il token smette di essere valido.
Cosa è pianificato
Una sincronizzazione bidirezionale tra un database Notion e la tua libreria di link Elido: slug, destinazione, tag e conteggi dei clic come righe, mappatura delle colonne e creazione di link da Notion. Non è fissata alcuna data.
Collegare tramite OAuth
- Vai su Dashboard → Integrations → Notion → Connect.
- Si apre la schermata OAuth di Notion. Accedi con l'account che ha accesso al tuo workspace.
- Nel selettore di pagine di Notion, scegli le pagine o i database da condividere. Potrai aggiungerne altri in seguito senza riautorizzare.
- Fai clic su Allow access. Notion ti riporta su Elido.
DIY: riempire una tabella Notion da Elido
- In Notion, crea un database con una colonna titolo, due colonne URL (link breve e destinazione) e una colonna numerica (clic). Crea un'integrazione interna in Notion e condividi con essa il database.
- In Elido, vai su Dashboard → Webhooks → Add → Generic e attiva
link.created,link.updatedelink.expired. Puntalo a un piccolo script o a un'automazione che verifichi la firma HMAC (vedi la guida ai Webhook) e poi chiami l'API di Notion per aggiungere o aggiornare una riga. - Per i conteggi dei clic, esegui un job pianificato che legga l'API di analytics di Elido e aggiorni la colonna numerica. Non esiste un webhook per ogni clic, quindi i conteggi non possono essere inviati in tempo reale.
Notion limita le richieste API a circa 3 al secondo per connessione. In caso di HTTP 429, attendi l'header Retry-After prima di riprovare.
Risoluzione dei problemi
Il database non compare nel selettore. Notion mostra solo le pagine che concedi esplicitamente. Esegui di nuovo la connessione e seleziona le pagine o i database corretti.
In Notion non compaiono righe né conteggi dei clic. È previsto. Per ora non si sincronizza nulla. Usa la via DIY qui sopra.
OAuth revocato o scaduto. I token smettono di funzionare se la connessione viene rimossa lato Notion. Ricollega da Dashboard → Integrations → Notion → Reconnect.