Responder ao feedback

Nível de programação: iniciante
Duração: 15 minutos
Tipo de projeto: automação com um menu personalizado e um acionador orientado a eventos

Objetivos

  • Entenda o que a solução faz.
  • Entenda o que os serviços do Apps Script fazem na solução.
  • Configure o script.
  • Execute o script.

Sobre esta solução

Crie automaticamente rascunhos de respostas por e-mail para o feedback dos Formulários Google. Esta solução se concentra no feedback dos alunos sobre o curso, mas pode ser aplicada a qualquer caso de uso em que você receba feedback pelos Formulários Google.

Respostas de envio de formulários enviadas pelo Gmail

Como funciona

O script instala um gatilho orientado a eventos que é executado sempre que um usuário envia um formulário. A cada envio de formulário, o script cria um rascunho de e-mail no Gmail. O e-mail é enviado para a pessoa que enviou o formulário e inclui as respostas e uma mensagem de agradecimento genérica. Você pode editar o e-mail antes de enviá-lo.

Serviços do Apps Script

Esta solução usa os seguintes serviços:

  • Serviço de script: instala o gatilho acionado por eventos que é ativado quando alguém envia um formulário.
  • Serviço de planilha: envia as respostas do formulário para o Gmail.
  • Serviço do Gmail: cria o rascunho de e-mail com a mensagem de agradecimento e as respostas do formulário.

Pré-requisitos

Para usar esta amostra, você precisa atender aos seguintes pré-requisitos:

  • Uma Conta do Google (as contas do Google Workspace podem exigir a aprovação do administrador).
  • Um navegador da Web com acesso à Internet.

Configurar o script

Clique no botão a seguir para fazer uma cópia da planilha de exemplo Responder ao feedback. O projeto do Apps Script para essa solução está anexado à planilha.
Fazer uma cópia

Executar o script

  1. Clique em Ferramenta de respostas do formulário > Ativar respostas automáticas em rascunho. Talvez seja necessário atualizar a página para que esse menu personalizado apareça.

  2. Quando solicitado, autorize o script. Se a tela de permissão OAuth mostrar o aviso Este app não foi verificado, selecione Avançado > Acessar {Nome do projeto} (não seguro).

  3. Clique em Ferramenta de respostas do formulário > Ativar respostas automáticas em rascunho novamente.

  4. Clique em Ferramentas > Gerenciar formulário > Acessar o formulário ativo.

  5. Preencha o formulário e clique em Enviar.

  6. Abra o Gmail e verifique os rascunhos. Você vai ter um novo rascunho com a resposta do formulário.

Revisar o código

Para revisar o código do Apps Script dessa solução, clique em Ver código-fonte abaixo:

Acessar o código-fonte

Code.gs

solutions/automations/course-feedback-response/Code.js
// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/automations/course-feedback-response

/*
Copyright 2022 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Creates custom menu for user to run scripts.
 */
function onOpen() {
  let ui = SpreadsheetApp.getUi();
  ui.createMenu('Form Reply Tool')
      .addItem('Enable auto draft replies', 'installTrigger')
      .addToUi();
}

/**
 * Installs a trigger on the Spreadsheet for when a Form response is submitted.
 */
function installTrigger() {
  ScriptApp.newTrigger('onFormSubmit')
      .forSpreadsheet(SpreadsheetApp.getActive())
      .onFormSubmit()
      .create();
}

/**
 * Creates a draft email for every response on a form
 *
 * @param {Object} event - Form submit event
 */
function onFormSubmit(e) {
  let responses = e.namedValues;

  // parse form response data
  let timestamp = responses.Timestamp[0];
  let email = responses['Email address'][0].trim();

  // create email body
  let emailBody = createEmailBody(responses);

  // create draft email
  createDraft(timestamp, email, emailBody);
}

/**
 * Creates email body and includes feedback from Google Form.
 *
 * @param {string} responses - The form response data
 * @return {string} - The email body as an HTML string
 */
function createEmailBody(responses) {
  // parse form response data
  let name = responses.Name[0].trim();
  let industry = responses['What industry do you work in?'][0];
  let source = responses['How did you find out about this course?'][0];
  let rating = responses['On a scale of 1 - 5 how would you rate this course?'][0];
  let productFeedback = responses['What could be different to make it a 5 rating?'][0];
  let otherFeedback = responses['Any other feedback?'][0];

  // create email body
  let htmlBody = 'Hi ' + name + ',<br><br>' +
    'Thanks for responding to our course feedback questionnaire.<br><br>' +
      'It\'s really useful to us to help improve this course.<br><br>' +
        'Have a great day!<br><br>' +
          'Thanks,<br>' +
            'Course Team<br><br>' +
              '****************************************************************<br><br>' +
                '<i>Your feedback:<br><br>' +
                  'What industry do you work in?<br><br>' +
                    industry + '<br><br>' +
                      'How did you find out about this course?<br><br>' +
                        source + '<br><br>' +
                          'On a scale of 1 - 5 how would you rate this course?<br><br>' +
                            rating + '<br><br>' +
                              'What could be different to make it a 5 rating?<br><br>' +
                                productFeedback + '<br><br>' +
                                  'Any other feedback?<br><br>' +
                                    otherFeedback + '<br><br></i>';

  return htmlBody;
}

/**
 * Create a draft email with the feedback
 *
 * @param {string} timestamp Timestamp for the form response
 * @param {string} email Email address from the form response
 * @param {string} emailBody The email body as an HTML string
 */
function createDraft(timestamp, email, emailBody) {
  console.log('draft email create process started');

  // create subject line
  let subjectLine = 'Thanks for your course feedback! ' + timestamp;

  // create draft email
  GmailApp.createDraft(
      email,
      subjectLine,
      '',
      {
        htmlBody: emailBody,
      }
  );
}

Colaboradores

Esta amostra foi criada por Ben Collins, educador em benlcollins.com e Google Developer Expert.

Esta amostra é mantida pelo Google com a ajuda dos Google Developer Experts.

Próximas etapas