Usar visualizações autorizadas

Você pode usar visualizações autorizadas para recuperar dados de conversas, fazer análises ou editar rótulos de feedback. Não é possível usar visualizações autorizadas para editar ou importar dados de conversas, treinar modelos de tópicos ou criar visões gerais.

Selecione uma visualização autorizada para acessar o escopo de dados específico que ela oferece. Cada visualização pode definir um escopo diferente. Você só vai ver os dados permitidos pela visualização selecionada.

Escolha Nenhuma visualização para usar as permissões atribuídas do Identity and Access Management (IAM). Esse é o estado padrão.

Permissões e papéis obrigatórios

Para usar visualizações autorizadas, você precisa das seguintes permissões do IAM:

Permissões para acesso ao projeto

Os gerentes e agentes precisam de acesso de leitura ao projeto resourcemanager.projects.get para interagir com o console.

Use roles/browser para dar aos gerentes e agentes um nível básico de acesso. Consulte a documentação de controle de acesso no nível do projeto para mais detalhes.

Permissões de visualização autorizada

Conceda as seguintes permissões em visualizações autorizadas específicas com os métodos SetIamPolicy. Consulte os recursos de visualização autorizada para mais detalhes.

Os usuários de visualizações autorizadas só precisam da permissão contactcenterinsights.authorizedViews.get e das permissões authorized correspondentes para os recursos a que podem acessar.

Permissões para conversas autorizadas

Permissão	Descrição
`contactcenterinsights.authorizedConversations.get`	Use uma visualização autorizada para receber uma conversa.
`contactcenterinsights.authorizedConversations.list`	Use uma visualização autorizada para listar conversas.

Permissões para operações autorizadas

Permissão	Descrição
`contactcenterinsights.authorizedOperations.get`	Use uma visualização autorizada para receber uma operação.
`contactcenterinsights.authorizedOperations.list`	Use uma visualização autorizada para listar operações.

Papéis predefinidos

Os seguintes papéis predefinidos do IAM fornecem as permissões necessárias:

Papel	Descrição
`roles/contactcenterinsights.authorizeEditor`	Concede acesso de leitura/gravação a todos os recursos autorizados do Customer Experience Insights.
`roles/contactcenterinsights.authorizedViewer`	Concede acesso total a todos os recursos autorizados do Customer Experience Insights.

Pesquisar suas visualizações autorizadas

REST

Recupere todas as visualizações autorizadas a que você tem acesso.

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

PROJECT_ID: o ID do projeto do Google Cloud .
LOCATION: o local dos seus dados do Customer Experience Insights.
AUTHORIZED_VIEW_SET_ID: um identificador definido pelo usuário para o conjunto de visualizações autorizadas ou o caractere curinga "-".
PAGE_SIZE: o número máximo de visualizações a serem retornadas na resposta. Se o valor for zero, o serviço vai selecionar um tamanho padrão. Uma chamada pode retornar menos objetos do que o solicitado. Um `next_page_token` não vazio na resposta indica que há mais dados disponíveis.
PAGE_TOKEN: o valor retornado pela última "SearchAuthorizedViewsResponse". Esse valor indica que esta é uma continuação de uma chamada "SearchAuthorizedViews" anterior e que o sistema deve retornar a próxima página de dados.
FILTER: a expressão de filtro para filtrar as visualizações autorizadas listadas na resposta. É possível filtrar os seguintes campos: "authorized_view_id", "display_name", "conversation_filter", "create_time" e "update_time". Você pode usar expressões e/ou arbitrárias. Também é possível usar expressões regulares para campos de string.

Exemplo: display_name = "My View"
Exemplo: conversation_filter =~ ".*agent-1.*"
Exemplo: create_time > "2022-01-01T00:00:00Z"
Exemplo: display_name =~ ".*View.*"
Exemplo: create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z"

ORDER_BY: a expressão de ordenação para ordenar as visualizações autorizadas listadas na resposta.

Exemplo: create_time
Exemplo: update_time desc

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY

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/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY"

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/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "authorizedViews": [
    {
      "name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-1",
      "displayName": "My First View",
      "conversationFilter": "agent_id = \"agent-1\"",
      "createTime": "2022-01-01T00:00:00.000000Z",
      "updateTime": "2022-01-01T00:00:00.000000Z"
    },
    {
      "name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-2",
      "displayName": "My Second View",
      "conversationFilter": "agent_id = \"agent-2\"",
      "createTime": "2022-01-01T00:00:00.000000Z",
      "updateTime": "2022-01-01T00:00:00.000000Z"
    }
  ],
  "nextPageToken": "next-page-token"
}

Conversa autorizada

Uma conversa autorizada é aquela que é acessada usando uma visualização autorizada.

Para uma lista completa de métodos compatíveis, consulte a documentação de referência de métodos de conversa autorizada.

Receber uma conversa autorizada

REST

Para acessar uma conversa autorizada, é necessário ter a permissão contactcenterinsights.authorizedConversations.get.

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

