Zum Hauptinhalt springen
POST
KI-Antwort generieren
Dieser Endpunkt erzeugt automatisch eine intelligente Antwort auf eine Kundennachricht mithilfe deines konfigurierten KI-Assistenten. Das System verwaltet dabei automatisch den Gesprächskontext für jeden Kunden, sodass der Assistent sich an vorherige Nachrichten erinnert und kontextbezogen antworten kann. Ideal für die Integration in externe Messaging-Plattformen, CRMs oder eigene Chat-Oberflächen.
Rate Limit: Dieser Endpunkt ist auf 5 Anfragen pro Minute pro API-Token begrenzt, um Missbrauch zu verhindern.

Request Body

assistant_id
integer
erforderlich
Die ID des Assistenten, der für die Antwortgenerierung verwendet werden soll. Muss zu deinem Konto gehören.
customer_identifier
string
erforderlich
Eine eindeutige Kennung für den Kunden. Diese wird verwendet, um den Gesprächskontext über mehrere Nachrichten hinweg zu erhalten.Beispiele: Telefonnummer, E-Mail-Adresse, CRM-Kontakt-ID, Facebook-Benutzer-ID.Maximale Länge: 255 Zeichen.Wichtig: Verwende immer dasselbe Format für denselben Kunden, damit der Kontext korrekt zugeordnet wird.
message
string
erforderlich
Die Nachricht des Kunden, auf die geantwortet werden soll.
variables
object
Optionale Kontextvariablen, die an den Assistenten übergeben werden. Diese werden mit vorhandenen Gesprächsvariablen zusammengeführt.Nützlich für die Übergabe von Kundendaten, Sitzungskontext oder anderen Metadaten, die die Antwort personalisieren können.

Antwort-Felder

success
boolean
Gibt an, ob die Anfrage erfolgreich war
conversation_id
string
Die UUID der Konversation. Verwende diese, um die Konversation später zu verfolgen oder darauf zu verweisen.
customer_identifier
string
Die im Request bereitgestellte Kundenkennung
reply
string
Die von der KI generierte Antwort auf die Kundennachricht
function_calls
array
Array von Funktionsaufrufen, die der Assistent während der Verarbeitung der Nachricht durchgeführt hat. Leeres Array, wenn keine Funktionen aufgerufen wurden.
ai_disabled
boolean
Gibt an, ob KI-Antworten für diese Konversation deaktiviert sind (z.B. aufgrund einer manuellen Übernahme)

Fehlerantworten

success
boolean
Wird false sein, wenn ein Fehler auftritt
error
string
Fehlermeldung, die beschreibt, was schiefgelaufen ist
error_code
string
Maschinenlesbarer Fehlercode. Mögliche Werte:
  • ASSISTANT_NOT_FOUND - Die Assistenten-ID ist ungültig oder gehört nicht zu deinem Konto
  • INSUFFICIENT_BALANCE - Dein Kontoguthaben ist zu niedrig, um die Nachricht zu verarbeiten

Anwendungsfälle

Multi-Channel KI-Antworten

Nutze diesen Endpunkt, um KI-Antworten zu jeder Messaging-Plattform hinzuzufügen:
  1. Empfange eine Nachricht von WhatsApp, Facebook, SMS oder einem anderen Kanal
  2. Rufe diesen Endpunkt mit der Nachricht und der Kundenkennung auf
  3. Sende die KI-Antwort über den ursprünglichen Kanal zurück

CRM-Integration

Integriere KI-Antworten in dein CRM oder Helpdesk-System:
  • Verwende die CRM-Kontakt-ID als customer_identifier
  • Übergib Kundendaten als Variablen für personalisierte Antworten
  • Die Konversation bleibt über Sitzungen hinweg erhalten, wenn dieselbe Kennung verwendet wird

Eigene Chat-Oberflächen

Erstelle deine eigene Chat-Oberfläche, die von deinem Famulor-Assistenten angetrieben wird:
  • Generiere eine eindeutige Kennung für jede Benutzersitzung
  • Sende Nachrichten über diesen Endpunkt
  • Zeige die KI-Antworten in deiner Oberfläche an

Konversations-Persistenz

Konversationen werden automatisch basierend auf der Kombination aus assistant_id und customer_identifier gespeichert:
  • Gleiche Kennung: Nachrichten werden zur bestehenden Konversation hinzugefügt, wobei der vollständige Kontext erhalten bleibt
  • Neue Kennung: Eine neue Konversation wird für den Kunden erstellt
  • Variablen-Zusammenführung: Wenn Variablen bereitgestellt werden, werden sie mit vorhandenen Konversationsvariablen zusammengeführt

Best Practices

  • Konsistente Kennungen verwenden: Verwende immer dasselbe Format für Kundenkennungen (z.B. immer E.164 für Telefonnummern)
  • Relevanten Kontext übergeben: Nutze das variables-Feld, um Kundendaten bereitzustellen, die der KI helfen, Antworten zu personalisieren
  • Rate Limits handhaben: Implementiere Wiederholungslogik mit exponentiellem Backoff für rate-limitierte Anfragen
  • Konversations-IDs speichern: Speichere die zurückgegebene conversation_id für spätere Referenz oder Fehlerbehebung
  • Kosten überwachen: Verfolge die Nutzung, um Kosten zu verwalten, insbesondere bei Integrationen mit hohem Volumen