Inviare le risposte ad altri strumenti

Una connessione (detta anche webhook) invia ogni nuova risposta di un modulo a un altro strumento: Zapier, Make, un foglio Google Sheets o qualsiasi indirizzo che inizia con https://. Le connessioni faranno parte del piano Pro; durante l'accesso anticipato sono aperte a tutti gli account (vedi Piani e crediti).

Prima di iniziare

• La verifica in due passaggi è obbligatoria per aggiungere, modificare o attivare una connessione, perché le risposte escono da Fillfold. Vedi Creare l'account e attivare la verifica in due passaggi.
• Un modulo può avere al massimo 2 connessioni. Una nuova connessione parte disattivata.
• Ti inviamo un'email ogni volta che una connessione viene aggiunta, modificata, attivata o riceve un nuovo segreto.

Aggiungere una connessione

1. Apri il modulo e scegli Connessioni.
2. Incolla l'indirizzo che ti dà il tuo strumento in Indirizzo (URL).
3. Spunta Ho capito dove vanno le risposte, poi scegli Aggiungi la connessione.
4. Copia il segreto mostrato in Segreto di firma, mostrato una sola volta e conservalo nel tuo strumento.
5. Scegli Invia un test: vengono inviate risposte di esempio inventate, mai una risposta reale.
6. Scegli Attiva.

L'elenco Invii recenti mostra gli ultimi 50 invii, conservati per 30 giorni, con Riprova ora per un invio non riuscito.

Zapier e Make

• Zapier: crea uno Zap con il trigger Webhooks by Zapier, evento Catch Hook, e incolla il suo URL in Fillfold. Controlla che il tuo piano Zapier includa Webhooks by Zapier.
• Make: aggiungi il modulo Webhooks, poi Custom webhook, e incolla il suo indirizzo.

Ogni richiesta contiene il modulo, la data della risposta, le domande (fields) e le risposte (answers). I numeri arrivano come numeri, le tabelle come righe, i file solo con il loro nome.

Quando un cliente accetta un preventivo che hai preparato, le tue connessioni ricevono anche l'evento quote.accepted, con il PDF firmato in document.url se includi i link ai PDF (vedi Inviare un preventivo da accettare).

Google Sheets

1. Nel tuo foglio, apri Estensioni, poi Apps Script.
2. In Fillfold, scegli Copia lo script per Google Sheets e incollalo.
3. Inserisci il tuo segreto di firma nella riga const SECRET.
4. Scegli Esegui il deployment, Nuovo deployment, tipo App web, eseguita come te, accessibile a chiunque. Copia l'URL dell'app web.
5. Aggiungilo come connessione e spunta Metti la firma nel corpo (per Google Apps Script).

Lo script controlla la firma, salta una risposta che ha già e aggiunge un apostrofo davanti a ogni testo che inizia con =, +, - o @, così una risposta non può mai essere eseguita come formula nel tuo foglio.

Salvare il PDF in Google Drive o Dropbox

Spunta Includi un link al PDF. Ogni risposta arriva allora con document.url, un link privato valido 24 ore e per 5 download. In Zapier, aggiungi un passaggio Google Drive o Dropbox Upload File e dagli quel link come file. In Make, aggiungi HTTP, Get a file, poi il modulo di caricamento. Le copie salvate lì sono fuori dalle impostazioni di eliminazione di Fillfold (vedi la privacy e le condizioni).

Verificare la firma

Ogni richiesta ha un'intestazione Fillfold-Signature: t=1761400000,v1=.... Calcola un HMAC-SHA256 di t, un punto e il corpo così com'è, con il tuo segreto di firma come chiave, e confrontalo con v1. Rifiuta le richieste più vecchie di 5 minuti. Una risposta inviata due volte mantiene lo stesso id.

Se gli invii non riescono

Un invio non riuscito viene ritentato per circa 2 giorni. Dopo 3 invii abbandonati di fila, la connessione viene disattivata e ricevi un'email. Correggi l'indirizzo, invia un test, poi riattivala.