Passa al contenuto principale

Notion

Disponibile

Questa integrazione è attiva e pronta per l'uso in Frihet.

Connetti il tuo workspace di Notion a Frihet. Cerca pagine, consulta database e accedi a informazioni su progetti e clienti direttamente dal tuo ERP senza cambiare applicazione.

A cosa serve?​

Con Notion integrato:

  • Cerca pagine — Trova qualsiasi pagina del tuo workspace da Frihet
  • Elenca database — Visualizza tutti i tuoi database di Notion
  • Consulta record — Esegui query ai database con filtri
  • Contesto del progetto — Accedi a informazioni sui progetti collegati alle fatture
  • Documentazione accessibile — Consulta SOP, contratti o brief senza uscire dall'ERP

Requisiti​

  • Account Notion attivo — notion.so
  • Internal Integration Token — Si crea dalle impostazioni delle integrazioni di Notion
  • Frihet Pro o superiore

Connettere Notion con Frihet​

Passo 1: Creare un'integrazione interna in Notion​

  1. Vai su notion.so/my-integrations
  2. Accedi con il tuo account Notion
  3. Clicca su New integration
  4. Configura l'integrazione:
    • Name: "Frihet ERP"
    • Associated workspace: Seleziona il tuo workspace
    • Capabilities: Spunta almeno "Read content" e "Read user information"
  5. Clicca su Submit
  6. Copia l'Internal Integration Token (inizia con ntn_...)
Salva il token

Il token può essere consultato in seguito, ma copialo ora per non dover tornare indietro.

Passo 2: Condividere le pagine con l'integrazione​

Notion richiede di condividere esplicitamente le pagine o i database con la tua integrazione:

  1. Apri la pagina o il database che vuoi che Frihet possa vedere
  2. Clicca su ... (menu della pagina) → Connections
  3. Cerca "Frihet ERP" (il nome della tua integrazione)
  4. Clicca per aggiungerla
  5. Ripeti per ogni pagina o database di cui hai bisogno
Solo ciò che condividi

L'integrazione può accedere solo alle pagine e ai database che condividi esplicitamente. Non ha accesso a tutto il tuo workspace.

Passo 3: Configurare in Frihet​

  1. Vai su Impostazioni → Integrazioni
  2. Cerca Notion
  3. Clicca su Connetti
  4. Incolla il tuo Internal Integration Token (ntn_...)
  5. Clicca su Verifica connessione
  6. Se corretto, vedrai il nome del tuo workspace

Come funziona​

Frihet usa l'API di Notion (versione 2022-06-28):

  1. Fornisci il tuo Internal Integration Token
  2. Frihet invia il token nell'header Authorization: Bearer ntn_...
  3. Inoltre, include l'header Notion-Version: 2022-06-28 in ogni richiesta
  4. Le ricerche e le query vengono eseguite su richiesta
  5. Il token viene memorizzato cifrato (AES-256-GCM) in Frihet

Dati sincronizzati​

DatoDirezioneFrequenza
Pagine (ricerca)Notion → FrihetSu richiesta
Database (elenco)Notion → FrihetSu richiesta
Record di databaseNotion → FrihetSu richiesta (query)
Proprietà di paginaNotion → FrihetAd ogni query

Funzionalità​

Cercare pagine​

Cerca qualsiasi pagina condivisa con l'integrazione per titolo o contenuto:

  1. Da Frihet, usa la funzione di ricerca di Notion
  2. Scrivi il termine di ricerca
  3. Frihet restituisce le pagine che corrispondono
  4. Clicca su un risultato per vedere i dettagli o aprire in Notion

Elencare database​

Visualizza tutti i database condivisi con l'integrazione:

  1. Frihet interroga tutti i database accessibili
  2. Mostra nome, descrizione e numero di record
  3. Selezionane uno per consultare i suoi record

Consultare database​

Esegui query a un database con filtri:

  1. Seleziona il database
  2. Applica filtri (per proprietà, stato, data, ecc.)
  3. Frihet mostra i record che corrispondono
  4. Utile per consultare, ad esempio, un database di clienti o progetti

Importare contatti​

Puoi importare contatti da qualsiasi database di Notion:

  1. Connetti il tuo account Notion
  2. Seleziona il database che contiene i tuoi contatti
  3. Frihet rileva automaticamente i campi: nome, email, indirizzo e identificazione fiscale
  4. I contatti vengono importati come clienti in Frihet
  5. I duplicati vengono rilevati per nome (non vengono importati due volte)

Frihet cerca campi con nomi come "Name", "Email", "Address", "Tax ID", "NIF" sia in inglese che in spagnolo.

Casi d'uso​

Database di clienti in Notion​

Mantiene un database di clienti in Notion con campi come azienda, contatto e note. Da Frihet, consulta questo database per ottenere contesto durante la creazione di una fattura.

Documentazione dei progetti​

Hai la documentazione di ogni progetto in Notion (brief, contratti, scope). Quando fatturi un progetto, consulti la pagina di Notion direttamente da Frihet per verificare lo scope concordato.

CRM leggero​

Usi Notion come CRM informale con un database di deal. Da Frihet, consulti lo stato di ogni deal per sapere quando è il momento di inviare una fattura.

Risoluzione dei problemi​

"Errore di autenticazione"​

  • Verifica che il token sia corretto e inizi con ntn_
  • Controlla che l'integrazione non sia stata disattivata in Notion
  • Se hai rigenerato il token, aggiornalo in Frihet

"Non trovo le mie pagine"​

  • L'integrazione vede solo le pagine che condividi esplicitamente con essa
  • Apri la pagina in Notion → ... → Connections → Aggiungi la tua integrazione
  • Le pagine figlie di una pagina condivisa sono accessibili automaticamente

"Non riesco ad accedere a un database"​

  • Condividi il database con l'integrazione (stesso processo delle pagine)
  • Verifica che l'integrazione abbia la capability "Read content" attivata

"I dati non sono aggiornati"​

  • Le query a Notion sono in tempo reale (su richiesta)
  • Se non vedi modifiche recenti, ricarica la vista in Frihet
  • Notion potrebbe impiegare qualche secondo per riflettere modifiche molto recenti

"Voglio disconnettermi"​

  1. Vai su Impostazioni → Integrazioni → Notion
  2. Clicca su Disconnetti
  3. Facoltativamente, disattiva o elimina l'integrazione su notion.so/my-integrations

Prossimi passi​