Lister les tickets de conversation du Workspace

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

Répertorie les tickets de triage des conversations pour tous les agents du Workspace, du plus récent au plus ancien. Utilisez cette opération pour créer une vue à l’échelle du Workspace, par exemple des tickets attribués à l’appelant. Prend en charge les mêmes filtres, options de tri et recherches que l’endpoint par agent. Les tickets des agents auxquels l’appelant n’a pas accès sont omis.

Paramètres de requête

page_sizeintegerOptionnel1-100Par défaut 100

Nombre de tickets de conversation d’agent à renvoyer. Ne peut pas dépasser 100.

agent_idstringOptionnel

Uniquement les tickets de cet agent.

statusenumOptionnel

Filtrer les tickets par statut.

Valeurs autorisées:

sourcesenumOptionnel

Filtrer les tickets selon leur mode de création (qa, agent, manual). Répétez le paramètre pour filtrer par plusieurs sources.

Valeurs autorisées:

prioritiesenumOptionnel

Filtrer les tickets par priorité. Répétez le paramètre pour filtrer par plusieurs priorités.

Valeurs autorisées:

sort_byenumOptionnel

Trier par date de création décroissante ou par priorité, les plus urgents d’abord, puis les plus récemment créés.

Valeurs autorisées:

owner_user_idstringOptionnel

Filtrer les tickets par créateur. Utilisez ‘agent’ pour les tickets créés par un agent.

assignee_user_idstringOptionnel

Filtrer les tickets par personne attribuée. Utilisez ‘unassigned’ pour les tickets sans personne attribuée.

issue_typeenumOptionnel

Filtrer les groupes par type de problème.

labelstringOptionnel

Filtrer les tickets par libellé exact.

merged_into_ticket_idstringOptionnel

Filtre les tickets fusionnés dans ce ticket.

searchstringOptionnel<=200 characters

Recherche en texte libre insensible à la casse dans le titre, la description, les commentaires et les commentaires de tour du ticket.

cursorstringOptionnel

Utilisé pour récupérer la page suivante. Le curseur est renvoyé dans la réponse.

Réponse

Réponse réussie

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstringOptionnel

Erreurs

422

Triage Tickets List for Workspace Request Unprocessable Entity Error

En-têtes

Paramètres de requête

Réponse

Erreurs