KI-Antwort generieren
KI-Antwort generieren
Generiert eine KI-Antwort mit einem Assistenten basierend auf einer Kundenkennung
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.
Request Body
Die ID des Assistenten, der für die Antwortgenerierung verwendet werden soll. Muss zu deinem Konto gehören.
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.
Die Nachricht des Kunden, auf die geantwortet werden soll.
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
Gibt an, ob die Anfrage erfolgreich war
Die UUID der Konversation. Verwende diese, um die Konversation später zu verfolgen oder darauf zu verweisen.
Die im Request bereitgestellte Kundenkennung
Die von der KI generierte Antwort auf die Kundennachricht
Array von Funktionsaufrufen, die der Assistent während der Verarbeitung der Nachricht durchgeführt hat. Leeres Array, wenn keine Funktionen aufgerufen wurden.
Gibt an, ob KI-Antworten für diese Konversation deaktiviert sind (z.B. aufgrund einer manuellen Übernahme)
Fehlerantworten
Wird
false sein, wenn ein Fehler auftrittFehlermeldung, die beschreibt, was schiefgelaufen ist
Maschinenlesbarer Fehlercode. Mögliche Werte:
ASSISTANT_NOT_FOUND- Die Assistenten-ID ist ungültig oder gehört nicht zu deinem KontoINSUFFICIENT_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:- Empfange eine Nachricht von WhatsApp, Facebook, SMS oder einem anderen Kanal
- Rufe diesen Endpunkt mit der Nachricht und der Kundenkennung auf
- 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 ausassistant_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_idfür spätere Referenz oder Fehlerbehebung - Kosten überwachen: Verfolge die Nutzung, um Kosten zu verwalten, insbesondere bei Integrationen mit hohem Volumen

