Dokumentation

Dokumente rein. Daten & Aktionen raus.

LyveCatch nimmt E-Mails, Uploads und Webhooks entgegen, erkennt per KI, worum es geht, liest die wichtigen Angaben aus und reagiert automatisch. Diese Dokumentation erklärt alles — vom ersten Catch bis zur Integration.

Das Dashboard: Kennzahlen, Verlauf und letzte Catches auf einen Blick

Übersicht

Viele Betriebe bekommen täglich Rechnungen, Aufträge, Anfragen und Reklamationen — meist als E-Mail-Anhang, oft unstrukturiert. LyveCatch macht daraus strukturierte Daten und löst automatisch die passende Reaktion aus.

KI-Erkennung
Klassifiziert Dokumente und extrahiert Felder mit Confidence-Wert. Wahlweise Mock, OpenAI oder Claude.
Vier Eingangskanäle
E-Mail-Postfach (IMAP), Webhook, API und Datei-Upload — beliebig kombinierbar.
Regeln & Aktionen
Wenn/Dann-Logik auf den extrahierten Feldern: Mails, Webhooks, Tags, Statuswechsel.
Mensch im Loop
Unsichere Fälle landen in den Kontrollen — erst nach Freigabe werden Aktionen ausgeführt.
Duplikaterkennung
Gleiche Rechnung doppelt? Mögliche Duplikate werden markiert, bevor doppelt gezahlt wird.
Automatische Retries
Fehlgeschlagene Aktionen werden mit Backoff wiederholt — mit vollem Verlauf und manuellem Retry.
Sicher & nachvollziehbar
Rollen, 2-Faktor-Login, HMAC-Signaturen für Webhooks und ein lückenloses Audit-Log.
Mandantenfähig
Mehrere Organisationen mit getrennten Daten, Teams und Einstellungen.

Schnellstart

In fünf Schritten vom leeren Konto zum ersten automatisch verarbeiteten Dokument.

Anmelden
Melde dich mit E-Mail und Passwort an. Das Dashboard zeigt zunächst leere Kennzahlen.
KI-Provider wählen
Unter Settings OpenAI oder Claude mit eigenem API-Key hinterlegen. „Mock“ eignet sich nur für erste Tests.
Catch-Typ anlegen
Unter Catches → Neuer Catch, z. B. „Rechnung“ mit Feldern und Regel.
Quelle verbinden
Unter Sources ein IMAP-Postfach oder einen Webhook anlegen — oder direkt unter Uploads eine Datei hochladen.
Testen & laufen lassen
Im Test-Tab einen Beispieltext einfügen, dann echte Dokumente empfangen. Ergebnisse siehst du in Database.
Step -1 of 0
Tipp
Starte mit einem einzigen Catch-Typ und einer einfachen Regel. Verfeinere Definition und Felder anhand der ersten echten Ergebnisse.

Die wichtigsten Begriffe

Catch-Typ
Die Vorlage: was soll erkannt werden, mit welchen Feldern, Regeln und welcher Schwelle (z. B. „Rechnung“).
Catch
Ein einzelnes, tatsächlich eingegangenes Dokument mit Referenz wie #LC-10291, dem ein Typ zugeordnet wurde.
Quelle
Der Kanal, über den Catches hereinkommen: E-Mail-Postfach, Webhook, API oder Upload.
Confidence
Wie sicher sich die KI ist (0–100 %). Unter der Schwelle geht der Catch zur manuellen Prüfung.
Regel
Wenn/Dann-Logik: Bedingungen auf Feldwerten, die bei Erfüllung Aktionen auslösen.
Aktion
Was passiert: E-Mail senden, Webhook/API aufrufen, Status ändern, Tag setzen oder entfernen.

So funktioniert die Verarbeitung

Jedes Dokument durchläuft dieselbe Pipeline — egal über welche Quelle es kommt.

