O relatório premium tem como objetivo permitir integrações entre o SZ.chat e ferramentas de criação de relatórios e dashboards possibilitando a criação de novas métricas por meio da manipulação e combinação dos dados do SZ.chat com outros dados da sua empresa.

Somente os dados das sessões de atendimento serão disponibilizados para as integrações. No final do artigo deixamos uma planilha com todos os dados que estão a disposição.   

O dedicado permite o armazenamento dos dados das sessões dos atendimentos do SZ.chat no BigQuery, e essa plataforma possui integrações com vários sistemas de gestão de dados e criação de relatórios como Data Studio e Power BI. 

O compartilhado não gera custos adicionais mas só permite a integração com a ferramenta Google Data Studio. Clique aqui para saber mais. 

Assuntos tratados nesse artigo

1. Passos necessários para habilitar o relatório premium dedicado e armazenar os dados no BigQuery;
2. Integração entre BigQuery e Google Data Studio; 
3. Integração entre BigQuery e Powe BI.

1 - Passos necessários para habilitar o relatório premium dedicado e armazenar os dados do BigQuery;

Entre em contato com o suporte da Fortics e solicite a liberação do relatório dedicado na sua licença.

Após a alteração a opção dedicado ficará visível em sua plataforma.

Para obter as informações necessárias para a integração será necessário realizar configurações no Google Cloud. Acesse Google Cloud e selecione console para acessar, caso ainda não tenha uma conta preencha as informações solicitadas para realizar o cadastro de uma conta. 

Siga os passos para criar um novo projeto. Preencha os campos com os dados da sua preferência. 

Ao concluir o processo,  clique no projeto criado para utiliza-lo. Armazene o ID do projeto pois é uma das informação necessários para ativação do recurso. 

Busque por Cloud Resource Manager API e clique para ativar.

Busque por Identity and Access Management (IAM) API e clique para ativar.

Agora vamos configurar a  tela de consentimento do OAuth. Clique no canto superior esquerdo para expandir a visualização do menu vertical. Selecione APIs e serviços > Tela de consentimento OAuth.

Selecione User Type interno e clique para criar;

Preencha com o nome e o e-mail da sua preferência. Siga até o final da página para preencher o e-mail nos dados de contato do desenvolvedor;

Preencha o campo com o e-mail da sua preferência, pode ser o mesmo e-mail utilizado anteriormente. Ao concluir basta clicar para salvar e continuar. 

Na tela de escopos não será necessário nenhuma configuração. Clique apenas em SALVAR E CONTINUAR no final da página e então será encaminhado para o resumo;

Vamos criar as credenciais de acesso ao OAuth 2.0. Clique em criar credenciais > ID do cliente OAuth;

O tipo do aplicativo deve ser aplicativo da web e o nome deve ser preenchido conforme a sua preferência;

Em origens JavaScript autorizadas clique em adicionar URI e adicione a sua URL de acesso a plataforma. 

Exemplo: https://teste.sz.chat

Em URIs de redirecionamento autorizados clique em adicionar URI e adicione a sua URL de acesso + /datadriven/callback.

Exemplo: https://teste.sz.chat/datadriven/callback 

Quando conclui clique em salvar;

Após salver, irá aparecer seu ID de ciente e sua chave secreta. Guarde essas informações pois serão necessárias no processo de autenticação do recurso na plataforma.

É necessário ativar o faturamento do projeto pois o Google cobra um valor para utilização do recurso, clique aqui para saber mais. Basta clicar em faturamento e vincular uma conta de faturamento ou criar a conta caso ainda não tenha.

Retorne para a plataforma e adicione as informações obtidas nos respectivos campos, ao concluir clique para se autenticar com o Google;

Ao final das configurações é possível visualizar a tipo de armazenamento escolhido e a conta do Google configurada. 

2 - Integração entre BigQuery e Google Data Studio

Após habilitar o relatório premium dedicado acesse o Google Data Studio. Certifique-se que está autenticado com a mesma conta que utilizou no processo de configuração no GCP.

Ao se autenticar selecione "relatórios em braco".

Em Adicionar dados ao relatório, selecionar a opção "Big query"

Em Meus projetos, selecione o projeto criado para o relatório premium de sua empresa;

Em Conjunto de dados, selecione o único conjunto exibido e clique na tabela de dados Sessions. Ao final, clique no botão adicionar ;

Agora você já pode iniciar a construção do seu relatório;

Informações importantes sobre o Data Studio

• No data Studio é possível utilizar mais de uma fonte de dados para construir um único relatórios. Exemplo, big-query do SZ4 e uma planilha.

• Quando não é difinido o período(data) no relatório, ele sempre pega os dados do dia atual.

• O Data studio possibilita gerar links dos modelos criados pelo próprio usuário. Estes modelos podem ser repassados para a Fortics como sugestão de modelo padrão ou compartilhado entre os clientes para o uso IMEDIATO, sem a necessidade de compartilhar a base de dados.

3 - Integração entre BigQuery e Power BI

Após habilitar o relatório premium dedicado clique aqui e siga os passos dessa documentação para integrar com o Power BI.

Agora você já pode iniciar a construção do seu relatório;

Sugestão para facilitar a construção do relatório

No BigQuery as conversas ficam todas em uma linha e são separadas por array, o que dificulta a minipulação dos dados no Power BI. Uma solução encontrada foi criar no BigQuery uma view para transformar cada conversa em uma linha para que no Power BI as informações de cada conversa fique em uma linha. 

CREATE OR REPLACE VIEW

  `gcp-fortics-bi.fortics.sessions_view` AS

SELECT

  s.*,

  t.message_id as talks_message_id, 

  t.message as talks_message, 

  t.sentiment_analysis_level as talks_sentimental_analysis_score,

  t.sentiment_analysis as talks_sentimental_analysis_text,

  t.origin as talks_origin,

  t.stt as talks_stt,

  t.type as talks_type,

  t.filename as talks_filename,

  t.legend as talks_legend,

  t.created_at as talks_created_at

FROM

  `gcp-fortics-bi.fortics.sessions` s,

  UNNEST(talks) t

Informações importante sobre o Relatório Premium

• Os relatórios só serão gerados a partir do dia da configuração. Dias anteriores não vão ter dados gerados para usar em relatórios.

• Dados confidenciais continuam preservados/protegidos  de forma criptografada mesmo com a base dos dados disponível para manipulação externa do SZ.chat.

• As mídias são exibidas em formato de link. 

Planilha com legenda dos campos disponível na integração