Listar tickets de conversación del agente

GET

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

GET

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

curl https://api.elevenlabs.io/v1/convai/agents/agent_id/triage-tickets

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

Enumera los tickets de triaje de conversaciones de un agente, ordenados primero por los creados más recientemente, salvo que se ordenen por prioridad. Son tickets sobre el rendimiento del propio agente en una conversación (para el triaje con Architect), no tickets que un agente abre para usuarios finales.

Parámetros de ruta

agent_idstringRequerido

Parámetros de consulta

page_sizeintegerOpcional1-100Valor predeterminado: 100

Cuántos tickets de conversación del agente se devolverán. No puede superar 100.

conversation_idstring or nullOpcional

Filtra tickets por ID de conversación.

statusenum or nullOpcional

Filtra tickets por estado.

Valores permitidos:

sourceslist of enums or nullOpcional

Filtra tickets según cómo se crearon (qa, agent, manual). Repite el parámetro para filtrar por varios orígenes.

Valores permitidos:

prioritieslist of enums or nullOpcional

Filtra los tickets por prioridad. Repite el parámetro para filtrar por varias prioridades.

Valores permitidos:

sort_byenumOpcional

Ordena por fecha de creación más reciente o por prioridad (primero los más urgentes y después los creados más recientemente).

Valores permitidos:

owner_user_idstring or nullOpcional

Filtra tickets por creador. Usa 'agent' para los tickets creados por el agente.

assignee_user_idstring or nullOpcional

Filtra tickets por persona asignada. Usa 'unassigned' para los tickets sin asignar.

issue_typeenum or nullOpcional

Filtra clústeres por tipo de incidencia.

labelstring or nullOpcional

Filtra tickets por una etiqueta exacta.

merged_into_ticket_idstring or nullOpcional

Filtra los tickets fusionados en este ticket.

searchstring or nullOpcional<=200 characters

Búsqueda de texto libre sin distinción entre mayúsculas y minúsculas en el título, la descripción, los comentarios y los comentarios de turnos del ticket.

cursorstring or nullOpcional

Se usa para obtener la página siguiente. El cursor se devuelve en la respuesta.

Respuesta

Respuesta correcta.

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstring or nullOpcional

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Parámetros de consulta

Respuesta

Errores