Listar tickets de conversa do agente

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 merged_into_ticket_id=merged_into_ticket_id \
     -d owner_user_id=owner_user_id \
     -d page_size=1 \
     -d priorities=low \
     -d search=search \
     -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
        }
      ],
      "status_changes": [
        {
          "status": "open",
          "changed_at_unix_secs": 1,
          "changed_by_user_id": 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",
      "merged_into_ticket_id": "merged_into_ticket_id",
      "assignee_user_id": "assignee_user_id",
      "search_match": {
        "field": "title",
        "snippet": "snippet",
        "highlight_start": 1,
        "highlight_end": 1
      }
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}

Liste os tickets de triagem de conversas de um agente, ordenados primeiro pelos criados mais recentemente, a menos que sejam ordenados por prioridade. São tickets sobre o próprio desempenho do agente em uma conversa (para triagem com o Architect), e não tickets que um agente abre para usuários finais.

Parâmetros de caminho

agent_idstringObrigatório

Parâmetros de consulta

page_sizeintegerOpcional1-100Padrão é 100

Quantos tickets de conversa do agente retornar. Não pode exceder 100.

conversation_idstringOpcional

Filtre tickets por ID da conversa.

statusenumOpcional

Filtre tickets por status.

Valores permitidos:

sourcesenumOpcional

Filtre tickets pela forma como foram abertos (qa, agent, manual). Repita o parâmetro para filtrar por várias fontes.

Valores permitidos:

prioritiesenumOpcional

Filtre tickets por prioridade. Repita o parâmetro para filtrar por várias prioridades.

Valores permitidos:

sort_byenumOpcional

Order by most recently created, by priority (most urgent first, then most recently created), or by most recently reported (the newest report merged into the issue, else its creation).

Valores permitidos:

owner_user_idstringOpcional

Filtre tickets por criador. Use 'agent' para tickets abertos por agentes.

assignee_user_idstringOpcional

Filtre tickets por responsável. Use ‘unassigned’ para tickets sem responsável.

issue_typeenumOpcional

Filtre clusters por tipo de problema.

labelstringOpcional

Filtre tickets por um rótulo exato.

merged_into_ticket_idstringOpcional

Filtra os tickets mesclados neste ticket.

searchstringOpcional<=200 characters

Pesquisa de texto livre sem diferenciação entre maiúsculas e minúsculas no título, na descrição, nos comentários e nos comentários de turnos do ticket.

cursorstringOpcional

Usado para buscar a próxima página. O cursor é retornado na resposta.

Resposta

Resposta bem-sucedida

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstringOpcional

Erros

422

Triage Tickets List Request Unprocessable Entity Error

Parâmetros de caminho

Cabeçalhos

Parâmetros de consulta

Resposta

Erros