assistant

POST `/v1/assistant/conversations`

Start a new assistant conversation.

Автентифікація

Надішліть ключ API як маркер носія (bearer token). Ключ повинен мати дозвіл tickets.reply; ключ без нього відхиляється з кодом 403, а не 404.

Де вказується ідентифікатор вашої організації

Цей ендпоінт приймає org_id як поле в тілі JSON.

Ідентифікатор вашої організації знаходиться на екрані API-ключів у вашій панелі керування, поруч із самим ключем. Це той самий ідентифікатор у кожному вашому запиті.

Спробувати

Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.

curl -X POST https://api.zinndigital.com/v1/assistant/conversations \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API

Деталі

Creates an empty thread. Nothing is sent to a model until you post a message. Requires `tickets.reply`.

Тіло запиту

Назва	Тип	Обов'язкове	Що це таке
`org_id`	`Uuid`	Ні	Required only when you can act in more than one organization.

Відповідь

Назва	Тип	Обов'язкове	Що це таке
`id`	`Uuid`	Так	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`title`	`string`	Так	The first question, truncated, so a list of threads is readable.
`escalated_ticket_id`	`Uuid`	Так	Set once this thread became a support ticket.
`created_at`	`string`	Так	—
`updated_at`	`string`	Так	—

Помилки, які може повертати ця кінцева точка

401 · 403 · 422 · 429