Workspace-Konversationstickets auflisten

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

Listet Konversations-Triage-Tickets aller Agents im Workspace auf, sortiert nach Erstellungszeitpunkt absteigend. Verwenden Sie dies für eine Workspace-weite Ansicht, etwa für dem Aufrufer zugewiesene Tickets. Unterstützt dieselben Filter, Sortierungen und Suchfunktionen wie der Endpunkt pro Agent. Tickets für Agents, auf die der Aufrufer nicht zugreifen kann, werden ausgelassen.

Abfrageparameter

page_sizeintegerOptional1-100Standardwert ist 100

Wie viele Agent-Unterhaltungstickets zurückgegeben werden sollen. Darf 100 nicht überschreiten.

agent_idstringOptional

Nur Tickets für diesen Agent.

statusenumOptional

Tickets nach Status filtern.

Erlaubte Werte:

sourcesenumOptional

Tickets danach filtern, wie sie erstellt wurden (qa, agent, manual). Wiederholen Sie den Parameter, um nach mehreren Quellen zu filtern.

Erlaubte Werte:

prioritiesenumOptional

Filtert Tickets nach Priorität. Wiederholen Sie den Parameter, um nach mehreren Prioritäten zu filtern.

Erlaubte Werte:

sort_byenumOptional

Sortiert nach Erstellungszeitpunkt absteigend oder nach Priorität (dringendste zuerst, dann zuletzt erstellte).

Erlaubte Werte:

owner_user_idstringOptional

Tickets nach Ersteller filtern. Verwenden Sie ‘agent’ für von Agenten erstellte Tickets.

assignee_user_idstringOptional

Tickets nach Bearbeiter filtern. Verwenden Sie ‘unassigned’ für Tickets ohne Bearbeiter.

issue_typeenumOptional

Cluster nach Problemtyp filtern.

labelstringOptional

Tickets nach einem exakten Label filtern.

merged_into_ticket_idstringOptional

Filtert Tickets, die in dieses Ticket zusammengeführt wurden.

searchstringOptional<=200 characters

Suche nach Freitext ohne Beachtung der Groß- und Kleinschreibung in Titel, Beschreibung, Kommentaren und Turn-Kommentaren des Tickets.

cursorstringOptional

Wird zum Abrufen der nächsten Seite verwendet. Der Cursor wird in der Antwort zurückgegeben.

Antwort

Erfolgreiche Antwort

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstringOptional

Fehler

422

Triage Tickets List for Workspace Request Unprocessable Entity Error

Header

Abfrageparameter

Antwort

Fehler