Sincronizzazione con Notion
Collega un modello a uno dei tuoi database Notion e ogni invio diventa una riga lì: creata quando il modulo viene inviato, aggiornata quando il documento cambia in seguito.
1 · Collega il tuo workspace
In Notion, crea una connessione interna (su notion.so/my-integrations; le Impostazioni di Pocper rimandano lì) e copia il suo token API interno. Incollalo in Impostazioni → Integrazioni → Notion di Pocper. Solo il proprietario del team può farlo, e il token viene conservato cifrato. Per cambiarlo, usa «Sostituisci il token» nella stessa pagina: il nuovo token viene verificato prima di sostituire quello vecchio.
Poi condividi con quella connessione il database in cui vuoi scrivere, o la pagina che lo contiene: aprilo in Notion, scegli ••• → Connessioni → Aggiungi connessioni (in alcune versioni, Connessioni si trova sotto ••• → More) e seleziona la tua connessione. Senza questo passaggio il database non compare nell'elenco di Pocper, e un link incollato viene segnalato come non trovato.
2 · Collega un modello a un database
Apri il pannello Spazio di lavoro del modello, scegli la scheda Integrazione e premi «Collega un database Notion». Scegli un database che la tua connessione può vedere (scrivi per cercare) o incolla il suo link. La prima riga, «Nuovo database», ne crea uno in una pagina a tua scelta, con una colonna per ogni campo, già associata, e una colonna Pocper ID.
Ogni campo ha un selettore delle colonne di tipo compatibile: un campo data a una colonna data, una casella di spunta a una casella di spunta, il testo a una colonna di testo o al titolo. Sotto «Dettagli dell'invio» puoi associare anche il cliente, quando è stato inviato, lo stato e chi l'ha inviato.
Ogni documento creato dal modello copia queste impostazioni al momento della creazione, e la sua scheda Integrazione può cambiarle solo per lui. Una modifica successiva al modello raggiunge solo i documenti nuovi; per quelli che seguono ancora le impostazioni precedenti, il modello propone «Applica anche a questi». Un documento creato prima che il modello fosse collegato propone «Usa le impostazioni del modello».
3 · Cosa succede all'invio
Quando un modulo viene inviato — da chi lo compila, o perché lo segni tu come inviato — una riga viene creata in pochi secondi. In «Sincronizzazione», la scheda Integrazione del documento dice poi quando è avvenuta l'ultima sincronizzazione, con un link alla riga, oppure che una modifica è in attesa o non è riuscita; «Sincronizza ora» compare solo se l'invio non è riuscito o il documento non è mai stato inviato. Per creare la riga non appena il documento esiste, cambia «Quando sincronizzare» nelle impostazioni Integrazione del modello.
Le modifiche successive aggiornano la stessa riga pochi secondi dopo l'ultima, e annullare un documento aggiorna la sua colonna dello stato.
La pagina della riga riceve un segnalibro che rimanda al documento e le risposte in forma di elenco (quelle molto lunghe accorciate, al massimo cento). Dalle impostazioni Integrazione del modello si può disattivare il corpo della pagina.
4 · File, firme e duplicati
I file caricati e le firme possono andare in una colonna Files & media: il file viene copiato in Notion, fino a 20 MB (uno più grande viene saltato e annotato nel registro di sincronizzazione). Mandarli come link in una colonna URL è un interruttore a parte, disattivato per impostazione predefinita, perché chiunque veda la riga potrebbe aprire un link del genere senza accedere a Pocper.
La protezione dai duplicati evita che un invio ritentato compaia due volte: Pocper scrive il Pocper ID di ogni documento in una colonna di testo con quel nome e ritrova la riga grazie a esso. Un database che ha già quella colonna la usa; altrimenti la finestra di collegamento la aggiunge (la casella è spuntata per impostazione predefinita), oppure le Impostazioni della scheda Integrazione la aggiungono con un clic.
5 · Modifiche fatte in Notion
Attiva la sincronizzazione inversa nella scheda Integrazione e due cose tornano da Notion. Portare la colonna dello stato a Submitted, Cancelled o Collected porta il documento a quello stato; modificare una cella associata a un campo di testo, casella di spunta, data o ora scrive il valore nel documento, e la sua cronologia mostra la modifica come arrivata da Notion. Se entrambe le parti hanno cambiato una cella, vince il valore di Notion — tranne mentre un cliente sta ancora compilando il modulo (non inviato, e salvato negli ultimi dieci minuti): allora resta il suo valore, la cella in Notion viene ripristinata e la scheda Integrazione lo annota.
La sincronizzazione inversa richiede un webhook, impostato una volta per team dal proprietario in Impostazioni → Integrazioni → Notion: crea l'URL del webhook, aggiungilo come sottoscrizione nella scheda Webhooks della tua connessione in Notion e incolla il token di verifica che Notion invia. Pocper non interroga mai Notion da solo, quindi senza webhook le modifiche fatte in Notion restano lì. Una colonna che non può riportare indietro un valore — una firma, un file, qualsiasi campo di un documento bloccato — viene ripristinata in Notion, e la scheda Integrazione lo annota.
6 · Quando qualcosa va storto
Una riga che non è stato possibile mandare viene ritentata, a intervalli sempre più lunghi, per un giorno. Se i tentativi si esauriscono, o se Notion la rifiuta del tutto — token revocato, o database non più condiviso —, la sincronizzazione si ferma, e il proprietario del team e chi ha collegato il database ricevono una notifica nell'app che apre la scheda Integrazione del documento. Lì l'errore dice cosa fare; il messaggio originale di Notion è sotto «Mostra il messaggio di Notion».
Una sincronizzazione ferma riparte da sola una volta risolta la causa: quando ricolleghi o sostituisci il token nelle Impostazioni, quando Pocper torna a leggere il database («Ricarica le proprietà da Notion» accanto al titolo «Campi», o qualsiasi modifica salvata nella scheda Integrazione) o quando il documento viene modificato. Sul modello, la riga «Registro di sincronizzazione» conta gli errori e può mostrare solo quelli, e una riga come «3 documenti non sono ancora in Notion» ha un pulsante «Invia» che li manda tutti — aggiungendo prima la colonna Pocper ID se manca; aprila per vedere quali e perché. «Metti in pausa la sincronizzazione», accanto al titolo «Sincronizzazione», smette di inviare le modifiche finché non premi «Riprendi la sincronizzazione».