Relatório de pesquisa de satisfação por atendente Raphael.xisto 19 de maio de 2022 14:18 Atualizado Í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: http://www.portal.blip.ai/application https://developers.google.com/oauthplayground https://developers.google.com/oauthplayground 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 > {{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! 😃 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! 😀 Artigos relacionados Como criar relatórios personalizados Como criar gráficos em um relatório customizado Integração Dashbot - Como enviar dados de um bot para o Dashbot? Como salvar dados do atendimento humano Como conectar a um canal de atendimento personalizado