Antwoorden naar andere tools sturen

Een koppeling (ook webhook genoemd) stuurt elk nieuw antwoord op een formulier naar een andere tool: Zapier, Make, een Google-spreadsheet of elk adres dat begint met https://. Koppelingen gaan bij het Pro-abonnement horen; tijdens de vroege toegang staan ze open voor elk account (zie Abonnementen en tegoed).

Voordat je begint

• Verificatie in twee stappen is verplicht om een koppeling toe te voegen, te wijzigen of aan te zetten, want de antwoorden verlaten Fillfold. Zie Een account aanmaken en verificatie in twee stappen aanzetten.
• Een formulier kan hoogstens 2 koppelingen hebben. Een nieuwe koppeling staat eerst uit.
• We sturen je een e-mail telkens als een koppeling wordt toegevoegd, gewijzigd, aangezet of een nieuw geheim krijgt.

Een koppeling toevoegen

1. Open het formulier en kies Koppelingen.
2. Plak het adres dat je tool je geeft bij Adres (URL).
3. Vink Ik begrijp waar de antwoorden naartoe gaan aan en kies Koppeling toevoegen.
4. Kopieer het geheim onder Ondertekeningsgeheim, maar één keer getoond en bewaar het in je tool.
5. Kies Test sturen: er worden verzonnen voorbeeldantwoorden verstuurd, nooit een echt antwoord.
6. Kies Aanzetten.

De lijst Recente verzendingen toont de laatste 50 verzendingen, 30 dagen bewaard, met Nu opnieuw proberen voor een mislukte.

Zapier en Make

• Zapier: maak een Zap met de trigger Webhooks by Zapier, gebeurtenis Catch Hook, en plak de URL in Fillfold. Controleer of je Zapier-abonnement Webhooks by Zapier bevat.
• Make: voeg de module Webhooks toe, dan Custom webhook, en plak het adres.

Elk verzoek bevat het formulier, de datum van het antwoord, de vragen (fields) en de antwoorden (answers). Getallen komen aan als getallen, tabellen als rijen en bestanden alleen met hun naam.

Als een klant een offerte accepteert die jij hebt opgesteld, krijgen je koppelingen ook de gebeurtenis quote.accepted, met de ondertekende pdf achter document.url als je pdf-links meestuurt (zie Een offerte ter acceptatie versturen).

Google Sheets

1. Open in je spreadsheet Extensies en dan Apps Script.
2. Kies in Fillfold Google Sheets-script kopiëren en plak het.
3. Zet je ondertekeningsgeheim in de regel const SECRET.
4. Kies Implementeren, Nieuwe implementatie, type Web-app, uitgevoerd als jij, toegang voor iedereen. Kopieer de URL van de web-app.
5. Voeg die toe als koppeling en vink Handtekening in de inhoud zetten (voor Google Apps Script) aan.

Het script controleert de handtekening, slaat een antwoord over dat het al heeft en zet een apostrof voor elke tekst die begint met =, +, - of @. Zo kan een antwoord in je spreadsheet nooit als formule worden uitgevoerd.

De pdf in Google Drive of Dropbox bewaren

Vink Een link naar de pdf meesturen aan. Elk antwoord komt dan met document.url, een privélink die 24 uur en voor 5 downloads werkt. Voeg in Zapier een stap Google Drive of Dropbox Upload File toe en geef die link als bestand. Voeg in Make HTTP, Get a file en dan de uploadmodule toe. Kopieën die daar worden bewaard, vallen buiten de verwijderinstellingen van Fillfold (zie privacy en voorwaarden).

De handtekening controleren

Elk verzoek heeft een header Fillfold-Signature: t=1761400000,v1=.... Bereken een HMAC-SHA256 van t, een punt en de ongewijzigde inhoud, met je ondertekeningsgeheim als sleutel, en vergelijk die met v1. Weiger verzoeken die ouder zijn dan 5 minuten. Een antwoord dat twee keer wordt verstuurd, houdt dezelfde id.

Als verzendingen mislukken

Een mislukte verzending wordt ongeveer 2 dagen lang opnieuw geprobeerd. Na 3 opgegeven verzendingen op rij wordt de koppeling uitgezet en krijg je een e-mail. Verbeter het adres, stuur een test en zet de koppeling daarna weer aan.