Workspace-Konversationstickets auflisten

GET

/v1/convai/triage-tickets

GET

/v1/convai/triage-tickets

curl https://api.elevenlabs.io/v1/convai/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"
}

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_idstring or nullOptional

Nur Tickets für diesen Agent.

statusenum or nullOptional

Tickets nach Status filtern.

Erlaubte Werte:

sourceslist of enums or nullOptional

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

Erlaubte Werte:

prioritieslist of enums or nullOptional

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_idstring or nullOptional

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

assignee_user_idstring or nullOptional

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

issue_typeenum or nullOptional

Cluster nach Problemtyp filtern.

labelstring or nullOptional

Tickets nach einem exakten Label filtern.

merged_into_ticket_idstring or nullOptional

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

searchstring or nullOptional<=200 characters

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

cursorstring or nullOptional

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_cursorstring or nullOptional

Fehler

422

Unprocessable Entity Error

Header

Abfrageparameter

Antwort

Fehler