बातचीत रेफ़रेंस हल करें

curl -G https://api.elevenlabs.io/v1/convai/conversations/resolve \
     -d agent_id=agent_3701k3ttaq12ewp8b7qv5rfyszkz \
     --data-urlencode reference=https://your-domain.zendesk.com/agent/tickets/12345

{
  "agent_id": "agent_3701k3ttaq12ewp8b7qv5rfyszkz",
  "status": "processing",
  "metadata": {
    "start_time_unix_secs": 1714423232,
    "call_duration_secs": 10,
    "cost_fiat": 1.1
  },
  "conversation_id": "conv_7401k5m9x2p8ec3rqv6dtnhb0fzw",
  "has_audio": true,
  "has_user_audio": true,
  "has_response_audio": true,
  "has_auxiliary_audio": true,
  "transcript": [
    {
      "role": "user",
      "time_in_call_secs": 10,
      "message": "Hello, how are you?"
    }
  ],
  "agent_name": "My agent",
  "version_id": "agtvrsn_5xM3yVvZQKV0EfqQpLr2",
  "environment": "production",
  "tag_ids": []
}

बातचीत के URL (Slack मैसेज URL या Zendesk टिकट URL) को दिए गए एजेंट की निर्धारक बातचीत ID में बदलें, फिर पुष्टि करें कि बातचीत मौजूद है।

क्वेरी पैरामीटर

agent_idstringआवश्यक

एजेंट id (agent_…) या स्पीच इंजन बाहरी id (seng_), जो उसी अंतर्निहित रिसोर्स पर रिज़ॉल्व होती है।

referencestringआवश्यक

Slack मैसेज URL या Zendesk टिकट URL।

रिस्पॉन्स

सफल रिस्पॉन्स

agent_idstring

statusenum

अनुमत मान:

metadataobject

conversation_idstring

has_audioboolean

has_user_audioboolean

has_response_audioboolean

has_auxiliary_audioboolean

transcriptlist of objects

agent_namestring or nullवैकल्पिक

conversation_productstringवैकल्पिकडिफ़ॉल्ट: agent

user_idstring or nullवैकल्पिक

branch_idstring or nullवैकल्पिक

version_idstring or nullवैकल्पिक

इस बातचीत के लिए उपयोग किए गए एजेंट वर्ज़न की ID

analysisobject or nullवैकल्पिक

user_message_countinteger or nullवैकल्पिक

टेक्स्ट वाले यूज़र ट्रांसक्रिप्ट टर्न की संख्या; केवल टूल वाले टर्न नहीं गिने जाते। इस फ़ील्ड से पहले की उन पुरानी बातचीतों के लिए null, जिनका ट्रांसक्रिप्ट हटा दिया गया था।

agent_message_countinteger or nullवैकल्पिक

टेक्स्ट वाले एजेंट ट्रांसक्रिप्ट टर्न की संख्या; केवल टूल वाले टर्न नहीं गिने जाते। इस फ़ील्ड से पहले की उन पुरानी बातचीतों के लिए null, जिनका ट्रांसक्रिप्ट हटा दिया गया था।

visited_agentslist of objectsवैकल्पिक

conversation_initiation_client_dataobjectवैकल्पिक

environmentstringवैकल्पिकडिफ़ॉल्ट: production

tag_idslist of stringsवैकल्पिक

इस बातचीत को असाइन किए गए बातचीत टैग IDs।

otlp_tracesmap from strings to any or nullवैकल्पिक

request में format=opentelemetry इस्तेमाल होने पर OpenTelemetry trace payload; अन्यथा छोड़ दिया जाता है।

त्रुटियाँ

422

Unprocessable Entity Error

हेडर

क्वेरी पैरामीटर

रिस्पॉन्स

त्रुटियाँ