Índice:

Incluindo novos dados em uma planilha do Google através de uma API
Criando um o fluxo de pesquisa no Builder
Integrando o fluxo de pesquisa com o Google Sheet
Finalizando o fluxo de pesquisa

PREMISSAS

Para a geração deste relatório, iremos fazer uma integração com o Google Sheet.

Será necessário realizar requisições http e definir variáveis em algumas etapas do fluxo.

Os dados gerados serão preenchidos automaticamente na planilha.

Incluindo novos dados em uma planilha do Google através de uma API

Ativar Serviço de Sheets no seu Projeto

1º Crie Token de Oauth através do ID de Cliente e do ID Secreto e uma conta Google para acessar o Google Developer.

2º Adicionar Projeto.

Você precisa ir no canto superior esquerdo e clicar no seu projeto atual. Uma nova janela irá se abrir e nesse momento você vai clicar em Criar Novo Projeto , no canto superior direito dessa janela. A imagem a seguir mostra o passo a passo.

Dê um nome ao seu projeto e salve:

3º Ativar Serviço de Sheets no seu Projeto

Você precisa ir no canto superior esquerdo e clicar nos ☰. Com isso uma nova janela a esquerda irá se abrir e nesse momento você vai clicar em APIs e Serviços e em seguida em Biblioteca . Agora procure pela palavra Sheets e selecione a primeira opção. Agora é só Ativar ao clicar no botão no centro da tela.

Este processo deverá ser repetido mas, desta vez, clique em ☰ e acesse APIs e serviços ➡ Painel

Nesse novo ambiente, clique em Tela de Consentimento OAuth que está no menu lateral esquerdo e, em User Type , selecione Externo e clique em CRIAR.

Em seguida defina um nome para a API , insira o e-mail para suporte e dos desenvolvedores.

No final da página, clique em SALVAR E CONTINUAR. Em seguida, nessa próxima página que irá ser exibida, clique no mesmo botão no final da página de SALVAR E CONTINUAR. Faça isso até chegar na etapa 4.

Na quarta etapa, você deverá ir ao final da página e clicar em VOLTAR PARA PAINEL , que será a Tela de

Consentimento OAuth.

Daí é só ir em PUBLICAR APLICATIVO , como na imagem abaixo:

O status irá mudar para "Em produção".

2º passo: Criar Credenciais

No menu lateral esquerdo clique em Credenciais . Nessa página que abriu, clique em + CRIAR

CREDENCIAIS e em seguida na opção ID do Cliente OAuth

Agora, selecione Aplicativo da Web para a escolha do Tipo de aplicativo e insira o nome da sua escolha.

Nesse momento, você precisará de muita atenção, pois é uma parte importante.

Insira nos URLs de Redirecionamento Autorizados os seguintes links do portal:

Em seguida, clique em Criar e seguir para as chaves, como no tutorial logo em seguida.

Nesse momento, irá aparecer uma janela com as credenciais. Salve todas essas informações!

3º passo: Autorizar Credenciais

O próximo passo é acessar https://developers.google.com/oauthplayground e clicar na engrenagem no canto superior direito. Nesse novo pop-up, habilite a opção Use your own OAuth credentials e preencha com os dados que coletou na etapa anterior

Para finalizar, selecione o e-mail o qual o OAuth será vinculado e clique em Permitir

Depois, clique em Código de autorização de troca de tokens para obter o token de atualização. Esse será usado para atualizar o token de acesso, uma vez que este expira a cada 60 minutos.

Agora é só dar um CRTL+F para procurar pela palavra Sheets . Selecione a opção Google Sheets API v4 para expandir. Em seguida, selecione a opção que possui spreadsheets nome, como a dessa figura

Após selecionar, clique em Autorizar API’s . Caso peça para autorizar acessar domínios desconhecidos, não tem problema: é só dar seguinte como de costume.

Caso ocorra este erro, clique na descrição que aparece abaixo do saiba mais e copie a url do aviso. Volte no slide 12 e siga os passos novamente.

Em Exchange authorization code for tokens, terá um código de autorização.

Caso os tokens não tenham sido gerados automaticamente, clique em Exchange authorization code for tokens.

Você irá precisar do Refresh token logo adiante. Então, já salve esta informação

4º passo: Criar planilha

Nessa última etapa de integração com sheets você precisará criar uma planilha no Google e nomear as colunas.

ATENÇÃO: se você não nomear as colunas, possivelmente, a integração falhará. Utilize ao menos um nome “temporário”.

Com a sua planilha em mãos, você precisará armazenar o código, que é issa informação após o /d/ e

antes do /edit na url

Em nossa proposta, a planilha terá as seguintes colunas: data | ticket | agente | time | score

Você pode incluir ou excluir informações dada a sua necessidade.

Criando um o fluxo de pesquisa no Builder

1º passo: criar o fluxo

Para este fluxo, precisamos de:

Bloco finalização do atendimento
Bloco de realização pesquisa
Bloco Justificar Nota (opcional)
Bloco Agradecimento da avaliação

