Listar conversas

Ao listar conversas no Customer Experience Insights, é possível filtrar por uma ou mais características para restringir os resultados. Também é possível classificar os resultados em atributos de conversa selecionados.

Classificação

As conversas retornadas pela API ListConversations podem ser classificadas em um dos seguintes valores transmitindo isso no campo order_by da solicitação:

create_time {asc, desc}
customer_satisfaction_rating {asc, desc}
duration {asc, desc}
latest_analysis {asc, desc}
start_time {asc, desc}
turn_count {asc, desc}

A ordem de classificação padrão é crescente, mas pode ser definida especificando asc ou desc.

Filtragem

Permissões exigidas para a tarefa

Para executar essa tarefa, é necessário ter permissões:

contactcenterinsights.conversations.list

As conversas podem ser filtradas com base em uma ou mais das características listadas na página Filtragem de conversas.

ID do agente

Filtre conversas processadas por um ID de agente específico. O único operador compatível é o de igualdade.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto Google Cloud .
AGENT_ID: o ID do agente.

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=agent_id=\"AGENT_ID\"

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=agent_id=\"AGENT_ID\""

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=agent_id=\"AGENT_ID\"" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "agentId": "AGENT_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "agentId": "AGENT_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "agentId": "AGENT_ID",
      ...
    },
  ]
}

Conversa do Dialogflow

Filtra conversas que correspondem a um nome de recurso de conversa do Dialogflow. O único operador aceito é o de igualdade. Esse filtro é útil se você criar conversas no Dialogflow, ativar a integração do ambiente de execução do Dialogflow e quiser saber quais conversas no Customer Experience Insights correspondem a quais conversas no Dialogflow.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto Google Cloud .
DIALOGFLOW_CONVERSATION: o nome do recurso de conversa do Dialogflow. O formato é projects/{project}/locations/{location}/conversations/{conversation}

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=data_source.dialogflow_source.dialogflow_conversation=\"DIALOGFLOW_CONVERSATION\"

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=data_source.dialogflow_source.dialogflow_conversation=\"DIALOGFLOW_CONVERSATION\""

PowerShell (Windows)

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=data_source.dialogflow_source.dialogflow_conversation=\"DIALOGFLOW_CONVERSATION\"" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
  ]
}

ID do perfil de conversa do Dialogflow

Filtre conversas que correspondem a um ID de perfil de conversa do Dialogflow. O único operador compatível é o de igualdade. Esse filtro é útil se você configurar perfis de conversa do Dialogflow para criar conversas no Dialogflow, ativar a integração do ambiente de execução do Dialogflow e quiser saber quais conversas no Customer Experience Insights correspondem às conversas criadas por um perfil de conversa específico do Dialogflow.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto Google Cloud .
DIALOGFLOW_CONVERSATION_PROFILE_ID: o ID do perfil de conversa do Dialogflow. Esse é apenas o ID, não o caminho do recurso.

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=dialogflow_conversation_profile_id=\"DIALOGFLOW_CONVERSATION_PROFILE_ID\"

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=dialogflow_conversation_profile_id=\"DIALOGFLOW_CONVERSATION_PROFILE_ID\""

PowerShell (Windows)

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=dialogflow_conversation_profile_id=\"DIALOGFLOW_CONVERSATION_PROFILE_ID\"" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
  ]
}

Listar conversas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Classificação

Filtragem

Permissões exigidas para a tarefa

ID do agente

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Conversa do Dialogflow

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

ID do perfil de conversa do Dialogflow

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Listar conversas