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:

Abra a planilha desejada no Google Sheets.
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
```
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.

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:

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.
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.
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:

Criar uma Planilha no Google Sheets
Saiba como criar e configurar sua planilha no Google Sheets.
Acesse o artigo oficial do Google.
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.
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.
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!