O bloco de finalização deverá ficar logo após o bloco de atendimento humano. Caso você utilize uma estrutura de roteador e subbots, pode ser utilizado um fluxo para a captura da pesquisa de satisfação, por exemplo, o fluxo deverá seguir esta lógica:

2º passo: Bloco de Finalização

No bloco de Finalização, vamos definir as seguintes variáveis:

agente
ticket
time

(você pode utilizar outros nomes)

Ações > Ações de Entrada > Definir Variável

Cada variável terá o seguinte valor:

agente >

ticket > {{input.content@sequentialId}}

time > {{input.content@team}}

O nome da sua variável pode ser mudado, mas estes valores são padrões do Blip.

Para garantir que o usuário vá para a próxima etapa do fluxo (Pesquisa de Satisfação), altera a Saída Padrão para o bloco de Pesquisa de Satisfação.

Como sugestão de conteúdo para este bloco, podemos colocar algo como: O seu atendimento foi finalizado pela pessoa que lhe atendeu, você está novamente falando comigo, Joy! 😃

3º passo: Bloco Pesquisa de Satisfação

Clique na entrada do usuário e ative Salvar resposta em

variável e Validar entrada do usuário.

Dê um nome para a sua variável. Aqui, chamaremos de score.

No tipo de validação, escolha Número e coloque uma instrução ao usuário para o caso dele errar, por exemplo: Por favor, digite um número entre 0 e 5, onde 0 é péssimo e 5 excelente.

Iremos colocar as seguintes condições de saída neste bloco: Se a nota for igual ou menor que três, o usuário irá para o bloco de justificativa. Se a nota for igual ou maior que 4, irá para o bloco de checagem (ou outro bloco de finalização que você tiver).

Integrando o fluxo de pesquisa com o Google Sheet

Requisição HTTP

Agora, vamos criar duas Ações de Saída no bloco Pesquisa de Satisfação do tipo Requisição HTTP. Vamos fazer isso para integrar a nossa pesquisa com o Google Sheet.

A primeira será para autorizar o Google Sheet. Utilizaremos o método POST e a URL https://accounts.google.com/o/oauth2/token

Os Cabeçalhos vazios ficam vazios.

No campo Salvar Resposta, coloque status1 e oauth.

No corpo desta requisição, colocaremos o seguinte

código

{ 

         "client_secret": "seu_id_secreto", 

         "grant_type": "refresh_token", 

         "refresh_token": "seu_refresh_token", 

         "client_id": "seu_id_de_cliente" 

}

Lembrando que, essas informações deverão ser substituídas de acordo com os dados que foram gerados nas suas credenciais lá no Gloogle Cloud Platform:

Seu_id_secreto, seu_refresh_token e seu_id_de_cliente.

Alteradas as informações, pressione ctrl + s para salvar.

A próxima requisição é para integrar com a planilha. Neste mesmo bloco, volte para Ações de Saída e selecione Requisição HTTP. Novamente, o método será POST e, na URL, você irá colocar o seguinte link preenchido:

https://sheets.googleapis.com/v4/spreadsheets/{{codigo da sua planilha}}/values/{{nome da aba}}!{{colunas escolhidas}}:append?insertDataOption=INSERT_ROWS&responseDateTimeRenderOption=FORMATTE D_STRING&valueInputOption=USER_ENTERED

Exemplo de link preenchido:

https://sheets.googleapis.com/v4/spreadsheets/1nwvwDBddNRJoKe9P3OO6j4CO53c2JUyuzwgvTS1g2 qg/values/nota!A:C:append?insertDataOption=INSERT_ROWS&responseDateTimeRenderOption=FORM ATTED_STRING&valueInputOption=USER_ENTERED

Em cabeçalhos, coloque KEY Authorization e Value

Bearer {{oauth@access_token}}

No corpo, coloque o seguinte código (ou conforme as variáveis que deseja usar):

{ 

   "values": [ 

   [ 

   "{{calendar.datetime}}", 

   "{{ticket}}", 

   "{{agente}}", 

   "{{time}}", 

   "{{score}}" 

]

  ] 

}

Essa variável {{calendar.datetime}} é padrão da bibliote do blip para registrar data e hora.

As variáveis deverão ser inseridas na ordem correta de

acordo com a coluna pertencente.

Em Salvar Resposta, coloque status2 e respostas

Fique atendo à ordem das requisições. A primeira deve

ser a de autorizar, seguida da planilha.

Finalizando o fluxo de pesquisa

1º passo: Bloco Justificar Nota

Aqui, iremos agradecer a avaliação e pedir para o usuário explicar o motivo da sua nota.

Você pode registrar o input do usuário num registro de evento, direcionar para o atendimento humano, integrar com o planilha… use a imaginação!

Como condição de saída, iremos direcionar o usuário para

o bloco Agradecer Justificativa.

2º passo: Agradecer a justificativa

Caso o usuário deixe uma mensagem, precisamos agradecê-lo por isso.

Então, encaminhe o usuário para o bloco de finalização. Lembre-se de alterar as condições de saída de acordo com a estratégia que você irá adotar em seu fluxo.

Exemplo de planilha preenchida:

Agora é só publicar e testar! 😀