Collega Notion

La connessione Notion di FyneDesk consente al tuo team di inviare il contesto dei ticket a Notion, sincronizzare gli articoli della knowledge base con le pagine Notion e permettere all'AI di usare contenuti Notion selezionati durante la stesura di risposte, riepiloghi e suggerimenti di smistamento.

Cosa fa la connessione

• Ticket → Notion: crea una pagina Notion collegata in un database selezionato quando un ticket viene creato, scalato o etichettato.
• Sincronizzazione knowledge base: pubblica su Notion gli articoli della knowledge base di proprietà di FyneDesk, oppure importa pagine Notion selezionate come articoli della knowledge base di proprietà di Notion.
• Fonte di conoscenza per l'AI: consenti all'AI di FyneDesk di usare pagine e database Notion selezionati insieme alla tua knowledge base e ai ticket passati. Se mappi gli stati, le modifiche in Notion possono anche aggiornare lo stato del ticket FyneDesk collegato.

Prima di iniziare

• Devi essere un amministratore dell'organizzazione FyneDesk.
• Il tuo spazio di lavoro FyneDesk deve essere sul piano Pro.
• Hai bisogno dell'accesso allo spazio di lavoro, alle pagine e ai database Notion che vuoi far usare a FyneDesk.
• Non è necessario creare un'app per sviluppatori Notion né configurare i webhook di Notion. FyneDesk gestisce la connessione dopo che l'hai autorizzata in Notion.

Passaggio 1 — Collega Notion

1. In FyneDesk, apri Impostazioni → Connessioni → Notion.
2. Fai clic su Collega.
3. Notion apre una schermata di autorizzazione. Scegli lo spazio di lavoro corretto.
4. Nel selettore di pagine Notion, seleziona le pagine e i database che FyneDesk dovrebbe poter usare.
5. Torna a FyneDesk. La pagina della connessione Notion dovrebbe mostrare lo stato della connessione e le opzioni di configurazione.

Passaggio 2 — Attiva la connessione

L'interruttore principale di attivazione parte disattivato. Dopo aver collegato Notion, attiva la connessione dalla pagina delle impostazioni Notion. Tienila disattivata se vuoi finire di scegliere database, regole di sincronizzazione e fonti AI prima che qualcosa inizi a muoversi.

Passaggio 3 — Configura Ticket → Notion

Usa Ticket → Notion quando un ticket deve diventare lavoro pianificato in Notion, come una scalation di ingegneria, un bug di prodotto, una richiesta di funzionalità, una lacuna nella documentazione o un follow-up operativo.

1. Scegli il database di destinazione in Notion. È il database in cui FyneDesk crea la pagina collegata.
2. Scegli il trigger: alla creazione, alla scalation o all'etichettatura.
3. Facoltativamente, mappa i campi FyneDesk alle proprietà Notion così che la pagina Notion arrivi con i campi corretti di stato, responsabile, priorità o categoria per il tuo flusso di lavoro.

Quando il trigger viene eseguito, FyneDesk crea una pagina Notion con il titolo del ticket, i campi chiave e un link di ritorno al ticket. FyneDesk non crea pagine Notion duplicate per lo stesso ticket.

Passaggio 4 — Configura la sincronizzazione KB ↔ Notion

La sincronizzazione della knowledge base ha due direzioni. Puoi usarne una sola o entrambe, a seconda di dove ogni articolo dovrebbe essere modificato.

• Destinazione di pubblicazione: scegli la posizione Notion in cui devono essere pubblicati gli articoli della knowledge base di proprietà di FyneDesk.
• Fonti di importazione: scegli le pagine o i database Notion che devono essere importati in FyneDesk come articoli della knowledge base di proprietà di Notion.
• Proprietario predefinito: scegli se gli articoli appena collegati debbano essere di proprietà di Notion o di FyneDesk.

Come funziona la proprietà degli articoli

Ogni articolo sincronizzato ha un solo proprietario, chiamato anche fonte di verità. Se l'articolo è di proprietà di FyneDesk, modificalo in FyneDesk e Notion ne mostra una copia in sola lettura. Se l'articolo è di proprietà di Notion, modificalo in Notion e FyneDesk ne mostra una copia in sola lettura.

Il lato copia può mostrare un badge “modificato in Notion” o “modificato in FyneDesk” così che il tuo team sappia dove devono avvenire le modifiche. FyneDesk non unisce modifiche concorrenti tra i due lati. Per cambiare dove un articolo dovrebbe essere modificato, cambia il proprietario di quell'articolo.

