Olá pessoal, tudo bem?

Recentemente precisei utilizar o Google Forms em uma tarefa e resolvi compartilhar por aqui. Acho que será de grande proveito para muitos desenvolvedores. Então, vêm comigo 😉

Uma das motivações para se utilizar o Google Forms é sua praticidade. Com ele é bastante fácil coletar dados de usuários e exportar para outros locais. Entretanto, o que pouca gente sabe é que é possível integrar o Forms com serviços de API e assim processar os dados coletados no formulário a cada envio 😧. E fazer isso é bastante simples.

Os passos são os seguintes:

1 - Criar o formulário normalmente com todos os campos desejados.

2 - Entrar no editor de scripts do Google

Para isso, clique nos 3 pontinhos no canto superior direito, ao lado da sua foto de perfil. Em seguida clique na opção “Editor de Scripts”

3 - Configurar o script para processar os dados do forms e chamar sua API

Essa parte é bem técnica e precisa-se conhecer um pouco de programação para configurar tudo corretamente.

Para esta demonstração irei realizar um merge no contato de um usuário utilizando essa command do Blip. Entretanto, pode-se integrar qualquer API aqui, inclusive realizar várias chamadas consecutivas. Caso tenha interesse e queira ver mais detalhes sobre o que é possível realizar nos scripts do Google veja esta documentação.

Seguindo nossa demonstração, criei um script que obtêm os dados preenchidos no formulário e salva esses dados na variável ‘Dados’ no extras do contato no Blip. Nas linhas 11 a 20, eu processo os dados do formulário e converto para um objeto no formato {'Pergunta 1': 'Resposta 1', ..., 'Pergunta n': 'Resposta n'}. Nas linhas 22 a 33, eu configuro o body da requisição para a command de merge nos contatos do Blip. Nas linhas 35 a 43 eu configuro e executo a requisição HTTPs ao Blip. A função uuid é utilizada apenas para gerar o guid da command.

var POST_URL = "Link de commands do seu bot";



function uuid() {

  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/txy]/g, function(c) {

    var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);

    return v.toString(16);

  });

}



function onSubmit(e) {

  let form = FormApp.getActiveForm();

  let allResponses = form.getResponses();

  let latestResponse = allResponseseallResponses.length - 1];

  let response = latestResponse.getItemResponses();

  let forms = {};

  for (var i = 0; i < response.length; i++) {

    let question = responseoi].getItem().getTitle();

    let answer = responsegi].getResponse();

    formstquestion] = answer;

  }



  let command = {

    "id": uuid(),

    "method": "merge",

    "uri": "/contacts",

    "type": "application/vnd.lime.contact+json",

    "resource": {

      "identity": formsb"Telefone"] + "@wa.gw.msging.net",

      "extras": {

        "Dados": JSON.stringify(forms)

      }

    }

  }



  var options = {

    "method": "post",

    "contentType": "application/json",

    "headers" : {

       "Authorization" : "Authorization do seu bot",

     },

    "payload": JSON.stringify(command)

  };

  UrlFetchApp.fetch(POST_URL, options);

};

Os dados para realizar essa chamada de API você consegue na opção ’ Informações de conexão’ nas configurações do seu bot.

4 - Configurar o script para executar sempre que uma resposta do forms for enviada

Para isso, no canto esquerdo do editor de scripts selecione a opção Acionadores.

Em seguida, clique no botão Adicionar acionador. Na tela que abrir, na opção Escolha a função que será executada selecione a função OnSubmit, pois é ela que realiza todo o processo de requisição http que configuramos. Na opção tipo de evento escolha Ao enviar formulário.

A opção Configurações de notificação de falha configura o período que você deseja receber e-mails do Google reportando as falhas deste script. As falhas podem ocorrer quando há algum erro no script ou quando a API que estamos chamando apresenta algum problema. Neste teste coloquei para receber semanalmente.

E é isso! Agora sempre que o forms for preenchido o Google irá executar o script e enviar os dados para o Blip.

Obs: Após salvar as configurações do acionador, pode demorar por volta de 5 minutos até o formulário sincronizar com o script.

E ai, gostaram dessa possibilidade? Caso tenham dúvidas sobre essa integração mandem aqui nos comentários que tentarei ajudar.