assistant

GET `/v1/assistant/conversations/{conversationId}`

Read one conversation with its full thread.

تصدیق‌هویت

د بیارر ټوکن په توګه یو API کي وسپارئ. دا پای ټکی په مشخصاتو کې کوم ځانګړی اجازه لیک نه بیانوي، نو خپل کیلي ته لږترلږه هغه څه ورکړئ چې ورته اړتیا لري او د فرض کولو پر ځای ځواب وپلټئ.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

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

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

⛔ A colleague's conversation is a `404`, never a `403` — a `403` confirms the id exists, which is itself information about what a colleague has asked.

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`conversationId (path)`	`Uuid`	هو	The conversation's id.

ځواب

نوم	ډول	اړین	دا څه شی دی
`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`	هو	—
`messages`	`AssistantMessage[]`	هو	—
`proposals`	`AgentProposal[]`	هو	Actions the assistant suggested in this thread. Nothing here has happened — a proposal is a suggestion with a confirm button, and it is applied only by `POST /v1/ai/proposal…

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

401 · 403 · 404 · 429

GET /v1/assistant/conversations/{conversationId}