Conversatietickets van workspace weergeven

GET

/v1/convai/triage-tickets

GET

/v1/convai/triage-tickets

curl -G https://api.elevenlabs.io/v1/convai/triage-tickets \
     -d agent_id=agent_id \
     -d assignee_user_id=assignee_user_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 tickets voor gesprekstriage van alle agents in de workspace weer, met de meest recent gemaakte eerst. Gebruik dit om een workspacebreed overzicht te maken (bijvoorbeeld van tickets die aan de aanroeper zijn toegewezen). Ondersteunt dezelfde filters, sortering en zoekfunctie als het endpoint per agent. Tickets voor agents waartoe de aanroeper geen toegang heeft, worden weggelaten.

Queryparameters

page_sizeintegerOptioneel1-100Standaard 100

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

agent_idstringOptioneel

Alleen tickets voor deze agent.

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 for Workspace Request Unprocessable Entity Error

Headers

Queryparameters

Response

Fouten