Integraties
Gezondheid en monitoring
formbase houdt je integraties op de achtergrond draaiende — het vernieuwt tokens voordat ze verlopen, pauzeert wanneer er iets misgaat, en laat je precies zien wat er is gebeurd zodat je het snel kunt oplossen.
Proactieve tokenvernieuwing
Een dagelijkse achtergrondtaak controleert de OAuth-verbindingen in je werkruimte, inclusief Cal.com. Als een token binnen de komende 24 uur verloopt, vernieuwt formbase het automatisch — je hoeft niets te doen.
Dit geldt voor Google, Slack, Linear, Airtable en Cal.com. Notion- en GitHub-tokens verlopen niet, dus die worden overgeslagen. Discord-tokens verlopen na ongeveer 7 dagen en worden op aanvraag vernieuwd, vlak vóór elke bezorging, in plaats van door de dagelijkse taak.
Als een vernieuwing mislukt — bijvoorbeeld omdat de verbinding aan de kant van de provider is ingetrokken — markeert formbase de verbinding als verlopen en zet elke integratie die deze deelt in een foutstatus. Je ziet een waarschuwing op elke getroffen integratie en ontvangt een notificatie-e-mail.
Gezondheidsstatussen
Elke integratiekaart toont een statusbadge, en het openen van de integratie toont een banner die uitlegt wat je moet doen. De badge toont Actief, Gepauzeerd of Leveringsfout; de banner is specifieker.
| Wat je ziet | Wat het betekent | Wat te doen |
|---|---|---|
| Actief | Werkt normaal. Inzendingen worden afgeleverd zodra ze binnenkomen. | Niets — je bent klaar. |
| Gepauzeerd | Jij hebt hem gepauzeerd, of formbase heeft hem gepauzeerd na 5 mislukkingen op rij. | Los de oorzaak op en klik daarna op Hervat. De bezorging pakt de eerstvolgende nieuwe inzending weer op. |
| Verbinding verlopen | Het OAuth-token kon niet worden vernieuwd. Dit krijgt voorrang boven een eventuele leveringsfout. | Klik op Verbind opnieuw op de integratiekaart of in het detailpaneel. |
| Toegang tot bestemming verloren | Het verbonden account kan daar niet meer schrijven. | Deel de bestemming opnieuw met dat account, of verbind opnieuw met een account dat toegang heeft. |
| Bestemming niet gevonden | Het spreadsheet, de database of het kanaal bestaat niet meer. | Verwijder de integratie en maak een nieuwe aan. Bestemmingen voor Sheets, Notion, Airtable, Slack en Discord liggen vast bij het instellen; een Linear-team of GitHub-repository kan ter plekke worden gewijzigd. |
| Levering mislukt | Recente leveringen zijn om een onverwachte reden mislukt. | Bekijk het gebeurtenislogboek in het detailpaneel voor de foutmelding. |
Verbindingsproblemen krijgen altijd voorrang. Als een token is verlopen, lost opnieuw verbinden alle integraties die dat account delen in één keer op — je hoeft ze niet afzonderlijk te behandelen.
Foutindicatoren
Wanneer er iets misgaat, toont formbase dit op twee plaatsen:
Integratiekaart — de kaart toont een statusbadge en een gekleurde rand: oranje voor een verbindingsprobleem, rood voor een leveringsfout. Als de verbinding is verlopen, verschijnt er een knop Verbind opnieuw direct op de kaart.
Detailpaneel — open de integratie om een banner te zien die benoemt wat er is gebeurd en hoe je het oplost.
Automatisch pauzeren na herhaalde fouten
Als een integratie 5 keer achter elkaar mislukt, pauzeert formbase hem zodat een kapotte bestemming niet steeds meer leveringen kan verbranden. Een authenticatie-, machtigings- of niet-gevonden-fout slaat de teller over en stopt de integratie meteen, omdat opnieuw proberen het probleem niet oplost.
In beide gevallen gaat er een e-mail naar de persoon die de integratie heeft ingesteld — of naar de werkruimte-eigenaar wanneer dat adres niet beschikbaar is. Deze wordt hoogstens één keer per integratie per 24 uur verstuurd, zodat één kapotte bestemming je inbox niet kan overspoelen.
Los het onderliggende probleem op en klik daarna op Hervat. De bezorging pakt de eerstvolgende nieuwe inzending weer op.
Gebeurtenislogboek
Elke integratie toont zijn laatste 20 gebeurtenissen onder Recente gebeurtenissen — leveringen, verbindingstests en backfill-exports, elk gemarkeerd als geslaagd of mislukt. Een mislukte vermelding toont de eigen foutmelding van de bestemming, dus een Notion-validatiefout leest precies zoals Notion die heeft geformuleerd. Een mislukte backfill krijgt ook een knop Retry die de export opnieuw start.
Mislukte leveringen en nieuwe pogingen
Elke levering krijgt tot 5 pogingen, met minstens 1, 2, 4 en 8 minuten ertussen, of langer wanneer de bestemming via een
Retry-After-header om meer tijd vraagt. formbase zoekt elke 30 minuten naar nieuwe pogingen die klaarstaan, dus elke nieuwe
poging kan tot een half uur later komen, en de laatste poging komt zo’n twee uur na de eerste.
Inzendingen die alle 5 pogingen hebben verbruikt, worden geteld in een banner boven aan de integratie: “3 submissions failed to deliver”. Alles opnieuw proberen zet ze allemaal opnieuw in de wachtrij en heractiveert de integratie als deze was gepauzeerd of in fout stond. De banner is verborgen wanneer niets is mislukt.
Analyticsbestemmingen zijn apart
Alles op deze pagina gaat over inzendingsintegraties. Het doorsturen van analytics-events is best-effort en wordt nooit opnieuw geprobeerd, en antwoordstreaming naar Axiom stopt vanzelf na 20 opeenvolgende mislukkingen. Zie Analytics streaming.
Een verlopen credential opnieuw verbinden
Wanneer een verbinding verloopt, klik je op Verbind opnieuw op de integratiekaart of in het detailpaneel. Dit voert de OAuth-stroom opnieuw uit met dezelfde provider. Eenmaal geautoriseerd wordt de credential hersteld en hervatten alle integraties die dat account gebruiken automatisch.
Je kunt vanuit het detailpaneel ook overschakelen naar een ander verbonden account als het oorspronkelijke account niet meer beschikbaar is.
Veelgestelde vragen
Eén keer per dag. Tokens die binnen 24 uur verlopen worden automatisch vernieuwd. Als je eerder een probleem vermoedt, open dan het detailpaneel van de integratie — de gezondheidsstatus wordt in real time bijgewerkt op basis van afleverresultaten.
Nee. Inzendingen worden altijd opgeslagen in formbase, ongeacht de integratiestatus. Mislukte afleveringen worden in de wachtrij geplaatst en kunnen vanuit het detailpaneel opnieuw worden geprobeerd zodra het probleem is opgelost.
formbase vernieuwt tokens proactief, dus in de meeste gevallen merk je er niets van. Als de vernieuwing mislukt, ontvang je onmiddellijk een e-mailmelding — meestal voordat het token daadwerkelijk verloopt.
De integratie schakelt over naar het nieuwe account. Zorg ervoor dat het nieuwe account toegang heeft tot dezelfde bestemming (spreadsheet, database, kanaal). Als de bestemming niet bestaat in het nieuwe account, moet je de integratie-instellingen bijwerken.