Kontakt
Deutsch
Kostenlos testen

Kundendaten-Connector

Profilfelder, Listen und Hinweise aus Ihren eigenen Systemen im Kundenbereich jedes Tickets anzeigen.

Zur besseren Verständlichkeit übersetzt. Code, Feldnamen und die API-Referenz bleiben auf Englisch. Englische Fassung

Mit dem Kundendaten-Connector sehen Agents direkt im Ticket, was Ihre eigenen Systeme über einen Kunden wissen (Plan, Bestellungen, Kontostatus, offene Störungen), ohne Seitenleisten-App.

So funktioniert es

  1. Ein Admin legt den Connector-Endpunkt (URL und Authentifizierung) unter Admin Center, Integrations, Customer data fest.
  2. Öffnet ein Agent ein Ticket, ruft HelpFalcon Ihren Endpunkt mit den Kennungen des Anfragenden auf (E-Mail, externe ID, Telefon).
  3. Ihr Endpunkt antwortet mit JSON: Profilfelder, Listen (zum Beispiel die letzten Bestellungen) und Hinweise (zum Beispiel „Zahlung überfällig“).
  4. HelpFalcon zeigt die Antwort im Kundenbereich an.

Ihr Endpunkt

  • HTTPS, erreichbar von unseren veröffentlichten ausgehenden IP-Adressen.
  • Authentifizierung: ein API-Schlüssel in einem Header Ihrer Wahl (zum Beispiel X-API-Key oder Authorization: Bearer ...) oder OAuth Client Credentials (Token-URL, Client-ID und Secret, optional Scope und Audience).
  • Timeout: 1 bis 15 Sekunden (Standard 5). Danach meldet der Bereich dem Agent, dass Ihr System nicht geantwortet hat, ohne das Ticket zu blockieren.
  • Cache: 0 bis 86400 Sekunden pro Kunde (Standard 300). Agents können den Bereich von Hand aktualisieren; Fehler werden 15 Sekunden gecacht.
  • Antworten Sie mit 404 oder "found": false, wenn Sie keinen Datensatz haben; der Bereich zeigt das an.
  • HelpFalcon speichert keine dieser Daten, und der Bereich schreibt nie in Ihr System zurück.

Der Kundenkontext ist auch über die REST-API unter GET /api/users/{id}/customer_context verfügbar, sodass Regeln und Integrationen dieselben Daten nutzen können.