Automação de Formulários Google Sem Código

Visão Geral

Guia o usuário pela criação de um Formulário Google na interface do Forms e sua conexão com gatilhos do Google Apps Script, sem escrever uma integração personalizada ou sair do navegador. Cobre design de formulário, o editor do Apps Script, o gatilho onFormSubmit e pequenos scripts de tratamento de respostas que rodam automaticamente quando um formulário é enviado.

Quando Usar Esta Habilidade

• Use quando o usuário quiser criar um Formulário Google e automatizar o que acontece após os envios.
• Use quando o usuário pedir alertas por e-mail, registro em planilha ou tratamento condicional de respostas de formulário.
• Use quando o usuário quiser trechos de Apps Script para colar em um projeto de script vinculado ao formulário.
• Pule esta habilidade se o usuário precisar de interface personalizada, APIs pagas ou um aplicativo completo e independente de Apps Script.

Como Funciona

Etapa 1: Definir o formulário na interface do Forms

Crie o formulário no Google Forms com perguntas claras, tipos de resposta (resposta curta, múltipla escolha, caixa de seleção) e campos obrigatórios. Combine os IDs das perguntas com o que o script precisará mais tarde. Adicione uma descrição ao formulário para que os respondentes saibam o que esperar.

Etapa 2: Abrir o editor do Apps Script vinculado

No formulário, vá para Extensions > Apps Script. Isso abre um projeto vinculado ao formulário. O script pode ler cada envio através do objeto de evento e.response.

Etapa 3: Escrever o manipulador de resposta

Adicione uma função que aceite o evento onFormSubmit, leia e.response com getItemResponses() e, em seguida, execute a ação desejada: enviar um e-mail, escrever em uma planilha ou ramificar com base nas respostas.

Etapa 4: Instalar o gatilho

No Apps Script, vá para o menu de relógio/gatilhos, selecione a função onFormSubmit, escolha a origem do evento Do formulário e o tipo de evento Ao enviar formulário, em seguida, salve e autorize. A função é executada automaticamente a cada novo envio.

Etapa 5: Testar com um envio real

Envie uma resposta de teste de uma janela privada/anônima e verifique se o e-mail, a linha da planilha ou o log chegam uma vez. Verifique a página de execuções do Apps Script (Executions no editor) em busca de erros e leia o rastreamento de pilha se algo falhar.

Exemplos

Exemplo 1: Notificação por e-mail a cada resposta

function onFormSubmit(e) {
  const response = e.response;
  const email = getEmail(response);
  MailApp.sendEmail({
    to: email,
    subject: "Form submission received",
    body: "Thank you. We have recorded your response."
  });
}

function getEmail(response) {
  const items = response.getItemResponses();
  for (const item of items) {
    if (item.getItem().getTitle().toLowerCase().includes("email")) {
      return item.getResponse();
    }
  }
  return Session.getActiveUser().getEmail();
}

Exemplo 2: Registrar cada resposta em uma Planilha Google

function onFormSubmit(e) {
  const sheet = SpreadsheetApp.openById(SHEET_ID).getSheetByName("Responses");
  const itemResponses = e.response.getItemResponses();
  const row = [new Date()].concat(itemResponses.map(r => r.getResponse()));
  sheet.appendRow(row);
}

Exemplo 3: Ramificar com base em uma resposta de múltipla escolha

function onFormSubmit(e) {
  const items = e.response.getItemResponses();
  for (const item of items) {
    if (item.getItem().getTitle().toLowerCase() === "priority") {
      const priority = item.getResponse();
      const subject = priority === "High" ? "[URGENT] " : "";
      MailApp.sendEmail({ to: MANAGER_EMAIL, subject: subject + "New submission", body: itemResponsesText(e) });
    }
  }
}

Melhores Práticas

• ✅ Teste cada gatilho com um envio real antes de dizer ao usuário que funciona.
• ✅ Use títulos de perguntas claros e estáveis para que o script possa corresponder itens por título em vez de índices frágeis.
• ✅ Mantenha segredos e chaves de API nas propriedades do script, nunca codificados diretamente no arquivo.
• ✅ Adicione try/catch em torno da lógica do manipulador e registre erros com Logger.log para que as falhas apareçam na página de Execuções.
• ❌ Não conceda escopos amplos; execute com a permissão mínima que a ação do formulário necessita.
• ❌ Não envie e-mails para endereços que o formulário não coletou legitimamente.

Limitações

• As cotas do Apps Script se aplicam (limites de taxa de e-mail, gatilhos diários, tempo de execução); alto volume requer revisão.
• Apenas os envios de formulário acionam o evento; edições de respostas por usuários não disparam onFormSubmit por padrão.
• A habilidade produz scripts que o usuário deve colar, autorizar e implantar; ela não pode criar um projeto do Google Forms por si só.

…