List tickets

GET

/v1/convai/agents/:agent_id/triage-tickets

GET

/v1/convai/agents/:agent_id/triage-tickets

curl -G https://api.elevenlabs.io/v1/convai/agents/agent_id/triage-tickets \
     -d assignee_user_id=assignee_user_id \
     -d conversation_id=conversation_id \
     -d cursor=cursor \
     -d issue_type=knowledge_gap \
     -d label=label \
     -d owner_user_id=owner_user_id \
     -d page_size=1 \
     -d priorities=low \
     -d sort_by=created_at \
     -d sources=qa \
     -d status=open

{
  "agent_conversation_tickets": [
    {
      "agentqa_ticket_id": "agentqa_ticket_id",
      "workspace_id": "workspace_id",
      "owner_user_id": "owner_user_id",
      "agent_id": "agent_id",
      "needs_clustering": true,
      "labels": [
        "labels"
      ],
      "conversation_ids": [
        "conversation_ids"
      ],
      "ticket_comments": [
        {
          "comment": "comment",
          "created_at_unix_secs": 1,
          "owner_user_id": null
        }
      ],
      "turn_comments": [
        {
          "turn_index": 1,
          "comment": "comment",
          "created_at_unix_secs": 1,
          "owner_user_id": null
        }
      ],
      "status": "open",
      "priority_changes": [
        {
          "changed_by_user_id": "changed_by_user_id",
          "changed_at_unix_secs": 1,
          "priority": null
        }
      ],
      "source": "qa",
      "created_at_unix_secs": 1,
      "updated_at_unix_secs": 1,
      "title": "title",
      "issue_type": "knowledge_gap",
      "first_seen_unix_secs": 1,
      "last_seen_unix_secs": 1,
      "qa_comment": "qa_comment",
      "priority": "low",
      "assignee_user_id": "assignee_user_id"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}

List an agent’s conversation triage tickets, ordered by most recently created first unless sorted by priority. These are tickets about the agent’s own performance on a conversation (for triage with Architect), not tickets an agent opens for end users.

Parametry ścieżki

agent_idstringWymagany

Parametry zapytania

page_sizeintegerOpcjonalny1-100Domyślnie 100

How many agent conversation tickets to return. Can not exceed 100.

conversation_idstringOpcjonalny

Filter tickets by conversation id.

statusenumOpcjonalny

Filter tickets by status.

Dozwolone wartości:

sourcesenumOpcjonalny

Filter tickets by how they were raised (qa, agent, manual). Repeat the parameter to filter by multiple sources.

Dozwolone wartości:

prioritiesenumOpcjonalny

Filter tickets by priority. Repeat the parameter to filter by multiple priorities.

Dozwolone wartości:

sort_byenumOpcjonalny

Order by most recently created, or by priority (most urgent first, then most recently created).

Dozwolone wartości:

owner_user_idstringOpcjonalny

Filter tickets by creator. Use ‘agent’ for agent-raised tickets.

assignee_user_idstringOpcjonalny

Filter tickets by assignee. Use 'unassigned' for tickets with no assignee.

issue_typeenumOpcjonalny

Filter clusters by issue type.

labelstringOpcjonalny

Filter tickets by an exact label.

cursorstringOpcjonalny

Used for fetching next page. Cursor is returned in the response.

Odpowiedź

Successful Response

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstringOpcjonalny

Błędy

422

Triage Tickets List Request Unprocessable Entity Error

Parametry ścieżki

Nagłówki

Parametry zapytania

Odpowiedź

Błędy