Empfangen
Ein Dokument trifft ein — per E-Mail, Upload, Webhook oder API.
Klassifizieren
Die KI ordnet es einem Catch-Typ zu, z. B. „Rechnung“.
Extrahieren
Definierte Felder (Nummer, Betrag, Datum …) werden ausgelesen.
Prüfen
Confidence ≥ Schwelle? Dann weiter — sonst in die Kontrollen.
Handeln
Regeln greifen: E-Mail, Webhook, Tag, Statuswechsel.
Der Worker
Die Verarbeitung erledigt ein Hintergrunddienst (Worker). Läuft er nicht, bleiben Catches auf „Ausstehend“ stehen.

Status eines Catches

AusstehendIn BearbeitungPrüfung erforderlichAutomatisch verarbeitetFehler

Dashboard

Die Startseite („Statistiken“) zeigt vier Kennzahlen — Catches gesamt, Prüfung erforderlich, automatisch verarbeitet und Fehler — dazu den Verlauf der letzten 30 Tage, die Verteilung nach Typ und Quelle sowie die zuletzt eingegangenen Catches. Über die Suche oben findest du Catches nach Referenz oder Inhalt.

Statistiken: Kennzahlen, Verlauf, Verteilung nach Typ und Quelle

Database

Alle jemals eingegangenen Catches, filter- und sortierbar. Filtere nach Catch-Typ (Tabs) und Status, suche nach Referenz oder Inhalt, sortiere per Klick auf die Spaltenüberschrift und ziehe Spalten in der Breite. Die gefilterte Liste lässt sich exportieren.

Database: filterbare Liste mit Inhaltsvorschau

Detailansicht

Ein Klick öffnet den Catch: erkannte Daten, Quelle, kompletter Verarbeitungsverlauf, Rohdaten, KI-Information (Confidence, Klassifizierung), ausgehende Aktionen mit Status und Retry sowie Anhänge mit Vorschau und Download.

Catch-Detail: Felder, Quelle, Verarbeitungsverlauf und KI-Information

Kontrollen

Catches unterhalb der Confidence-Schwelle warten hier auf einen Menschen. Korrigiere bei Bedarf die erkannten Felder und gib frei — dann werden Regeln und Aktionen nachträglich ausgeführt — oder lehne ab. Ältere Fälle stehen oben und werden ab 24 bzw. 72 Stunden farblich hervorgehoben. Per Mehrfachauswahl lassen sich Sammelaktionen ausführen.

Kontrollen: offene Prüfungen, älteste zuerst
Prüfen, Felder korrigieren, freigeben oder ablehnen

Catch-Typen

Ein Catch-Typ beschreibt, was LyveCatch erkennen soll. Die Übersicht zeigt alle Typen; über das Aktionsmenü lassen sie sich bearbeiten, duplizieren oder löschen. Bestehende Catches bleiben beim Löschen erhalten.

Catch-Typen verwalten

Der Assistent in sieben Schritten

Neuer Catch: Schritt-für-Schritt-Assistent (alternativ „Gesamtansicht“)
Name
Wie heißt der Catch, z. B. „Rechnung“? Optional mit Icon.
Quellen
Über welche Kanäle darf dieser Typ hereinkommen?
Definition
Beschreibe in Worten, woran die KI ihn erkennt — je genauer, desto besser.
Felder
Welche Angaben sollen extrahiert werden (Text, Datum, Betrag, Zahl, Ja/Nein, Liste)?
Confidence
Ab welcher Sicherheit wird automatisch weiterverarbeitet?
Regeln
Was soll passieren, wenn Bedingungen erfüllt sind?
Fertig
Logik-Vorschau ansehen und direkt im selben Fenster testen.
Step -1 of 0

Feldtypen

TextDatumBetragZahlJa/NeinListe
Gute Definitionen
Beschreibe typische Merkmale: „Eine Rechnung enthält eine Rechnungsnummer, einen Rechnungssteller, Positionen mit Preisen und einen Gesamtbetrag.“ Je konkreter, desto höher die Trefferquote.

Regeln & Aktionen

Eine Regel besteht aus Bedingungen (verknüpft mit UND oder ODER) und Aktionen, die bei Erfüllung laufen. Bedingungen greifen auf extrahierte Feldwerte zu, z. B. „Brutto > 1000“.

