Conversatietickets van agent weergeven

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"
}

Geeft de tickets voor gesprekstriage van een agent weer, standaard gesorteerd met de meest recent gemaakte eerst, tenzij er op prioriteit wordt gesorteerd. Dit zijn tickets over de eigen prestaties van de agent in een gesprek (voor triage met Architect), geen tickets die een agent voor eindgebruikers opent.

Padparameters

agent_idstringVerplicht

Queryparameters

page_sizeintegerOptioneel1-100Standaard 100

Hoeveel gesprekstickets voor agents moeten worden geretourneerd. Mag niet meer zijn dan 100.

conversation_idstringOptioneel

Filter tickets op gespreks-ID.

statusenumOptioneel

Filter tickets op status.

Toegestane waarden:

sourcesenumOptioneel

Filter tickets op de manier waarop ze zijn aangemaakt (qa, agent, manual). Herhaal de parameter om op meerdere bronnen te filteren.

Toegestane waarden:

prioritiesenumOptioneel

Filter tickets op prioriteit. Herhaal de parameter om op meerdere prioriteiten te filteren.

Toegestane waarden:

sort_byenumOptioneel

Sorteer op meest recent gemaakt, of op prioriteit (eerst het dringendst, daarna het meest recent gemaakt).

Toegestane waarden:

owner_user_idstringOptioneel

Filter tickets op maker. Gebruik 'agent' voor tickets die door een agent zijn aangemaakt.

assignee_user_idstringOptioneel

Filter tickets op toegewezene. Gebruik 'unassigned' voor tickets zonder toegewezene.

issue_typeenumOptioneel

Filter clusters op probleemtype.

labelstringOptioneel

Filter tickets op een exact label.

merged_into_ticket_idstringOptioneel

Filter tickets die in dit ticket zijn samengevoegd.

searchstringOptioneel<=200 characters

Hoofdletterongevoelige vrije-tekstzoekopdracht in de titel, beschrijving, opmerkingen en beurtopmerkingen van het ticket.

cursorstringOptioneel

Gebruikt om de volgende pagina op te halen. De cursor wordt teruggegeven in de response.

Response

Geslaagde response

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstringOptioneel

Fouten

422

Triage Tickets List Request Unprocessable Entity Error

Padparameters

Headers

Queryparameters

Response

Fouten