assistant

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

Turn a conversation into a support ticket.

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението tickets.reply; ключ без него се отхвърля с 403, а не с 404.

Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

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

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата

Детайли

⭐ 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`.

Параметри

Име	Тип	Задължително	Какво представлява
`conversationId (path)`	`Uuid`	Да	The conversation's id.

Отговор

Име	Тип	Задължително	Какво представлява
`ticket_id`	`Uuid`	Да	UUIDv7 identifier — sortable by creation time (docs/02 §8).

Грешки, които този крайpoint може да върне

401 · 403 · 404 · 422 · 429

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