E-Mail senden
Mit Platzhaltern wie {{invoiceNumber}} in Betreff und Text. Optional Original-Inhalt oder Original-Anhang mitsenden.
Webhook senden
Ruft eine externe URL mit den Catch-Daten auf.
API-Request
Freie HTTP-Anfrage an ein Drittsystem (Methodenwahl ab Business).
Status ändern
Setzt den Catch auf einen anderen Status.
Tag hinzufügen / entfernen
Markiert Catches, z. B. high-value, zur Filterung und Nachverfolgung.

Beispiel

WENNBrutto>1000
DANNE-Mail an buchhaltung@muster.de — Betreff „Neue Rechnung: {{invoiceNumber}}
UNDTag high-value hinzufügen

E-Mail-Optionen

  • Original-Inhalt senden — die Mail enthält den ursprünglichen Inhalt 1:1 statt deiner Vorlage.
  • Original-Anhang mitschicken — die ursprüngliche Datei wird angehängt (ab Business).
  • Eigenes SMTP pro Catch-Typ — überschreibt den globalen Mailserver (ab Business).
  • Mail-Templates — wiederverwendbare Vorlagen unter Settings.
Mail-Templates mit Platzhaltern

Quellen

Quellen sind Eingangskanäle. Ein Catch-Typ kann mehrere Quellen gleichzeitig nutzen.

IMAP-Postfach. Host, Port, Benutzer und Passwort eintragen. LyveCatch prüft alle 30 Sekunden auf neue, ungelesene Mails und übernimmt Betreff, Absender, Text und Anhänge.

Mails, die zwischendurch im Webmail geöffnet wurden, gelten als gelesen und werden nicht mehr abgeholt.
Sources: Kanäle einrichten und Tokens verwalten

Uploads & Test

Dateien hochladen

Per Drag & Drop oder Dateiauswahl: PDF, HTML, TXT, CSV, JSON, XML — bis 5 MB je Datei. Jede Datei wird zu einem Catch und durchläuft dieselbe Erkennung wie eine E-Mail.

Uploads: Drag & Drop

Testen ohne echte Daten

Im Test-Tab fügst du einen Beispieltext ein. LyveCatch zeigt, welcher Catch-Typ erkannt würde, mit welcher Confidence, welche Felder extrahiert würden und welche Regeln greifen würden.

Test: Erkennung simulieren

Einstellungen

Settings: Profil, Darstellung, KI, SMTP, Team
Audit-Log: lückenlose Nachvollziehbarkeit

Webhook & API

Sende Daten aus beliebigen Systemen per HTTP POST an die Webhook-URL deiner Quelle (Sources → Endpoint kopieren). Das Feld content (alternativ text) wird als Inhalt verwendet; fehlt beides, dient der gesamte JSON-Body als Inhalt. Der Body kann auch reiner Text sein.

Request

curl -X POST https://DEINE-INSTANZ/api/ingest/webhook/<TOKEN> \
  -H "Content-Type: application/json" \
  -H "x-api-key: <OPTIONAL_API_KEY>" \
  -d '{
    "from": "lieferant@muster-gmbh.de",
    "subject": "Rechnung RE-2026-0812",
    "content": "Rechnungsnummer RE-2026-0812 ... Brutto 1.689,80 EUR"
  }'

Antwort

{
  "id": "87c31150-3bae-4ff5-a4a3-573b97229e03",
  "reference": "LC-10291"
}

Signaturprüfung (HMAC)

Ist an der Quelle ein HMAC-Secret hinterlegt, muss der Header x-signature die HMAC-SHA256-Signatur des Rohtexts enthalten (hex, optional mit Präfix sha256=). Ungültige Signaturen werden mit 401 abgewiesen.

# Optional: Signatur (HMAC-SHA256 über den Rohtext des Bodys)
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -X POST https://DEINE-INSTANZ/api/ingest/webhook/<TOKEN> \
  -H "x-signature: sha256=$SIG" -d "$BODY"

Fehlercodes

Code Bedeutung
401 API-Key oder Signatur fehlt bzw. ist ungültig
404 Unbekannter Token
4xx Monatliches Catch-Kontingent des Pakets ausgeschöpft

