Pular para o conteúdo principal

[Extensão] Como enviar dados da Blip para o BigQuery

  • Atualizado

  1. Introdução

  2. Funcionalidades

  3. Pré-requisitos

  4. Instalação e configuração

  5. Como os dados chegam ao BigQuery

  6. Suporte

 

Descrição breve: Envie os contatos, as mensagens e os eventos de tracking do seu bot da Blip para o Google BigQuery e monte relatórios, dashboards e análises na sua própria infraestrutura.

 

Introdução

A extensão BigQuery envia os dados de conversa do seu bot da Blip para um dataset no Google BigQuery. A cada novo contato, mensagem ou evento de tracking, a Blip encaminha o registro para o BigQuery, onde você consulta com SQL, cruza com outras fontes e alimenta ferramentas de BI, mantendo um histórico próprio da operação na sua infraestrutura.

Por exemplo, uma operação de atendimento no WhatsApp pode acumular todas as mensagens trocadas em uma tabela no BigQuery e usar esses dados para medir tempo de resposta, volume por período e os assuntos mais frequentes, sem depender apenas dos relatórios nativos da Blip.

 

Funcionalidades

  • Envio de contatos para a tabela contacts, com nome, grupo, cidade, e-mail, telefone, origem, documento e campos extras.

  • Envio de mensagens para a tabela messages, com remetente, destinatário, tipo, conteúdo e metadados.

  • Envio de eventos de tracking para a tabela trackings, com categoria, ação e campos extras.

  • Criação automática do dataset e das tabelas no BigQuery no momento da instalação.

Suportada nos seguintes canais: todos os canais disponíveis na plataforma Blip.

 

Pré-requisitos

Antes de configurar a extensão, garanta que você tem:

  • Um projeto ativo no Google Cloud. Consulte a documentação do Google para criar um projeto.

  • A API do BigQuery habilitada nesse projeto.

  • Permissão para criar contas de serviço no projeto.

 

Instalação e configuração

  1. Acesse a BigQuery na Blip Store e clique em Iniciar teste grátis.

Página da extensão BigQuery na Blip Store, com o botão de iniciar o teste grátis

  1. Instale a extensão no bot cujos dados você quer enviar ao BigQuery.

  2. Abra o bot e acesse a extensão pelo menu de extensões.

Menu de extensões do bot na Blip, com a extensão BigQuery aberta

Crie o projeto no Google Cloud

A extensão grava os dados em um projeto do Google Cloud. Se você ainda não tem um:

  1. Acesse o Google Cloud Console e crie um novo projeto.

  2. Dê um nome ao projeto e confirme a criação.

  3. Selecione o projeto criado.

Google Cloud Console com o projeto recém-criado selecionado no seletor de projetos

  1. Habilite a API do BigQuery no projeto.

Crie a conta de serviço e gere a chave JSON

A extensão se autentica no BigQuery com uma conta de serviço. Para criá-la:

  1. No painel do projeto, abra IAM e administrador > Contas de serviço.

Menu IAM e administrador aberto no Google Cloud Console, na opção Contas de serviço

  1. Clique em Criar conta de serviço e informe nome, ID e descrição.

  2. Atribua os papéis Usuário de jobs do BigQuery e Proprietário de dados do BigQuery à conta. Esses papéis permitem que a extensão crie o dataset, crie as tabelas e insira os registros.

Tela de atribuição de papéis da conta de serviço com os papéis do BigQuery selecionados

  1. Finalize a criação da conta.

  2. Abra a conta criada e vá em Chaves > Adicionar chave > Criar nova chave > Criar. O Google gera um arquivo JSON com a chave da conta de serviço. Guarde esse arquivo em local seguro e não o compartilhe.

Configure a extensão na Blip

Na página da extensão, na Blip, preencha os campos:

  1. Dataset: o nome do dataset que receberá os dados. Use apenas letras e underline. Se o dataset ainda não existir, a extensão o cria.

  2. Localização: a região onde o dataset será criado. Escolha US ou southamerica-east1 (São Paulo). Para reduzir a latência de uma operação no Brasil, use southamerica-east1.

  3. Conta de serviço (JSON): envie o arquivo JSON gerado no passo anterior. A extensão verifica se o arquivo é de uma conta de serviço.

Formulário de configuração da extensão BigQuery na Blip, com os campos Dataset, Localização e Conta de serviço

  1. Clique em Salvar. A extensão cria o dataset e as tabelas no BigQuery, registra o webhook na Blip e passa a enviar os dados.

Atenção: os custos de uso e de armazenamento no Google Cloud são de responsabilidade da conta configurada. Contas gratuitas têm limites que podem afetar o funcionamento da extensão.

 

Como os dados chegam ao BigQuery

Depois que você salva, a extensão registra um webhook de analytics no bot. A partir daí, cada novo contato, mensagem e evento de tracking é gravado no dataset em três tabelas:

  • contacts: um registro por contato do bot.

  • messages: um registro por mensagem enviada ou recebida.

  • trackings: um registro por evento de tracking, agrupado por categoria.

A gravação é assíncrona, então pode haver um pequeno atraso entre o evento na Blip e a chegada dele no BigQuery. Ao comparar os números com os relatórios da Blip, valide o fuso horário, o período e os filtros usados em cada consulta.

 

Suporte

Em caso de dúvidas ou problemas com a extensão, entre em contato pelo e-mail support@wiv.com.br.


 

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃

Artigos relacionados