assistant
POST /v1/assistant/conversations/{conversationId}/escalate
Turn a conversation into a support ticket.
認証
ベアラー トークンとして API キーを送信します。キーには tickets.reply 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。
このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X POST https://api.zinndigital.com/v1/assistant/conversations/{conversationId}/escalate \
-H "Authorization: Bearer zdk_live_…"ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 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). |
このエンドポイントが返すエラー
401 · 403 · 404 · 422 · 429