## Etapa 1. Adicione o nó Webhook
Assim que seu fluxo do IoT Logic tiver sido criado, adicione um nó Webhook e conecte-o ao gatilho que iniciará a transmissão de dados.
O nó Webhook funciona como um mecanismo de envio e esquecimento. Isso significa que ele envia a solicitação HTTP imediatamente quando é acionado, mas não espera nem armazena a resposta do servidor.
Depois de adicionar o nó Webhook, configure-o da seguinte forma.
#### URL
Insira a URL do Web App do Google Apps Script associada à planilha do Google na qual você deseja enviar as informações.
#### Cabeçalhos
Adicione o seguinte cabeçalho HTTP:
| Chave | Valor |
| ---------------- | ---------------- |
| Tipo de conteúdo | application/json |
#### Corpo
O corpo da requisição deve estar no formato JSON. Ele deve incluir a chave de autenticação e quaisquer dados que você queira enviar ao Google Sheets.
Exemplo:
*{*
*"key": "MY\_SUPER\_SECRET\_123",*
*"evento": "relatório\_de\_combustível\_matinal",*
*"device\_id": "{{device\_label}}",*
*"timestamp": "{{comb\_current\_time}}"*
*}*
Você pode incluir quaisquer atributos adicionais do IoT Logic ou parâmetros de telemetria usando seus respectivos placeholders.
Observação: o campo "key" é obrigatório se o seu Google Apps Script usar um segredo compartilhado para autenticar requisições de webhook recebidas. Substitua "MY\_SUPER\_SECRET\_123" pelo segredo configurado no seu Google Apps Script.
## Etapa 2. Configure a planilha do Google
Abra sua planilha do Google, clique em Extensões e, em seguida, selecione Apps Script.
Isso abrirá o arquivo Code.gs, onde você adicionará o script responsável por receber as requisições de webhook e gravar os dados na planilha.
O código de exemplo a seguir pode ser usado para receber os valores enviados pelo nó do Webhook e anexá-los como uma nova linha na sua planilha do Google.
*function doPost(e) {*
*var SECRET\_KEY = "MY\_SUPER\_SECRET\_123";*
*var data = JSON.parse(e.postData.contents);*
*if (data.key !== SECRET\_KEY) {*
*return ContentService.createTextOutput("Access Denied").setMimeType(ContentService.MimeType.TEXT);*
*}*
*var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();*
*sheet.appendRow(\[*
*new Date(),*
*data.name || "",*
*data.device\_id || "",*
*data.longitud || "",*
*data.latitud || ""*
*]);*
*return ContentService.createTextOutput("Success").setMimeType(ContentService.MimeType.TEXT);*
*}*
**Observação**: Substitua o código de exemplo acima pelo script fornecido abaixo. Você também pode personalizar os campos para corresponder aos dados enviados do seu webhook do IoT Logic.
O script acima atua como um endpoint HTTP POST que recebe solicitações enviadas pelo nó Webhook do IoT Logic.
Sempre que uma solicitação é recebida, o script primeiro valida um segredo compartilhado (SECRET\_KEY) para garantir que apenas solicitações de webhook autorizadas possam gravar dados na Planilha Google. Se a autenticação for bem-sucedida, a carga útil JSON é analisada e os parâmetros especificados — como o carimbo de data e hora do recebimento, o nome do dispositivo, o ID do dispositivo, a longitude, a latitude ou quaisquer outros valores de telemetria — são adicionados automaticamente como uma nova linha na planilha.
Por fim, o script retorna uma resposta indicando se a operação foi concluída com sucesso (Sucesso) ou rejeitada devido a uma chave de autenticação inválida (Acesso negado).
Importante: Os nomes de campo usados no script devem corresponder exatamente aos nomes dos parâmetros enviados pelo IoT Logic Webhook. Cada valor é acessado usando a sintaxe data.\
Selecione Nova implantação e, em seguida, escolha Web App no menu de tipo de implantação. O processo de implantação pode levar alguns instantes. Quando ele for concluído, uma URL do Web App será gerada. Copie essa URL e cole-a no campo URL do Nó de Webhook no seu fluxo do IoT Logic. A URL do Web App é o endpoint que receberá as solicitações HTTP POST enviadas pelo Nó de Webhook.
#### Atualizando o Apps Script
Se você precisar modificar o Apps Script mais tarde, não precisará criar uma nova implantação.
Em vez disso, clique em Deploy → Gerenciar implantações, selecione a implantação existente e clique em Editar (ícone de lápis). Depois de salvar e reimplantar a versão atualizada, as alterações feitas no script entrarão em vigor imediatamente, mantendo a mesma URL do Web App.
Isso permite que você atualize o script sem precisar modificar a configuração do Webhook no IoT Logic.
Depois de concluir todas as etapas descritas neste guia, a conexão entre o IoT Logic e o Google Sheets deverá ser estabelecida com êxito.
Essa integração oferece uma maneira simples e eficaz de registrar dados de telemetria, parâmetros externos ou atributos personalizados do IoT Logic para geração de relatórios, análise, auditoria ou integração com outras ferramentas do Google Workspace.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/iot-logic/how-to-connect-an-iot-logic-webhook-node-to-google-sheets.md?ask=