assistant

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

Turn a conversation into a support ticket.

Všechny koncové body assistant

Autentizace

Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění tickets.reply; klíč bez něj je odmítnut s kódem 403, nikoli 404.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

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

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

⭐ 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

NázevTypPožadovánoCo to je
conversationId (path)UuidAnoThe conversation's id.

Odpověď

NázevTypPožadovánoCo to je
ticket_idUuidAnoUUIDv7 identifier — sortable by creation time (docs/02 §8).

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 422 · 429