Como Integrar a Rockty com o Google Sheets (Formulários)
Introdução
A integração da Rockty com o Google Sheets permite que os dados capturados pelos formulários da Rockty sejam enviados
automaticamente para planilhas no Google Sheets. Isso facilita o armazenamento, visualização e gerenciamento dos dados
coletados. Este tutorial vai guiá-lo através do processo de configuração da planilha no Google Sheets e da integração
via Webhook na Rockty.
Etapa 1: Configurar a Planilha no Google Sheets
1. Criar uma Planilha no Google Sheets
Inicie criando uma planilha no Google Sheets. Caso precise de ajuda para criar uma planilha, consulte o artigo oficial
do Google:
Como criar uma planilha no Google Sheets.
2. Acessar o Apps Script
Com a planilha aberta, vá em ‘Extensões (Extensions)’ > ‘Apps Script’, conforme mostrado na imagem abaixo:
3. Adicionar o Código no Apps Script
Cole o seguinte código no Apps Script e ajuste os campos conforme necessário:
function doPost(e) {
var sheet = SpreadsheetApp.openById('ID-DA-PLANILHA');
var data = JSON.parse(e.postData.contents);
var nome = data.nome;
var email = data.email;
var telefone = data.telefone;
sheet.appendRow([new Date(), nome, email, telefone]);
}
3.1: Substituir o 'ID-DA-PLANILHA'
- No código acima, localize 'ID-DA-PLANILHA'.
- Substitua 'ID-DA-PLANILHA' pelo ID da sua planilha no Google Sheets, mantendo o ID entre aspas simples.
- Exemplo: Se o ID da sua planilha for 1A2B3C4D5E6F, substitua 'ID-DA-PLANILHA' por '1A2B3C4D5E6F' assim:
var sheet = SpreadsheetApp.openById('1A2B3C4D5E6F');
3.2: Como Localizar o ID da Planilha:
1. Abra a planilha desejada no Google Sheets.
2. Na barra de endereços do navegador, observe a URL da planilha. Ela será algo parecido com:
https://docs.google.com/spreadsheets/d/1A2B3C4D5E6F7G8H9I0J/edit
3. O ID da planilha é a sequência de caracteres entre /d/ e /edit. Por exemplo, para a URL:
https://docs.google.com/spreadsheets/d/1A2B3C4D5E6F7G8H9I0J/edit
O ID da planilha é:
1A2B3C4D5E6F7G8H9I0J
3.3: Ajustar as Variáveis
Ajuste as variáveis nome, email e telefone no código para corresponderem aos nomes dos campos do formulário. As
variáveis devem ser iguais aos nomes dos campos do formulário para garantir a correta associação de dados.
Opcional: Adicionar ou Remover Campos Personalizados:
Se precisar capturar informações adicionais, você pode criar outros campos no formulário e adicionar as respectivas
variáveis no código. Basta seguir o padrão existente:
- No formulário da Rockty, adicione o novo campo.
- No código do Apps Script, crie uma nova variável com o mesmo nome do campo e inclua-a na função appendRow.
📝 Por exemplo, se você adicionar um campo "Empresa" no formulário, ajuste o código da seguinte forma:
function doPost(e) {
var sheet = SpreadsheetApp.openById('ID-DA-PLANILHA');
var data = JSON.parse(e.postData.contents);
// Ajuste as variáveis conforme o nome dos campos do formulário
var nome = data.nome;
var email = data.email;
var telefone = data.telefone;
var empresa = data.empresa; // Novo campo adicionado
sheet.appendRow([new Date(), nome, email, telefone, empresa]); // Inclua a nova variável no array
}
Remover Campos:
Caso algum campo não seja necessário no formulário, você pode remover a variável correspondente do código. Por
exemplo, se o campo "Telefone" não for utilizado, basta remover a linha var telefone = data.telefone; e ajustar a
função appendRow para refletir as variáveis ativas:
function doPost(e) {
var sheet = SpreadsheetApp.openById('ID-DA-PLANILHA');
var data = JSON.parse(e.postData.contents);
// Ajuste as variáveis conforme o nome dos campos do formulário
var nome = data.nome;
var email = data.email;
sheet.appendRow([new Date(), nome, email]); // Variável 'telefone' removida
}
🚨 Atenção: Certifique-se de que o nome do campo no formulário e a variável no código sejam exatamente iguais, para que a
integração funcione corretamente. Isso inclui a correspondência exata de maiúsculas, minúsculas e espaços.
🚨 Atenção: Certifique-se sempre de que as variáveis no código correspondam aos campos efetivamente usados no formulário
para evitar erros na integração. Verifique se não há variáveis desnecessárias ou campos ausentes para evitar problemas.
3.4 Configurar Opções de Envio de E-mail (Opcional)
Estas instruções são opcionais e permitem configurar envios automáticos por e-mail tanto para você quanto para o cliente
que submeteu o formulário, com a possibilidade de anexar arquivos, como e-books.
3.4.1 Enviar E-mail de Confirmação com os Dados do Lead para Você (Opcional)
Para configurar o envio de um e-mail de confirmação com as informações submetidas pelo lead no seu formulário, adicione
o seguinte trecho de código após o sheet.appendRow:
// Configuração para envio de e-mail de confirmação
MailApp.sendEmail({
to: "seuemail@dominio.com", // Substitua pelo seu e-mail
subject: "Novo Lead Recebido",
htmlBody: "Você recebeu um novo lead com as seguintes informações:<br><br>" +
"<strong>Nome:</strong> " + nome + "<br>" +
"<strong>Email:</strong> " + email + "<br>" +
"<strong>Telefone:</strong> " + telefone
});
📌 Nota 1: Altere "seuemail@dominio.com" para o email que deseja receber as informações submetidas pelo lead.
📌 Nota 2: Se você tiver outros campos além dos exemplificados (como “empresa” ou “endereço”), inclua-os no código para
que apareçam na confirmação por e-mail.
📌 Nota 3: Para remover campos que não deseja incluir, apague no código a linha correspondente ao campo que não for
necessário.
📌 Nota 4: Os textos: "Novo Lead Recebido" e "Você recebeu um novo lead com as seguintes informações", podem ser editados
no código conforme desejado.
3.4.2 Enviar E-mail de Agradecimento e Documento para o Lead (Opcional)
Para configurar o envio de um e-mail de agradecimento automático para o cliente, com a opção de incluir um anexo,
adicione o seguinte trecho de código após o sheet.appendRow:
// Envio de e-mail de agradecimento com anexo para o lead
MailApp.sendEmail({
to: email, // E-mail do lead
subject: "Obrigado pelo seu interesse!",
htmlBody: "Olá " + nome + ",<br><br>Obrigado por se inscrever! Em anexo, você encontra nosso e-book.<br><br>Atenciosamente,<br>Sua Equipe",
attachments: [DriveApp.getFileById("ID-DO-ARQUIVO").getAs(MimeType.PDF)] // Substitua "ID-DO-ARQUIVO" pelo ID do arquivo no Google Drive
});
}
📝 Substitua "ID-DO-ARQUIVO" pelo ID do arquivo desejado. O ID pode ser encontrado na URL do arquivo no Google Drive.
💡 Para acessar a URL de um documento no Google Drive:
1. Abra o documento no Google Drive.
2. No canto superior direito, clique em "Compartilhar/Share".
3. Na janela que aparecer, você verá um link. Clique em "Copiar link/Copy Link" para obter o URL.
Por exemplo, na URL abaixo:
https://docs.google.com/document/d/1A2B3C4D5E6F7G8H9I0J/edit
O ID do documento é 1A2B3C4D5E6F7G8H9I0J.
📌 Nota: Os textos: "Obrigado pelo seu interesse!", "Olá ", "Obrigado por se inscrever! Em anexo, você encontra nosso
e-book.", "Atenciosamente" e "Sua Equipe", podem ser editados no código conforme desejado.
🚨 Importante: Se não for necessário anexar um documento, remova a linha attachments do código para evitar erros.
3.4.2 Limites de Envio Diários no MailApp
📝 O MailApp possui limites de envio diários que variam conforme o tipo de conta Google utilizada:
- Conta Google Pessoal: até 100 e-mails por dia.
- Conta Google Workspace:
- Plano Starter: até 1.500 e-mails por dia.
- Planos Business Standard e superiores: até 2.000 e-mails por dia.
💡 Para mais detalhes acesse > Google Workspace
⚠️ Observação: O Google aplica limites de envio por minuto para evitar que muitos e-mails sejam disparados de uma só
vez. Para fluxos maiores, considere uma plataforma de e-mail marketing.
💡 Dica: Informe seu cliente para ficar atento à caixa de SPAM, pois o e-mail de agradecimento enviado automaticamente
pode ser redirecionado para lá.
📌 Exemplo do código completo, incluindo as duas configurações opcionais:
// Função para processar o envio dos dados via POST
function doPost(e) {
var sheet = SpreadsheetApp.openById('ID-DA-PLANILHA'); // Substitua pelo ID da sua planilha
var data = JSON.parse(e.postData.contents); // Recebe os dados enviados como JSON
var nome = data.nome;
var email = data.email;
var telefone = data.telefone;
// Armazena os dados no Google Sheets
sheet.appendRow([new Date(), nome, email, telefone]);
// Configuração para envio de e-mail de confirmação com os dados do lead para você
MailApp.sendEmail({
to: "seuemail@dominio.com", // Substitua pelo seu e-mail
subject: "Novo Lead Recebido",
htmlBody: "Você recebeu um novo lead com as seguintes informações:<br><br>" +
"<strong>Nome:</strong> " + nome + "<br>" +
"<strong>Email:</strong> " + email + "<br>" +
"<strong>Telefone:</strong> " + telefone
});
// Envio de e-mail de agradecimento com anexo para o lead
MailApp.sendEmail({
to: email, // E-mail do lead
subject: "Obrigado pelo seu interesse!",
htmlBody: "Olá " + nome + ",<br><br>Obrigado por se inscrever! Em anexo, você encontra nosso e-book.<br><br>Atenciosamente,<br>Sua Equipe",
attachments: [DriveApp.getFileById("ID-DO-ARQUIVO").getAs(MimeType.PDF)] // Substitua "ID-DO-ARQUIVO" pelo ID do arquivo no Google Drive
});
}
4. Salvar as Alterações
Após ajustar o código, clique no ícone de ‘Salvar projeto (Save Project)’ para salvar as alterações.
5. Implantar o Script como Web App
Clique em ‘Implantação (Deploy) ’ > ‘Nova implantação (New deployment)’.
6. Configurar a Implantação como Web App
Na janela de configurações de implantação, siga os passos abaixo:
- Escolha ‘Web app’ na opção de configuração.
- No campo ‘Descrição’, dê um nome à implantação.
- Para o campo ‘Web app’, selecione o e-mail que irá executar o script.
- Em ‘Quem pode acessar’, escolha ‘Qualquer pessoa (Anyone)’.
- Clique no botão ‘Implantar’.
7. Autorizar o Acesso
Autorize o acesso ao script clicando no botão indicado.
8. Copiar o Link de Implantação
Após a implantação, copie o link gerado. Este link será usado na integração com a Rockty.
Etapa 2: Integrar a Planilha com a Rockty via Webhook
Para configurar a integração via Webhook na Rockty, siga os passos abaixo:
1. Adicionar um Formulário na Página da Rockty
📌 Caso precise de mais detalhes sobre como adicionar elementos, confira nosso tutorial Gerenciando Elementos na
Rockty: Adicionar, Excluir e Personalizar para orientações iniciais.
2. Configurar o Formulário na Rockty
- A. Clique na engrenagem do elemento formulário para acessar as configurações.
- B. Vá em ‘Ajustes’.
- C. No campo ‘Nome’, insira um nome único para o formulário.
❗ Importante: Se houver mais de um formulário na página, certifique-se de que cada um tenha um nome único.
- D. No campo ‘Integração’, selecione ‘Webhook’.
- E. No campo ‘URL (action)’, cole o link de implantação gerado no Google Sheets.
3. Configurar os Campos do Formulário
Para garantir a correta integração, os nomes dos campos no formulário da Rockty devem corresponder exatamente aos
identificadores definidos no Apps Script do Google Sheets:
- Acesse a engrenagem de cada campo do formulário para configurar os nomes dos campos.
- Insira o nome identificador do campo conforme configurado no Apps Script. Esse passo é crucial para que o
formulário funcione corretamente.
📝 Exemplo: O campo ‘Email’ do formulário na Rockty deve estar associado ao campo ‘Email’ configurado no Google
Sheets.
Publicar e Testar
Após finalizar a configuração, publique sua página e realize testes no formulário para garantir que os dados sejam
corretamente enviados e integrados ao Google Sheets de forma automática.
Conclusão
Neste tutorial, você aprendeu como integrar a Rockty com o Google Sheets usando Webhooks. Com esta integração, você
poderá gerenciar facilmente os dados capturados pelos formulários da Rockty diretamente em suas planilhas do Google
Sheets.
⚠️ Nota: Neste tutorial, vimos apenas como realizar a integração com o Google Sheets. Para mais detalhes sobre
configurações gerais e personalização dos seus formulários, consulte nosso guia completo: Como funciona o Elemento de
Formulários (Form) na Rockty
Recomendações
- Verifique os Nomes dos Campos: Certifique-se de que os nomes dos campos do formulário estejam alinhados com as
variáveis configuradas no Apps Script para evitar erros na integração. Mantenha os nomes dos campos no Apps Script
exatamente iguais aos identificadores dos campos no formulário da Rockty. A menor diferença pode causar falhas na
integração, então é importante revisar atentamente essa correspondência.
- Verifique o ID da Planilha: Certifique-se de que o ID da planilha inserido no código do Apps Script está correto e
no formato adequado. Um ID incorreto é uma causa comum de erros na integração. Para evitar problemas, revise o ID da
planilha com cuidado.
- Teste a Implantação: Teste o formulário para confirmar que os dados estão sendo enviados corretamente para o Google
Sheets.
- Ajuste as Permissões: Caso a integração não funcione, verifique as permissões de acesso configuradas no Web App do
Google Sheets.
- Permissões do Web App: Certifique-se de que o Web App está com as permissões definidas para "Qualquer pessoa".
- Limitações de Acesso ao Google Sheets: Lembre-se de que a integração depende da conexão com a internet e do acesso
ao Google Sheets. Se a planilha for movida, excluída ou se as permissões forem alteradas, a integração pode parar de
funcionar.
- Evite Campos Obrigatórios no Google Sheets: No Google Sheets, evite criar campos obrigatórios que possam impedir a
adição de novas linhas se um campo específico não estiver preenchido. Deixe que a lógica de verificação seja
controlada pelo formulário ou pela lógica no Apps Script
Recursos Adicionais
Para mais informações e suporte nas etapas abordadas neste tutorial, consulte os seguintes recursos do Google:
1. Criar uma Planilha no Google Sheets
Saiba como criar e configurar sua planilha no Google Sheets.
Acesse o artigo oficial do Google.
2. Introdução ao Google Apps Script
Aprenda a usar o Google Apps Script para automatizar tarefas e conectar serviços, como a integração com a Rockty.
Leia o tutorial do Google.
3. Publicar um Web App com Google Apps Script
Descubra como publicar seu Apps Script como um Web App, essencial para configurar corretamente a integração via
Webhook.
Confira o guia completo.
4. Gerenciar Permissões no Google Apps Script
Entenda as permissões e autorizações necessárias para o funcionamento do script e da integração.
Acesse o guia de permissões.
Precisa de Ajuda?
Se tiver dúvidas ou precisar de suporte adicional, entre em contato com nossa equipe de Suporte!