assistant

POST /v1/assistant/conversations/{conversationId}/escalate

Turn a conversation into a support ticket.

Wszystkie punkty końcowe assistant

Uwierzytelnianie

Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie tickets.reply; klucz bez niego jest odrzucany z kodem 403, a nie 404.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

curl -X POST https://api.zinndigital.com/v1/assistant/conversations/{conversationId}/escalate \
  -H "Authorization: Bearer zdk_live_…"

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

⭐ The point of `needs_human`. Opens a ticket carrying the whole transcript, so the customer does not start again somewhere else and the agent opens something that already contains the question and what the assistant could not do. **Idempotent** — a second call returns the same ticket with `200` rather than opening a duplicate. Requires `tickets.reply`.

Parametry

NazwaTypWymaganeCo to jest
conversationId (path)UuidTakThe conversation's id.

Odpowiedź

NazwaTypWymaganeCo to jest
ticket_idUuidTakUUIDv7 identifier — sortable by creation time (docs/02 §8).

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404 · 422 · 429