Skip to main content
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

integer
erforderlich
Die ID des Assistenten, der für die Antwortgenerierung verwendet werden soll. Muss zu deinem Konto gehören.
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.
string
erforderlich
Die Nachricht des Kunden, auf die geantwortet werden soll.
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

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

Fehlerantworten

boolean
Wird false sein, wenn ein Fehler auftritt
string
Fehlermeldung, die beschreibt, was schiefgelaufen ist
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