Überblick
Nach der Einrichtung der Lark-Bitable-Integration wird jeder über die BugCapturer-Erweiterung erzeugte Freigabebericht automatisch als neue, vollständige Zeile in die von dir angegebene Bitable geschrieben: Beschreibung, Seite, Umgebung, Diagnosezusammenfassung, Screenshot-Link, Freigabe-Link — ohne jemanden im Gruppenchat zu stören, und dein Team kann Einträge jederzeit filtern und nachsehen. Kernfunktionen:- Einstieg ohne Hürden: die empfohlene Webhook-Trigger-Methode kommt ohne Lark-App und ohne Administrator-Freigabe aus — in wenigen Minuten eingerichtet
- Mehrere Tabellen: bis zu 3 Integrationen möglich, jeweils auf eine andere Tabelle zeigend — ideal für getrennte „Bug-Tracking-Tabelle" und „Produktanfragen-Tabelle"
- Beim Speichern verifiziert: beim Speichern sendet der Server eine Testanfrage an die Webhook-Adresse — die Konnektivität ist sofort bestätigt
- Fehler werden sichtbar: fehlgeschlagene Schreibvorgänge werden automatisch wiederholt und im Zustellungsprotokoll erfasst; nach 20 aufeinanderfolgenden Fehlern wird die Integration automatisch pausiert und du erhältst eine E-Mail
- Methode A: Automation Webhook trigger (empfohlen) — keine Lark-App nötig. Lege in deiner Bitable unter „Automatisierung" einen neuen Webhook-Trigger-Flow an und füge die Adresse ein — in wenigen Minuten erledigt
- Methode B: Custom app (API) — beim Speichern werden automatisch 13 Standardspalten angelegt, ganz ohne Feld-Mapping; ideal für Teams, die eine einheitliche Spaltenstruktur benötigen
Vorbereitung: Webhook-Flow in Lark erstellen
Öffne deine Bitable und klicke oben rechts auf „Automatisierung" → „Neuen Flow erstellen":In BugCapturer konfigurieren
- Name: z. B. „Bug-Tracking-Tabelle"
- Webhook-Adresse: füge die im vorherigen Schritt kopierte Adresse ein
- Bearer Token (optional): nur nötig, wenn du auf Lark-Seite die Token-Validierung aktiviert hast
Feld-Mapping abschließen
Zurück im Flow-Editor von Lark:Welche Felder werden in die Tabelle geschrieben
| Spalte | Inhalt |
|---|---|
| Beschreibung | Beschreibung des gemeldeten Problems |
| Seiten-URL | URL der Seite mit dem Problem (sensible Parameter geschwärzt) |
| Seitentitel | Titel der Seite |
| Browser / OS / Auflösung | Umgebungsinformationen |
| Konsolenfehler / Netzwerkfehler | Anzahl der Diagnoseeinträge (Volltexte nicht enthalten — über den Freigabe-Link siehst du den vollständigen Inhalt) |
| Screenshot | Screenshot-Link (per Klick direkt öffnen) |
| Freigabe-Link | BugCapturer-Freigabeseite (volle Annotationen, Bildschirmaufnahme, Diagnosedetails) |
| Eingereicht am / Läuft ab am / Synchronisiert am | Zeitstempel |
Tägliche Nutzung
Nach der Konfiguration ist keine zusätzliche Aktion nötig: in der Erweiterung auf „Teilen" klicken → automatisch erscheint eine neue Zeile in der Tabelle. Das Erfolgs-Panel zeigt „Automatisch mit N Tabellen synchronisiert".- Schreibtest: jede Integrationskarte auf der Einstellungsseite hat einen „Test"-Button, um den Schreibvorgang jederzeit zu prüfen
- Zustellungsprotokoll: Status, Fehlergrund und Lark-Datensatz-ID der letzten 20 Schreibvorgänge einsehen
- Pausieren / Fortsetzen: pausieren, wenn du vorübergehend nicht synchronisieren möchtest; jederzeit fortsetzbar
- Schutz bei Serienfehlern: nach 20 aufeinanderfolgenden fehlgeschlagenen Schreibvorgängen (z. B. ungültige Webhook-Adresse oder deaktivierter Flow) pausiert die Integration automatisch und du erhältst eine E-Mail; nach der Behebung auf „Test" klicken, um fortzusetzen
FAQ
Speichern schlägt fehl mit „Webhook-Adresse überprüfen"? Prüfe, ob die Adresse vollständig kopiert wurde (inklusivehttps://) und keine Leerzeichen oder Zeilenumbrüche enthalten sind. BugCapturer unterstützt nur öffentliche https-Adressen.
Speichern erfolgreich, aber keine Daten in der Tabelle? Stelle sicher, dass der Lark-Flow gespeichert und aktiviert ist; wenn in den „Ausgabeeinstellungen" kein Feld-Mapping konfiguriert ist, wird trotz empfangener Anfrage nichts in die Tabelle geschrieben. Klicke auf der Integrationskarte auf „Test", um einen neuen Testdatensatz auszulösen.
Wird die Screenshot-Datei selbst in die Tabelle geschrieben? Derzeit wird ein Screenshot-Link geschrieben — per Klick öffnet sich das Bild in voller Auflösung.
Sind meine Daten sicher? Integrations-Schreibvorgänge werden nur ausgelöst, wenn du aktiv teilst; dieser Datenfluss ist in der Datenschutzerklärung offengelegt.
Weitere Dokumentation: Schritt-für-Schritt-Anleitungen findest du in der offiziellen Dokumentation — Methode A · Automation Webhook trigger / Methode B · Custom app (API).