Catch-Ideen

Inspiration, was du mit LyveCatch automatisieren kannst. Jede Idee lässt sich mit Feldern, Regeln und Aktionen umsetzen.

🧾 Rechnungen
Quelle: E-Mail-Postfach „rechnungen@“
Felder: Rechnungsnummer, Lieferant, Datum, Netto, MwSt., Brutto
Regel: Brutto > 1.000 € → Mail an Geschäftsführung + Tag high-value
Keine Rechnung mehr übersehen, Duplikate werden markiert.
📦 Aufträge & Bestellungen
Quelle: API / E-Mail
Felder: Bestellnummer, Kunde, Auftragswert, Liefertermin
Regel: Wert > 5.000 € → Webhook an ERP + Mail an Vertrieb
Aufträge landen ohne Abtippen im ERP.
💬 Angebotsanfragen
Quelle: Kontaktformular-Webhook
Felder: Unternehmen, Thema, Dringlichkeit, Ansprechpartner
Regel: Dringlichkeit = hoch → sofort Mail an Vertrieb
Schnellere Antwortzeiten, nichts geht im Postfach unter.
⚠️ Reklamationen
Quelle: Support-Postfach
Felder: Kunde, Produkt, Fehlerbeschreibung, Schweregrad
Regel: Schweregrad = kritisch → Webhook an Ticketsystem + Tag eskaliert
Kritische Fälle werden priorisiert statt chronologisch bearbeitet.
👤 Bewerbungen
Quelle: Karriere-Postfach
Felder: Name, Position, Erfahrung (Jahre), Verfügbarkeit
Regel: Erfahrung ≥ 5 → Mail an HR mit Original-Anhang (Lebenslauf)
HR bekommt strukturierte Übersicht plus die Originalunterlagen.
📄 Verträge & Kündigungen
Quelle: Upload / Postfach
Felder: Vertragspartner, Laufzeit, Kündigungsfrist, Kündigungsdatum
Regel: Kündigung erkannt → Mail an Vertragsmanagement + Tag fristkritisch
Fristen werden nicht mehr verpasst.
🚚 Lieferscheine
Quelle: Upload / E-Mail
Felder: Lieferscheinnummer, Lieferant, Positionen, Menge
Regel: Immer → Webhook ans Warenwirtschaftssystem
Wareneingang wird automatisch gebucht.
📝 Formulare & Anträge
Quelle: Webhook
Felder: Antragsteller, Antragsart, Datum, Betrag
Regel: Confidence niedrig → Kontrolle, sonst Bestätigungs-Mail
Der Mensch prüft nur, was die KI nicht sicher weiß.
🔔 Monitoring-Alarme
Quelle: Webhook / API
Felder: System, Schweregrad, Meldung, Zeitpunkt
Regel: Schweregrad = critical → Mail + Webhook an Bereitschaft
Alarme aus verschiedenen Tools an einem Ort, mit einheitlichen Feldern.

Rollen & Rechte

Rolle Rechte
ViewerNur ansehen.
MemberZusätzlich: Catches bearbeiten und löschen, freigeben und ablehnen.
AdminZusätzlich: Catch-Typen, Sources, Settings und Team verwalten.
OwnerWie Admin; kann zusätzlich nicht entfernt werden.

Pakete & Limits

Das Paket bestimmt Kontingent, Teamgröße und den Umfang der Automatisierung. Ohne freigeschaltetes Paket befindet sich ein Konto im Ansichtsmodus: alles ansehen, nichts nutzen.

Paket Catches / Monat Nutzer Regeln / Typ Extras
Starter10032
Starter Plus25055
Business5001010Eigenes SMTP, Original-Anhänge, HTTP-Methoden, Prioritäts-Support
Pro2.50025unbegrenztAlles aus Business + erweiterte Integrationen
EnterpriseindividuellindividuellunbegrenztIndividuelle Limits

FAQ & Fehlersuche

Bereit für deinen ersten Catch?

Melde dich an und lege deinen ersten Catch-Typ in wenigen Minuten an.