PROJECT_ID: o ID do projeto do Google Cloud .
LOCATION_ID: o local do projeto
AUTHORIZED_VIEW_SET_ID: o ID do conjunto de visualizações autorizadas.
AUTHORIZED_VIEW_ID: o ID da visualização autorizada.
CONVERSATION_ID: o ID da conversa.

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_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/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_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/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID",
  "createTime": "2025-03-03T11:23:17.823813113Z",
  "updateTime": "2025-03-03T11:23:17.987216Z",
  "agentId": "AGENT_ID",
  "callMetadata": {
    "customerChannel": 1,
    "agentChannel": 2
  },
  "medium": "CHAT",
  "duration": "0s",
  "turnCount": 2,
  "languageCode": "en",
  "startTime": "2025-03-03T11:23:16.903361174Z",
  "qualityMetadata": {
    "agentInfo": [
      {
        "agentId": "AGENT_ID",
        "agentType": "HUMAN_AGENT"
      }
    ]
  }
}

Listar conversas autorizadas

REST

Para listar conversas autorizadas, é preciso ter a permissão contactcenterinsights.authorizedConversations.list.

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

PROJECT_ID: o ID do projeto do Google Cloud .
LOCATION_ID: o local do projeto.
AUTHORIZED_VIEW_SET_ID: o ID do conjunto de visualizações autorizadas.
AUTHORIZED_VIEW_ID: o ID da visualização autorizada.
PAGE_SIZE: o número de conversas a serem retornadas por página.

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE

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/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE"

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/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/4315d72e3d-c75-94d-2d5-1ae05b4222352",
      "createTime": "2025-03-03T11:23:17.823813113Z",
      "updateTime": "2025-03-03T11:23:17.987216Z",
      "agentId": "AGENT_ID",
      "callMetadata": {
        "customerChannel": 1,
        "agentChannel": 2
      },
      "medium": "CHAT",
      "duration": "0s",
      "turnCount": 2,
      "languageCode": "en",
      "startTime": "2025-03-03T11:23:16.903361174Z",
      "qualityMetadata": {
        "agentInfo": [
          {
            "agentId": "AGENT_ID",
            "agentType": "AUTOMATED_AGENT"
          }
        ]
      }
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/8d3b61-bd4-f2c-364-b5a794f76",
      "createTime": "2025-03-03T11:19:58.605217527Z",
      "updateTime": "2025-03-03T11:19:58.901962Z",
      "agentId": "AGENT_ID",
      "callMetadata": {
        "customerChannel": 1,
        "agentChannel": 2
      },
      "medium": "CHAT",
      "duration": "0s",
      "turnCount": 2,
      "runtimeAnnotations": [
        {
          "createTime": "2025-03-03T11:19:56.164686195Z",
          "startBoundary": {
            "transcriptIndex": 1
          },
          "endBoundary": {
            "transcriptIndex": 2
          },
          "answerFeedback": {},
         
        }
      ],
      "languageCode": "en",
      "startTime": "2025-03-03T11:19:56.164686195Z",
      "qualityMetadata": {
        "agentInfo": [
          {
            "agentId": "AGENT_ID",
            "agentType": "HUMAN_AGENT"
          }
        ]
      }
    }
  ],
  "nextPageToken": "NEXT_PAGE_TOKEN"
}

Operações autorizadas

Para uma lista completa de métodos compatíveis, consulte a documentação de referência de métodos de operações autorizadas.

Receber uma operação autorizada

REST

Para ter uma operação autorizada, é necessário ter a permissão contactcenterinsights.authorizedOperations.get.

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

PROJECT_ID: o ID do projeto do Google Cloud .
LOCATION: o local dos seus dados do Customer Experience Insights.
OPERATION_ID: o ID da conversa que você quer analisar. Esse valor foi retornado quando você criou a análise.

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_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/LOCATION_ID/operations/OPERATION_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/LOCATION_ID/operations/OPERATION_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  },
  "done": true
}

Listar operações autorizadas

REST

Para listar operações autorizadas, é necessário ter a permissão contactcenterinsights.authorizedOperations.list.

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

PROJECT_ID: o ID do projeto do Google Cloud .
LOCATION: o local dos seus dados do Customer Experience Insights.
AUTHORIZED_VIEW_SET_ID: o ID do conjunto de visualizações autorizadas.
AUTHORIZED_VIEW_ID: o ID da visualização autorizada.

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/

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/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/"

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/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "operations": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
      },
      "done": true
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID_2",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
      },
      "done": true
    }
  ]
}

A seguir

Práticas recomendadas para visualizações autorizadas

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

Permissões e papéis obrigatórios

Permissões para acesso ao projeto

Permissões de visualização autorizada

Permissões para conversas autorizadas

Permissões para operações autorizadas

Papéis predefinidos

Pesquisar suas visualizações autorizadas

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Conversa autorizada

Receber uma conversa autorizada

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Listar conversas autorizadas

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Operações autorizadas

Receber uma operação autorizada

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Listar operações autorizadas

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

A seguir

Usar visualizações autorizadas