Feishu-Bitable-Integration: Bugmeldungen automatisch mit deiner Tabelle synchronisieren

Überblick

Nach der Einrichtung der Feishu-Bitable-Integration wird jeder über die BugCapturer-Erweiterung erzeugte Freigabebericht automatisch als neue, vollständige Zeile in die von dir angegebene Bitable geschrieben: Beschreibung, Typ, 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:

Kein manuelles Tabellen-Setup: 14 Standardspalten werden beim Speichern der Integration automatisch angelegt (vorhandene Spalten mit gleichem Namen werden wiederverwendet)

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: vor dem Speichern durchläuft der Server die vollständige Vier-Schritt-Prüfung „Zugangsdaten verifizieren → Schreibzugriff prüfen → Spalten anlegen → Testdatensatz schreiben"

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

Vorbereitung: Feishu-App erstellen

Die Feishu-Bitable-Anbindung erfolgt über eine unternehmenseigene App (App ID + App Secret), in vier Schritten:

1. Eigene App erstellen

Öffne die Feishu Open Platform → Entwicklerkonsole → Benutzerdefinierte App erstellen und gib App-Namen und Beschreibung ein (z. B. „BugCapturer Ledger Sync").

2. Bitable-Berechtigung aktivieren

Gehe zu deiner App → Berechtigungen → suche und aktiviere:

bitable:app (Bitable anzeigen, kommentieren, bearbeiten und verwalten)

Wenn die Tabelle in einem Wiki liegt, zusätzlich wiki:wiki:readonly (Wiki anzeigen)

3. App veröffentlichen

Gehe zu Versionsverwaltung & Veröffentlichung → Version erstellen → Veröffentlichung einreichen. Eigene Apps werden in der Regel direkt vom Workspace-Administrator genehmigt.

4. App als Tabellen-Mitarbeiter hinzufügen

Öffne deine Bitable → „..." oben rechts → Mehr → Dokument-App hinzufügen → suche deine App und füge sie als bearbeitenden Mitarbeiter hinzu. > Ohne diesen Schritt kann die App wegen fehlender Mitarbeiterberechtigung nicht in die Tabelle schreiben — der häufigste Konfigurationsfehler.

In BugCapturer konfigurieren

Öffne app.bugcapturer.com/settings/integrations und melde dich an

Klicke auf „Integration hinzufügen" und lies die Vier-Schritt-Anleitung bis zum Formular

Ausfüllen:

Name: z. B. „Bug-Tracking-Tabelle"

App ID: beginnt mit cli_

App Secret: kopiere es von der Seite „Zugangsdaten & Basisinformationen" der App

Bitable-URL: füge den vollständigen Link aus der Browser-Adressleiste ein (inklusive table=-Parameter; Wiki-Links werden ebenfalls unterstützt und automatisch aufgelöst)

Klicke auf „Verifizieren & Speichern" — der Server durchläuft automatisch die Vier-Schritt-Prüfung. Nach bestandener Prüfung wird die Integration aktiv und sofort erscheint ein Testdatensatz in deiner Tabelle

Welche Spalten werden geschrieben

Folgende Standardspalten werden beim ersten Speichern automatisch angelegt (vorhandene Spalten mit gleichem Namen werden wiederverwendet; deine Spaltentypen werden nie geändert):

Spalte	Inhalt
Beschreibung	Beschreibung des gemeldeten Problems
Typ	Bug / Funktion / Vorschlag / Lob
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 (Details im Freigabe-Link)
Screenshot	Screenshot-Link (Klick öffnet die Vollauflösung)
Freigabe-Link	BugCapturer-Freigabeseite (volle Annotationen, Bildschirmaufnahme, Diagnosedetails)
Eingereicht am / Läuft ab am / Synchronisiert am	Zeitstempel

Du kannst eigene Spalten frei hinzufügen oder entfernen (z. B. „Verantwortlich", „Priorität", „Status") — die Integration bleibt davon unberührt.

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 Feishu-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. rotiertes Secret, App als Mitarbeiter entfernt) 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 „Ungültige Zugangsdaten"? App ID oder App Secret wurde falsch kopiert oder die App ist noch nicht veröffentlicht. Kopiere beides neu von der Zugangsdaten-Seite und stelle sicher, dass die App veröffentlicht ist. Speichern schlägt fehl mit „Fehlende Tabellen-Mitarbeiterberechtigung"? Die App wurde nicht als Tabellen-Mitarbeiter hinzugefügt. Kehre zum Schritt „App als Tabellen-Mitarbeiter hinzufügen" zurück. Wird die Screenshot-Datei selbst hochgeladen? Derzeit wird ein Screenshot-Link geschrieben (läuft nie ab) — per Klick öffnet sich das Bild in voller Auflösung. Direkter Anhang-Upload ist geplant. Sind meine Daten sicher? Integrations-Zugangsdaten und serverseitige 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 (inklusive Feld-Mapping von Methode A) findest du in der offiziellen Dokumentation — Methode A · Automation Webhook trigger / Methode B · Custom app (API).