Axiom

Axiom verbinden

1. 1

   Maak een dataset aan

   Maak de Axiom-dataset aan die formbase-records moet ontvangen, of kies een bestaande.

2. 2

   Maak een ingest-token aan

   Maak een API-token aan met toestemming om in die dataset te ingesten.

3. 3

   Verbind in formbase

   Open Workspace → Integrations → Analytics, klik op Verbinden bij Axiom, voer Dataset en API-token in, kies de Regio en klik op Verbinden.

4. 4

   Stuur testgebeurtenis

   Open een willekeurig formulier → Instellingen → Integraties → Analytics streaming en klik op Stuur testgebeurtenis.

De twee regio-opties zijn US East 1 (AWS) en EU Central 1 (AWS). Kies de regio waarin je Axiom-organisatie zich bevindt — formbase leidt hier het ingest-eindpunt van af, en ingesten naar de verkeerde regio wordt geweigerd.

Analytics-events

Het koppelen van Axiom zet het doorsturen van antwoordvrije events aan voor elk formulier in de workspace. Records gebruiken de eventnamen form_view, form_engaged en form_submit, met dezelfde parameters die worden gedocumenteerd in Analytics streaming.

['your-dataset']
| where ['event'] in ('form_view', 'form_engaged', 'form_submit')
| summarize events=count() by ['event']

Elk record haalt de eventparameters naar het hoogste niveau, zodat form_id, source, device en de rest gewone kolommen zijn waarop je kunt filteren en samenvatten.

Het doorsturen van events is best-effort en wordt niet opnieuw geprobeerd. Schakel het voor één formulier uit onder Formulierinstellingen → Integraties → Analytics streaming → Stuur analyse-events door.

Antwoorden van respondenten

Axiom kan ook één volledig record per voltooide inzending ontvangen. Deze stream staat standaard uit en moet apart worden ingeschakeld voor elk formulier met Stuur antwoorden van respondenten.

Een antwoordrecord is dezelfde event-envelop als wat een aangepaste webhook ontvangt, plus een Axiom-veld _time: het event-id, het type, createdAt, apiVersion en test, en onder data het formulier, de inzending (id, e-mailadres van de respondent, tijdstip van indiening, PDF-link, taal), een answers-object met de veldsleutel als key en een display-object met dezelfde keys als leesbare tekst. Inzendingen die een verzoek hebben beantwoord bevatten ook een request-blok met je externe id en metagegevens. De volledige vorm staat in de webhookreferentie.

Antwoorden worden gestreamd zodra een inzending is voltooid en opnieuw wanneer een respondent deze bewerkt. Verlaten concepten bereiken Axiom op deze manier nooit — antwoordstreaming heeft geen inactiviteitsvenster.

Bezorging en mislukkingen van antwoorden

Antwoordrecords lopen mee met de bezorgingswachtrij van inzendingen: tot 5 pogingen met exponentiële uitstel. Na 20 opeenvolgende mislukkingen stopt de bestemming met in de wachtrij worden geplaatst, zodat een ongeldig token of een geweigerde dataset niet bij elke nieuwe inzending een mislukte bezorging veroorzaakt. Het opslaan van een nieuw API-token wist de fout en hervat de bezorging.

Het doorsturen van events en antwoordstreaming hebben onafhankelijke schakelaars. Je kunt per formulier antwoorden zonder events versturen, events zonder antwoorden, beide, of geen van beide.

Problemen oplossen

Volgende stappen