assistant
POST /v1/assistant/conversations/{conversationId}/escalate
Turn a conversation into a support ticket.
प्रमाणन
बेरर टोकन के रूप में एक API कुंजी भेजें। कुंजी के पास tickets.reply अनुमति होनी चाहिए; इसके बिना एक कुंजी को 404 के बजाय 403 के साथ अस्वीकार कर दिया जाता है।
यह एंडपॉइंट कोई संगठन आईडी नहीं लेता है। आपकी कुंजी पहले से ही उस संगठन की पहचान करती है जिससे वह संबंधित है, और प्रतिक्रिया उसी के दायरे में है।
इसे आज़माएँ
कोणार्कित ब्रैकेट्स में दी गई किसी भी चीज़ को अपने मानों से बदलें, और की प्लेसहोलर को अपने डैशबोर्ड की एक की से बदलें।
curl -X POST https://api.zinndigital.com/v1/assistant/conversations/{conversationId}/escalate \
-H "Authorization: Bearer zdk_live_…"साइन इन हैं? आपके डैशबोर्ड में मौजूद API कंसोल आपकी वास्तविक संगठन आईडी और आपकी अपनी कुंजी स्वतः भर देता है, और लाइव 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