Glossar
Zentrale Begriffe in Fynex. Diese Definitionen sind mit Produkt und Dokumentation abgestimmt.
Kernkonzepte
| Begriff | Definition |
|---|---|
| AI agent | Ein konversationeller Agent, der Schuldner per WhatsApp, Voice, E-Mail oder SMS kontaktiert, Strategy-Regeln einhält, Interactions und Zusagen protokolliert und bei erfüllten Kriterien eskaliert. |
Accounts & Kontakte
| Begriff | Definition |
|---|---|
| Account | Ein Forderungsdatensatz in Ihrem Portfolio. Enthält Betrag, Fälligkeit, Status und zugeordneten Kontakt. |
| Contact | Die mit einem Account verknüpfte Person — Name, E-Mail, Telefon, WhatsApp-Nummer. |
| Reference | Ihre interne Kennung für den Account (Rechnungsnummer, Vorgangs-ID usw.). |
| Portfolio | Die Gesamtheit aller Accounts Ihrer Organisation. |
Status
| Status | Gilt für | Bedeutung |
|---|---|---|
| New | Account | Kürzlich importiert, noch nicht kontaktiert. |
| Pending Contact | Account | Für erste Kontaktaufnahme geplant. |
| Auto Management | Account | Wird von AI-Agents bearbeitet. |
| Active Conversation | Account | Agent führt gerade ein Gespräch mit dem Schuldner. |
| Promise Active | Account / Promise | Schuldner hat Zahlung zugesagt, innerhalb der Frist. |
| Promise Overdue | Account / Promise | Zahlungszusage überfällig. |
| Paid | Account | Forderung erledigt. |
| Escalated | Account | Erfordert menschliches Eingreifen. |
| Paused | Account | Vorübergehend von automatisierten Kontakten ausgenommen. |
Strategie & Kampagnen
| Begriff | Definition |
|---|---|
| Strategy | Regelwerk, wie Agents Schuldner kontaktieren: Kanäle, Sequenz, Häufigkeit, Escalation-Kriterien. |
| Action Sequence | Geordnete Liste der Kontaktschritte in einer Strategy (z. B. E-Mail Tag 1, SMS Tag 3, Call Tag 7). |
| Campaign | Operative Gruppierung von Accounts unter einer Strategy und einem Zeitraum. Die Execution Engine setzt Campaign-Status (draft/active/paused/completed) und Datumsbereich durch. Aktive Campaigns können manuell oder automatisch enqueued werden. |
| Escalation | Ein Account wird in die Human-Queue verschoben, weil Kriterien erfüllt sind (max. Versuche, Tage ohne Antwort) oder der Agent es anfordert. |
| Escalation Criteria | Bedingungen für menschliche Prüfung: maximale Versuche erreicht oder Tage ohne Antwort. |
Kanäle
| Begriff | Definition |
|---|---|
| Channel | Kommunikationsweg: E-Mail, SMS, WhatsApp oder Voice. |
| Voice opening mode | Bei AI-Voice-Calls, ob der Angerufene zuerst spricht (Agent wartet auf Abnahme, dann Prompt-Script) oder der Agent zuerst spricht (sofortige Begrüßung per TTS). Auflösung: manuelle Call-Wahl → Strategy + Step → Voice-Default der Organisation → Produkt-Default. |
| Credential Mode | Ob Fynex-Credentials („platform“) oder Ihre eigenen („self-managed“) für einen Provider genutzt werden. |
| Dispatch | Das Senden einer Nachricht oder Starten eines Calls an einen Schuldner. |
| Template | Vordefinierte Nachricht mit Platzhaltern, die Agents bei der Kontaktaufnahme verwenden. |
Interactions & Zusagen
| Begriff | Definition |
|---|---|
| Interaction | Ein einzelnes Kontaktereignis (Nachricht gesendet, Call geführt) mit Kanal, Ergebnis und Zeitstempel. |
| Promise | Zusage des Schuldners, einen bestimmten Betrag bis zu einem Datum zu zahlen. |
| Modality | Ob die Zusage die Gesamtforderung oder einen Teilbetrag abdeckt. |
| Opt-out | Der Schuldner wünscht keine weitere Kontaktaufnahme. Alle künftigen Dispatches an diesen Kontakt sind blockiert. |
| Disposition | Detaillierte Ergebnisklassifikation eines Voice-Calls (z. B. Zahlungszusage, Rückruf vereinbart, Ablehnung, falsche Nummer). |
| Contact Result | Ob die gewünschte Person im Call erreicht wurde (verbunden, keine Antwort, Mailbox, falsche Nummer, getrennt usw.). |
| Callback | Ein Rückruf auf Wunsch des Schuldners. Der Strategy-Step pausiert, bis der Callback ausgelöst wird. |
| Channel Preference | Bevorzugter Kommunikationskanal des Schuldners, erfasst in Calls und für künftige Kontakte genutzt. |
| Phone Rotation | Automatische Wahl der besten Telefonnummer für einen Call unter Berücksichtigung früherer Ergebnisse (falsche/getrennte Nummern) und Alternativnummern. |
Ausführung & Zahlungen
| Begriff | Definition |
|---|---|
| Execution Queue | Die Arbeitsqueue, in die die Engine ausstehende Dispatch-Actions legt. Items durchlaufen pending → processing → completed/failed/skipped. |
| Payment | Erfasster Geldfluss vom Schuldner. Reduziert automatisch den Account-Saldo und kann eine Promise erfüllen. |
| Dispute | Formeller Einwand des Schuldners. Solange offen, separat mit Status, Grund und Lösungsnotizen geführt. |
| Notification | In-App-Hinweis auf wichtige Ereignisse: überfällige Zusagen, Eskalationen, Channel-Fehler, Batch-Fehler. |
Integration & API
| Begriff | Definition |
|---|---|
| API Key | Geheimer Token für Machine-to-machine-Authentifizierung an der Fynex REST API. Wird unter Einstellungen > Integrationen angelegt. |
| Webhook | HTTP-Callback, den Fynex an Ihren Server sendet, wenn bestimmte Events eintreten (z. B. Account angelegt, Promise gebrochen). |
| External ID | Eindeutige Kennung aus Ihrem Quellsystem, gespeichert bei Accounts und Contacts für die Zuordnung zwischen Systemen. |
| Source System | Bezeichnung des externen Systems, aus dem ein Account oder Kontakt importiert wurde (z. B. „core_banking“, „crm“). |
| Scope | Berechtigungsstufe eines API-Keys, die steuert, auf welche Ressourcen lesend/schreibend zugegriffen werden darf. |
| Upsert | Create-or-Update: Existiert ein Datensatz mit derselben external_id, wird er aktualisiert; sonst wird ein neuer angelegt. |
| HMAC Signature | Kryptografischer Hash zur Prüfung, dass Webhook-Payloads von Fynex stammen und nicht manipuliert wurden. |
| Import Job | Asynchrone Verarbeitung eines Batches von Accounts über die API mit Fortschritts- und Fehlertracking. |
Sprache
| Begriff | Definition |
|---|---|
| Locale | Regionale Sprachvariante (z. B. es-AR, pt-BR, en-US). Bestimmt Dialekt, Compliance-Regeln, Voice und Templates für ausgehende Inhalte. |
| Language cascade | Prioritätsreihenfolge, mit der Fynex die Sprache für ausgehende Interactions wählt: manuelles Override → Kontaktsprache → Organisations-Locale → Länder-Default → es. |
| Supported languages | Spanisch (es — Argentinien, Mexiko, Kolumbien), Portugiesisch (pt — Brasilien) und Englisch (en — USA). Organisations-Locale unter Einstellungen; pro-Kontakt-Sprache beim Portfolio-Import. |
Compliance
| Begriff | Definition |
|---|---|
| Frequency Limits | Maximale Kontakte pro Tag und Woche, konfiguriert unter Einstellungen. |
| Allowed Hours | Tägliches Zeitfenster, in dem Kontakte erlaubt sind. |
| Audit Log | Unveränderlicher Nachweis aller Systemereignisse, Aktionen und Konfigurationsänderungen. |
| Dispatch Validation | Prüfungen vor dem Versand (Opt-out, Häufigkeit, Zeiten, pausierter Status), die jede Kontaktaufnahme bestehen muss. |