Integrationen
Gesundheit und Überwachung
formbase hält deine Integrationen im Hintergrund am Laufen — erneuert Tokens, bevor sie ablaufen, pausiert bei Problemen und zeigt dir genau, was passiert ist, damit du es schnell beheben kannst.
Proaktive Token-Erneuerung
Ein täglicher Hintergrundjob prüft die OAuth-Verbindungen in deinem Workspace, einschließlich Cal.com. Wenn ein Token innerhalb der nächsten 24 Stunden abläuft, erneuert formbase ihn automatisch — du musst nichts tun.
Das gilt für Google, Slack, Linear, Airtable und Cal.com. Notion- und GitHub-Tokens laufen nicht ab und werden daher übersprungen. Discord-Tokens laufen nach etwa 7 Tagen ab und werden bei Bedarf direkt vor jeder Zustellung erneuert statt durch den täglichen Job.
Schlägt eine Erneuerung fehl — zum Beispiel, weil die Verbindung beim Anbieter widerrufen wurde —, markiert formbase die Verbindung als abgelaufen und versetzt jede Integration, die sie nutzt, in einen Fehlerzustand. Du siehst eine Warnung bei jeder betroffenen Integration und erhältst eine Benachrichtigungs-E-Mail.
Gesundheitszustände
Jede Integrationskarte trägt ein Statusabzeichen, und das Öffnen der Integration zeigt ein Banner, das erklärt, was zu tun ist. Das Abzeichen zeigt Aktiv, Pausiert oder Zustellungsfehler; das Banner ist genauer.
| Was du siehst | Was es bedeutet | Was zu tun ist |
|---|---|---|
| Aktiv | Funktioniert normal. Einreichungen werden zugestellt, sobald sie eingehen. | Nichts — alles ist bereit. |
| Pausiert | Entweder hast du sie pausiert, oder formbase hat sie nach 5 aufeinanderfolgenden Fehlern pausiert. | Behebe die Ursache und drücke dann Fortsetzen. Die Zustellung setzt bei der nächsten neuen Einreichung fort. |
| Verbindung abgelaufen | Der OAuth-Token konnte nicht erneuert werden. Das hat Vorrang vor jedem Zustellungsfehler. | Drücke Erneut verbinden auf der Integrationskarte oder im Detailbereich. |
| Zugang zum Ziel verloren | Das verbundene Konto kann dort nicht mehr schreiben. | Teile das Ziel erneut mit diesem Konto, oder verbinde dich mit einem Konto, das Zugriff hat. |
| Ziel nicht gefunden | Die Tabelle, Datenbank oder der Kanal existiert nicht mehr. | Lösche die Integration und erstelle eine neue. Ziele bei Sheets, Notion, Airtable, Slack und Discord sind bei der Einrichtung fixiert; ein Linear-Team oder ein GitHub-Repository lässt sich direkt ändern. |
| Zustellung fehlgeschlagen | Letzte Zustellungen sind aus einem unerwarteten Grund fehlgeschlagen. | Prüfe das Ereignisprotokoll im Detailbereich auf die Fehlermeldung. |
Verbindungsprobleme haben immer Vorrang. Wenn ein Token abgelaufen ist, behebt das erneute Verbinden alle Integrationen, die dieses Konto teilen, auf einmal — du musst dich nicht um jede einzeln kümmern.
Fehleranzeigen
Wenn etwas schiefgeht, zeigt formbase es an zwei Stellen:
Integrationskarte — die Karte zeigt ein Statusabzeichen und einen farbigen Rahmen: orange bei einem Verbindungsproblem, rot bei einem Zustellungsfehler. Wenn die Verbindung abgelaufen ist, erscheint direkt auf der Karte eine Schaltfläche Erneut verbinden.
Detailbereich — öffne die Integration, um ein Banner zu sehen, das benennt, was passiert ist und wie du es behebst.
Automatische Pausierung nach wiederholten Fehlern
Schlägt eine Integration 5 Mal in Folge fehl, pausiert formbase sie, damit ein defektes Ziel nicht weiter Zustellungen verbrennen kann. Ein Authentifizierungs-, Berechtigungs- oder Nicht-gefunden-Fehler überspringt den Zähler und stoppt die Integration sofort, weil ein Wiederholungsversuch das Problem nicht beheben kann.
So oder so geht eine E-Mail an die Person, die die Integration eingerichtet hat — oder an die Workspace-Inhaberin oder den Workspace-Inhaber, wenn diese Adresse nicht verfügbar ist. Sie wird höchstens einmal pro Integration alle 24 Stunden gesendet, sodass ein einzelnes defektes Ziel dein Postfach nicht überfluten kann.
Behebe das zugrunde liegende Problem und drücke dann Fortsetzen. Die Zustellung setzt bei der nächsten neuen Einreichung fort.
Ereignisprotokoll
Jede Integration listet ihre letzten 20 Ereignisse unter Letzte Ereignisse auf — Zustellungen, Verbindungstests und Backfill-Exporte, jeweils als erfolgreich oder fehlgeschlagen markiert. Ein fehlgeschlagener Eintrag zeigt die eigene Fehlermeldung des Ziels, sodass ein Notion-Validierungsfehler genau so klingt, wie Notion ihn formuliert hat. Ein fehlgeschlagener Backfill erhält außerdem eine Schaltfläche Erneut versuchen, die den Export neu startet.
Fehlgeschlagene Zustellungen und Wiederholungsversuche
Jede Zustellung erhält bis zu 5 Versuche, mit mindestens 1, 2, 4 und 8 Minuten Wartezeit dazwischen, oder länger, wenn das Ziel über einen
Retry-After-Header mehr Zeit verlangt. formbase sucht alle 30 Minuten nach fälligen Wiederholungen, sodass jede Wiederholung
bis zu einer halben Stunde später kommen kann und der letzte Versuch etwa zwei Stunden nach dem ersten erfolgt.
Einreichungen, die alle 5 Versuche aufgebraucht haben, werden in einem Banner oben in der Integration gezählt: „3 Einreichungen konnten nicht zugestellt werden”. Alle erneut versuchen reiht jede von ihnen erneut ein und aktiviert die Integration wieder, falls sie pausiert war oder einen Fehler hatte. Das Banner ist ausgeblendet, wenn nichts fehlgeschlagen ist.
Analytics-Ziele sind separat
Alles auf dieser Seite betrifft Einreichungs-Integrationen. Die Weiterleitung von Analytics-Ereignissen ist Best-Effort und wird nie wiederholt, und das Streamen von Axiom-Antworten stoppt von selbst nach 20 aufeinanderfolgenden Fehlern. Siehe Analytics-Streaming.
Abgelaufene Zugangsdaten neu verbinden
Wenn eine Verbindung abläuft, klicke auf Erneut verbinden auf der Integrationskarte oder im Detailbereich. Dadurch wird der OAuth-Ablauf mit demselben Anbieter erneut durchgeführt. Nach der Autorisierung werden die Zugangsdaten wiederhergestellt, und alle Integrationen, die dieses Konto verwenden, setzen automatisch fort.
Du kannst im Detailbereich auch zu einem anderen verbundenen Konto wechseln, falls das ursprüngliche Konto nicht mehr verfügbar ist.
FAQ
Einmal täglich. Tokens, die innerhalb von 24 Stunden ablaufen, werden automatisch erneuert. Wenn du früher ein Problem vermutest, öffne den Integrationsdetailbereich — der Gesundheitszustand aktualisiert sich in Echtzeit anhand der Zustellungsergebnisse.
Nein. Einreichungen werden unabhängig vom Integrationsstatus immer in formbase gespeichert. Fehlgeschlagene Zustellungen werden in eine Warteschlange gestellt und können im Detailbereich erneut versucht werden, sobald das Problem behoben ist.
formbase erneuert Tokens proaktiv, sodass du es in den meisten Fällen nicht bemerkst. Schlägt die Erneuerung fehl, erhältst du sofort eine E-Mail-Benachrichtigung — meist bevor der Token tatsächlich abläuft.
Die Integration wechselt zum neuen Konto. Stelle sicher, dass das neue Konto Zugriff auf dasselbe Ziel hat (Tabelle, Datenbank, Kanal). Wenn das Ziel im neuen Konto nicht existiert, musst du die Integrationseinstellungen aktualisieren.