Conectar o Looker Studio ao Opa! Suite
Caminho no Opa! Suite: Usuários → [usuário da integração] → Cadastro → Permissões, para obter o token. A conexão é feita no Looker Studio, em lookerstudio.google.com.
Visão geral
O Looker Studio é a ferramenta do Google para criar relatórios e painéis interativos. Com a conexão ao Opa! Suite, você copia um relatório modelo e o alimenta com os dados da sua instalação, como atendimentos, tempos de atendimento e avaliações. Assim, você acompanha a operação em um painel próprio, sem exportar planilhas.
Pré-requisitos
- Uma conta Google com acesso ao Looker Studio.
- Um usuário do Opa! Suite com acesso à API e um grupo de permissão de API com a permissão Acesso ao Looker Studio, na seção Outros. Veja Funções de cada permissão.
- O token desse usuário. Veja Gerar o token de acesso da API.
- O endereço da sua instalação do Opa! Suite, com
https://.
Passo a passo
Copiar o relatório modelo
- Acesse o relatório modelo do Opa! Suite.
- Faça uma cópia do relatório e confirme em Copiar relatório.
- Na cópia, clique em Adicionar dados.
- Busque e selecione o conector do Opa! Suite.
Adicionar o servidor
- No campo Selecione a ação que deseja realizar, escolha Adicionar servidor.
- Preencha os campos:
- Nome do servidor do seu Opa! Suite: o nome que preferir.
- URL do servidor do seu Opa! Suite: o endereço da sua instalação.
- Token API do seu Opa! Suite: o token do usuário da integração.
- Clique em Conectar ou Salvar.
A URL precisa começar com https://, não pode terminar com / e não pode ter nada depois do .com.br. Exemplo: https://seu-opa-suite.com.br.
Conectar ao servidor
- Altere a ação para Conectar a um servidor.
- Escolha o servidor criado e clique em Adicionar e Salvar.
Configurar a base de dados das páginas
- No menu do relatório, selecione Página e depois Configurações da página atual.
- No menu lateral, selecione a base de dados Opa! Suite.
- Repita nas três páginas do relatório.
Resultado esperado
Os gráficos do relatório passam a mostrar os dados da sua instalação.
Dados disponíveis
O Opa! Suite entrega quatro conjuntos de dados ao Looker Studio. Cada consulta devolve até 10 mil linhas e, se nenhum período for informado, usa o último mês.
Atendimentos
O período considera a data de abertura do atendimento.
| Campo | O que retorna |
|---|---|
| Protocolo | Protocolo do atendimento. |
| Status | Código do status: AG (aguardando), EA (em atendimento), F (finalizado) ou PS (em pesquisa de satisfação). |
| IdCliente | ID do cliente na integração com o ERP. |
| Cliente | Nome do cliente. |
| Contato | Nome do contato. |
| Departamento | Nome do departamento. |
| Atendente | Nome do atendente. |
| Canal | Tipo do canal de comunicação. |
| CanalNome | Nome do canal de comunicação. |
| AbertoPor | Quem iniciou o atendimento: atendente ou contato. |
| Origem | Para atendimentos que vieram de um anúncio do WhatsApp, o título, o link e o ID do anúncio. Nos demais, -. |
| Motivo | Último motivo registrado no atendimento. |
| DataAbertura | Data em que o atendimento foi aberto. |
| DataInicio | Data em que o atendimento foi assumido ou saiu do agente virtual. |
| DataUltimaInteracao | Data da última interação. |
| DataFinalizacao | Data em que o atendimento foi finalizado. |
| AvaliacaoFS | Média das notas de satisfação dadas pelo cliente, de 1 a 5. Vazio quando não há avaliação. |
| FCR | Sim ou Não, conforme a última resposta à pergunta de resolução no primeiro contato. - quando não há resposta. Veja [[pesquisa de satisfacao e fcr |
| TA | Tempo total de atendimento, em segundos. |
| TE | Tempo total de espera na fila, em segundos. |
| FinalizadoAgenteVirtual | true quando o atendimento foi encerrado pelo agente virtual. |
| FinalizadoAtendente | true quando o atendimento foi encerrado por um atendente. |
As datas chegam no formato ano, mês, dia, hora, minuto e segundo (AAAAMMDDhhmmss). Campos sem valor chegam como -.
Atendimentos assumidos
O período considera a data em que o atendente assumiu o atendimento.
| Campo | O que retorna |
|---|---|
| Protocolo | Protocolo do atendimento. |
| Atendente | Nome do atendente. |
| Departamento | Nome do departamento. |
| DataAssuncao | Data em que o atendente assumiu. |
| DataSaida | Data em que o atendente saiu do atendimento. |
| AtendimentoHumano | Indica se o atendimento foi feito por uma pessoa. |
Status dos usuários
O período considera a data de fim de cada status.
| Campo | O que retorna |
|---|---|
| Usuario | Nome do usuário. |
| Situacao | Online, Offline, Ocupado, Em pausa, Ausente ou Em ligação. |
| Pausa | Nome da pausa, quando o status é Em pausa. |
| Inicio | Data em que o status começou. |
| Fim | Data em que o status terminou. |
| Tempo | Tempo no status, em segundos. |
Ligações perdidas
Só ligações recebidas que foram perdidas.
| Campo | O que retorna |
|---|---|
| Data | Data e hora da ligação. |
| Departamento | Departamento que receberia a ligação. |
| Origem | Número de quem ligou. |
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| O Looker Studio não conecta | Confira se a URL tem https://, não termina com / e não tem nada depois do .com.br. |
| Erro de permissão ao buscar dados | O grupo de API do usuário não tem a permissão Acesso ao Looker Studio. |
| Erro de autenticação | O token foi substituído por um novo. Atualize o token no servidor do Looker Studio. |
| Acesso negado pela rede | O IP do Looker Studio não está nas Redes permitidas do grupo de API. Veja [[redes permitidas |
| Os dados não aparecem em uma página | Configure a base de dados Opa! Suite em Configurações da página atual, nas três páginas. |
Boas práticas
- Use um usuário e um grupo de API só para o Looker Studio, com a permissão Acesso ao Looker Studio e nenhuma outra.
- Guarde o token em local seguro e compartilhe a cópia do relatório só com quem precisa.