Konversationsreferenz auflösen | ElevenLabs Documentation

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": []
}

Eine Unterhaltungs-URL (eine Slack-Nachrichten-URL oder Zendesk-Ticket-URL) in die deterministische Unterhaltungs-ID für den angegebenen Agenten auflösen und anschließend bestätigen, dass die Unterhaltung existiert.

Abfrageparameter

agent_idstringErforderlich

Agent-ID (agent_…) oder externe Speech-Engine-ID (seng_), die derselben zugrunde liegenden Ressource zugeordnet werden.

referencestringErforderlich

Eine Slack-Nachrichten-URL oder eine Zendesk-Ticket-URL.

Antwort

Erfolgreiche Antwort

agent_idstring

statusenum

Erlaubte Werte:

metadataobject

conversation_idstring

has_audioboolean

has_user_audioboolean

has_response_audioboolean

has_auxiliary_audioboolean

transcriptlist of objects

agent_namestring or nullOptional

conversation_productstringOptionalStandardwert ist agent

user_idstring or nullOptional

branch_idstring or nullOptional

version_idstring or nullOptional

Die ID der für diese Unterhaltung verwendeten Agent-Version

analysisobject or nullOptional

user_message_countinteger or nullOptional

Anzahl der Benutzer-Transkript-Turns mit Text; reine Tool-Turns werden nicht gezählt. null für ältere Konversationen vor diesem Feld, deren Transkript gelöscht wurde.

agent_message_countinteger or nullOptional

Anzahl der Agenten-Transkript-Turns mit Text; reine Tool-Turns werden nicht gezählt. null für ältere Konversationen vor diesem Feld, deren Transkript gelöscht wurde.

visited_agentslist of objectsOptional

conversation_initiation_client_dataobjectOptional

environmentstringOptionalStandardwert ist production

tag_idslist of stringsOptional

Diesem Gespräch zugewiesene Konversations-Tag-IDs.

otlp_tracesmap from strings to any or nullOptional

OpenTelemetry-Trace-Payload, wenn die Anfrage format=opentelemetry verwendet; andernfalls nicht enthalten.

Fehler

422

Unprocessable Entity Error

Header

Abfrageparameter

Antwort

Fehler