Relatório de pesquisa de satisfação por atendente (Google Sheets) – Blip | Blip Help

Índice:

Vídeo demonstrativo

Incluindo novos dados em uma planilha do Google por uma API

1. Ativar Serviço de Sheets no seu Projeto

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.

No canto superior esquerdo, clique 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

No canto superior esquerdo, clique 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.

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.

Basta ir em PUBLICAR APLICATIVO, como na imagem abaixo:

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

Criando as Credenciais

No menu lateral esquerdo clique em Credenciais. Nessa página, 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 nas URLs de Redirecionamento Autorizados os seguintes links do portal:

Em seguida, clique em Criar e seguir para as chaves:

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

Autorizando as 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:

Em seguida, 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.

De 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:

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.

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.

Criando a 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 é essa 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 dadas a sua necessidade.

Criando um o fluxo de pesquisa no Builder

1. Para criar o 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 sub-bots, pode ser utilizado um fluxo para a captura da pesquisa de satisfação, por exemplo.

O fluxo deverá seguir esta lógica:

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

agente;
ticket;
time.

Observação: Você pode utilizar outros nomes.

3. Clique em Ações > Ações de Entrada > Definir Variável

Cada variável terá o seguinte valor:

agente > {{input.content@agentIdentity}}

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! 😃”

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 conforme os dados gerados nas suas credenciais do 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=FORMATTED_STRING&valueInputOption=USER_ENTERED

Exemplo de link preenchido:

https://sheets.googleapis.com/v4/spreadsheets/1nwvwDBddNRJoKe9P3OO6j4CO53c2JUyuzwgvTS1g2qg/values/nota!A:C:append?insertDataOption=INSERT_ROWS&responseDateTimeRenderOption=FORMATTED_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 biblioteca Blip para registrar data e hora.

As variáveis deverão ser inseridas na ordem correta conforme a coluna pertencente.

Em Salvar Resposta, coloque status2 e resposta

Fique atento à ordem das requisições. A primeira deve ser a de autorizar, seguida da planilha.

Finalizando o fluxo de pesquisa

1. 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 a planilha. Use a imaginação!

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

2. 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 conforme a estratégia que você irá adotar em seu fluxo.

Exemplo de planilha preenchida:

Agora é só publicar e testar!😀

Aqui, deixamos algumas sugestões de fraseologias, registro de dados e fluxo, mas ninguém melhor do que você para saber o que faz sentido para o seu negócio! Se precisar de apoio, conte com o time de Sucesso do Cliente Blip!

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