Chat

Chatten Sie in Ihrer eigenen App oder Ihrem Kundenservice-System mit der AI – mit Streaming-Antworten sowie Übergabe an einen Menschen, Beenden und Bewerten der Konversation.

POST /v1/chat

{
  "message": "有没有 400 美元以内的潜水表？",
  "conversation_id": null,
  "user": {"id": "u_123", "name": "李四", "email": "li@example.com", "ip": "85.214.132.117", "language": null},
  "stream": false
}

Wenn conversation_id nicht übergeben wird, wird eine neue Konversation erstellt; sie wird in der Antwort zurückgegeben und bei nachfolgenden Nachrichten mitgesendet.
user wird von deinem Server direkt an uns übergeben (API-Key-Aufrufer sind vertrauenswürdig). Nur wenn er übergeben wird, können Bestellungen abgefragt werden.
Standard-Antwortsprache: Übergibst du user.language (z. B. de, zh-CN, pt-BR), wird sie verwendet; andernfalls übergibst du user.ip, und wir bestimmen die Sprache anhand des Standorts; wenn beides fehlt, wird die Standardsprache im Backend verwendet. Wenn der Kunde im Gespräch um einen Sprachwechsel bittet, gilt die Anfrage des Kunden.
Bei stream: false wird {"conversation_id", "message", "status", "products"} zurückgegeben; ist message gleich null, wird die Konversation von einem Mitarbeiter betreut und die Nachricht wurde an einen Mitarbeiter weitergeleitet.
Bei stream: true wird SSE zurückgegeben; die Ereignisse findest du in der Tabelle unten.

Ereignis `type`	Inhalt
`user_message`	Gespeicherte Nutzernachricht
`delta`	Ein Textabschnitt `text` der Antwort, der in der Reihenfolge zusammengesetzt wird
`products`	Vom AI gefundene Produktkarten
`language`	Der Kunde hat eine andere Antwortsprache verlangt; `language` ist der neue Sprachcode
`status`	Statusänderung der Konversation (z. B. Übergabe an einen Mitarbeiter)
`replace`	Ersetzt die bereits empfangene Antwort vollständig durch `text` (bei Fehlern durch einen Fallback-Text)
`queued_for_human`	Die Konversation wird von einem Mitarbeiter betreut; es gibt keine AI-Antwort
`done`	Die endgültig gespeicherte Nachricht und der Konversationsstatus
`error`	Fehler

Weitere Endpunkte

Methode	Pfad	Beschreibung
GET	`/v1/conversations`	Konversationsliste, `?status=&end_user_id=`
GET	`/v1/conversations/{id}/messages`	Konversation und alle Nachrichten
POST	`/v1/conversations/{id}/messages`	Dein Kundenservice-System antwortet als Mitarbeiter: `{"content", "agent_name"}`; die Konversation wechselt anschließend in den Mitarbeiterstatus
POST	`/v1/conversations/{id}/status`	Aktion der Kundenservice-Seite: `{"status": "ai"}` gibt an die AI zurück, `{"status": "closed"}` beendet die Konversation
POST	`/v1/conversations/{id}/close`	Der Kunde beendet die Konversation in deiner App; bereits beendete Konversationen werden ebenfalls erfolgreich zurückgegeben
POST	`/v1/conversations/{id}/rating`	Kundenbewertung nach dem Ende der Konversation: `{"rating": "good" \| "bad", "comment": "可选，最多 500 字"}`; kann geändert werden

Konversationsstatus: ai (AI antwortet), pending_human (wartet auf einen Mitarbeiter), human (wird von einem Mitarbeiter betreut), closed (beendet).

Außerdem enthält die Konversation: closed_by – wer beendet hat (customer Kunde, agent Mitarbeiter, ai AI beendet, nachdem der Kunde signalisiert hat, dass keine weiteren Fragen offen sind), rating / rating_comment / rated_at – Kundenbewertung.

Konversation beenden: Im Kopf des Web-Widgets gibt es die Schaltfläche „Konversation beenden“ (mit Bestätigungsabfrage); im WeChat Mini Program wird die Konversation ebenfalls beendet, wenn der Kunde „Ende“ sendet; wenn in den „Bot-Einstellungen“ die Option „AI beendet Konversationen automatisch“ aktiviert ist, beendet die AI die Konversation nach der Verabschiedung, sobald der Kunde eindeutig mitteilt, dass keine weiteren Fragen offen sind. Nach dem Ende bittet das Web-Widget den Kunden, mit „Zufrieden“ / „Nicht zufrieden“ zu bewerten und optional eine Nachricht zu hinterlassen; in WeChat wird der Kunde gebeten, mit 1 oder 2 zu antworten. Wenn der Kunde danach erneut schreibt, beginnt eine neue Konversation.

Zuweisung nach der Übergabe an einen Mitarbeiter: In den „Bot-Einstellungen“ wählst du die Zuweisungsmethode – an den Mitarbeiter mit den wenigsten laufenden Konversationen (Standard), reihum oder durch Mitarbeiter, die selbst annehmen. Die automatische Zuweisung erfolgt nur an Mitarbeiter, die „online“ ausgewählt haben und deren Backend-Seite geöffnet ist; jede Person hat ein Limit für gleichzeitige Konversationen (Einstellung auf der Seite „Team“). Antwortet der zugewiesene Mitarbeiter nicht innerhalb der festgelegten Zeit (Standard: 2 Minuten), wird die Konversation neu zugewiesen. assigned_member_id in der Konversation ist der zugewiesene Mitarbeiter, assigned_at ist der Zuweisungszeitpunkt und handoff_at ist der Zeitpunkt der Übergabe an einen Mitarbeiter. Wenn alle Mitarbeiter ausgelastet sind, warten Kunden in der Warteschlange; das Web-Widget zeigt an, wie viele Personen vor ihnen stehen.

Öffnungszeiten und Nachrichten: Wenn du in den „Bot-Einstellungen“ die Öffnungszeiten aktivierst, kommen Kunden außerhalb der Öffnungszeiten bei einer Übergabe an einen Mitarbeiter nicht in die Warteschlange; das Web-Widget zeigt ein Formular zum Hinterlassen einer Nachricht (Name, E-Mail oder Telefon, Anliegen). In WeChat- und Open-API-Konversationen bittet die AI den Kunden, eine Nachricht zu hinterlassen; dasselbe gilt innerhalb der Öffnungszeiten, wenn kein Mitarbeiter online ist. Aus einer Nachricht wird ein Ticket erstellt; wenn ein Mitarbeiter antwortet, wird die Antwort in die Konversation gesendet, sofern diese noch nicht beendet ist. Hat der Kunde eine E-Mail-Adresse hinterlassen, wird zusätzlich im Namen des Shops eine E-Mail gesendet. Wenn nur an dein System gepusht wird (Übergabemethode „An mein System senden“), werden die Öffnungszeiten nicht berücksichtigt.

War diese Seite hilfreich?

Zuletzt aktualisiert: 31. Oktober 2026