Passaggio 5 — Consenti all'AI di usare Notion

Per rendere i contenuti Notion disponibili all'AI di FyneDesk, scegli le pagine o i database Notion sotto le fonti AI e attiva l'interruttore della fonte AI. Questo interruttore parte disattivato per impostazione predefinita.

Quando è attivo, le bozze di risposta dell'AI, i riepiloghi e i suggerimenti di smistamento possono attingere ai contenuti Notion selezionati insieme alla tua knowledge base di FyneDesk e ai ticket passati. Modificare una pagina Notion selezionata aggiorna la fonte di conoscenza dell'AI dopo l'esecuzione di sincronizzazione e indicizzazione.

Passaggio 6 — Riporta gli stati Notion ai ticket

Se il tuo tracker Notion usa gli stati, puoi mappare i valori di stato Notion agli stati o alle azioni dei ticket FyneDesk. Dopo la mappatura, cambiare lo stato sulla pagina Notion collegata può aggiornare il ticket collegato in FyneDesk.

La sincronizzazione degli stati è a prova di loop: un aggiornamento di stato non dovrebbe rimbalzare all'infinito tra FyneDesk e Notion.

Monitora lo stato della connessione

La pagina della connessione Notion mostra dettagli sullo stato come l'orario dell'ultima sincronizzazione o evento e lo stato dell'abbonamento. Controlla quest'area quando un ticket, un articolo o una fonte AI non sembra aggiornato.

Limiti da conoscere

• FyneDesk vede solo le pagine e i database selezionati nel selettore di autorizzazione di Notion.
• La sincronizzazione della knowledge base non è un clone perfetto del layout di Notion. Testo semplice, intestazioni, elenchi, tabelle, immagini, blocchi di codice, citazioni, toggle e callout si convertono in modo pulito. Embed, anteprime dei link e layout complessi possono essere semplificati o sostituiti con segnaposto.
• Le pagine Notion molto grandi, intorno a 20.000 blocchi o più, possono essere troncate.
• La sincronizzazione non è istantanea. Concedi un minuto o qualche minuto affinché le modifiche compaiano.
• Ogni articolo KB sincronizzato ha un unico proprietario. Il lato copia è in sola lettura finché non cambi la proprietà.
• La connessione Notion richiede il piano Pro.

Risoluzione dei problemi

FyneDesk chiede di ricollegare Notion. L'autorizzazione Notion potrebbe essere scaduta o essere stata revocata. Apri Impostazioni → Connessioni → Notion e collega di nuovo. La sincronizzazione riprende dopo il ripristino della connessione.

Un ticket o un articolo non si sincronizza. Verifica che l'interruttore principale sia attivo, che l'interruttore della funzione pertinente sia attivo e che la pagina o il database Notion sia stato condiviso con FyneDesk durante l'autorizzazione. Per gli articoli KB, controlla anche quale lato è proprietario dell'articolo.

L'AI non usa i contenuti Notion. Verifica che l'interruttore della fonte AI sia attivo, che la pagina o il database sia selezionato come fonte AI e che sia trascorso tempo sufficiente per sincronizzazione e indicizzazione.

Non trovo una pagina o un database Notion in FyneDesk. Ricollega Notion e assicurati che quell'elemento sia selezionato nel selettore di pagine Notion. FyneDesk non può elencare pagine o database a cui non è stato autorizzato ad accedere.

Gestisci o scollega

Per cambiare le pagine condivise, aggiornare i permessi o recuperare da un accesso revocato, ricollega Notion dalla stessa pagina. Per interrompere l'integrazione, fai clic su Scollega. Lo scollegamento rimuove i token e la configurazione Notion memorizzati da FyneDesk e mette in pausa la sincronizzazione Notion finché un amministratore non collega di nuovo.

Privacy e accesso

L'accesso a Notion è limitato alle pagine e ai database selezionati dal tuo amministratore in Notion. FyneDesk non riceve accesso all'intero spazio di lavoro Notion a meno che quelle pagine non vengano esplicitamente condivise. La connessione è a livello di organizzazione, quindi gli amministratori dovrebbero selezionare solo le pagine e i database necessari per il passaggio dei ticket, la sincronizzazione della KB e la conoscenza dell'AI.