Fachagent Logo

1. Einstieg

Fachagent ist eine SaaS-Plattform für KI-Fachberater auf Websites. Du verwaltest im Dashboard:

  • Companies — dein Unternehmen mit Produkten, Services und Markensprache
  • Agents — KI-Berater mit Rolle, FAQ und Call-to-Action
  • Custom GPTs — das Sprachmodell: Persona, Expertise, Gesprächsstil
  • Integrationen — Widget-Konfiguration für deine Website

Der schnellste Weg: Nutze den Setup Wizard im Dashboard, um in drei Schritten Company, Agent und Widget einzurichten.

2. API-Keys

Jede Integration benötigt einen API-Key zur Authentifizierung. API-Keys werden automatisch beim Erstellen einer Integration generiert.

  1. Im Dashboard anmelden
  2. Unter Integrationen eine neue Integration anlegen
  3. Der API-Key wird automatisch erzeugt und im Snippet angezeigt
Sicherheitshinweis: API-Keys sind wie Passwörter — teile sie nicht öffentlich und speichere sie niemals in Git-Repositories oder Client-seitigem Quellcode. Die Widget-Skripte sind für die Frontend-Einbindung konzipiert und nutzen Keys mit eingeschränktem widget-Scope.

3. Chat-Widgets einbinden

Es gibt zwei Widget-Typen: ein schwebendes („Floating") Widget und ein statisches Widget.

3.1 Floating Chat

Fügt einen runden Button unten rechts hinzu, der einen Chat-Dialog öffnet. Ideal für Landingpages und allgemeine Websites. 

<script
  src="https://fachagent.com/widget/floating-chat.js"
  data-int-id="DEINE_INTEGRATION_UUID"
  data-key="DEIN_API_KEY"
  data-primary-color="#6366f1"
  defer
></script>

3.2 Statischer Chat

Platziert den Chat fest im Seitenlayout. Ideal für Kontaktseiten oder eingebettete Beratungsseiten. 

<script
  src="https://fachagent.com/widget/static-chat.js"
  data-int-id="DEINE_INTEGRATION_UUID"
  data-key="DEIN_API_KEY"
  data-primary-color="#6366f1"
  defer
></script>

3.3 Widget-Attribute

Attribut Pflicht Beschreibung
data-int-id Ja Die öffentliche UUID deiner Integration (im Snippet enthalten)
data-key Ja Dein API-Key (im Snippet enthalten)
data-primary-color Nein Hex-Farbwert für Buttons und Akzente (Standard: aus Integration)

Tipp: Das komplette Snippet findest du unter Integrationen → Snippet in deinem Dashboard. Du musst nur Copy & Paste verwenden.

3.4 Kompatibilität

Die Widgets funktionieren auf jeder Website — WordPress, Shopify, TYPO3, Webflow, statische HTML-Seiten oder eigene Anwendungen. Das Script-Tag wird einfach vor </body> eingefügt.

4. Nutzung & Limits

Dein Token-Verbrauch und die Plan-Limits siehst du im Dashboard.

  • Verbrauchte Tokens — Summe aller Anfragen in der aktuellen Abrechnungsperiode
  • Inklusive — Token-Kontingent deines Plans (monatlich/jährlich)
  • Verbleibend — Restkontingent bis zum nächsten Abrechnungszyklus
  • Plan-Limits — maximale Anzahl an Companies, Agents, Custom GPTs und Integrationen

Wenn dein Token-Kontingent erschöpft ist, wird die Chat-Funktion automatisch pausiert. Ein Upgrade auf einen höheren Plan erhöht das Kontingent sofort.

5. Datenschutz & DSGVO

Fachagent wurde von Grund auf DSGVO-konform entwickelt:

  • Privacy-API (Ainonyme) — Alle Nutzernachrichten werden vor der Verarbeitung durch das Sprachmodell automatisch anonymisiert. Personenbezogene Daten (Namen, E-Mails, Telefonnummern, IBAN etc.) werden erkannt und ersetzt.
  • Hosting in der EU — Daten werden auf europäischen Servern verarbeitet und gespeichert.
  • Datenschutzhinweis im Widget — Jedes Widget zeigt vor der ersten Nachricht einen konfigurierbaren Datenschutzhinweis mit Link zu deiner Datenschutzerklärung.
  • Konfigurierbare Privacy-Einstellungen — Im Dashboard unter Company → Privacy kannst du Kategorien (Name, E-Mail, Telefon etc.) und das Fehlerverhalten individuell einstellen.

6. REST-API (Preview)

Die Chat-API kann auch direkt per HTTP angesprochen werden. Authentifizierung erfolgt über den X-API-KEY Header. 

curl -X POST https://fachagent.com/api/chat \
  -H "X-API-KEY: DEIN_API_KEY" \
  -H "X-Integration: DEINE_INTEGRATION_UUID" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Welche Pläne gibt es?"
  }'

Die Antwort enthält:

{
  "answer": "Wir bieten drei Pläne an: ...",
  "conversation_id": "01JM...",
  "meta": {
    "cta_url": "/register",
    "cta_link_text": "Kostenlos registrieren",
    "tokens_exhausted": false
  }
}
Preview: Die REST-API befindet sich in der Vorschau-Phase. Endpoints und Parameter können sich noch ändern. Für die Website-Integration empfehlen wir die Widget-Skripte.

7. Support

Bei Fragen oder Problemen stehen dir folgende Wege offen: