Como Enviar Webhooks do Google Forms

Com webhooks para Google Forms, você pode enviar (ou enviar) respostas de formulários para qualquer serviço web externo assim que alguém enviar um novo Google Form. Por exemplo, você pode usar webhooks para publicar automaticamente respostas do Google Forms em sua ferramenta de CRM. Ou você pode criar novas entradas em seu software de lista de e-mail quando um novo lead for capturado através do Google Forms.

A versão mais recente do complemento de Notificações por Email suporta webhooks e, além de fazer requisições HTTP para a URL de callback do webhook, o complemento também pode incluir a resposta do usuário e os dados do formulário no corpo da requisição HTTP.

Webhooks para Google Forms
Visão Geral da Integração de Webhook

Ativar Webhooks no Google Forms

Para começar, instale o complemento do Google Forms na loja do Google. O complemento é intitulado 'Notificações por Email', mas também inclui suporte para enviar notificações push instantâneas para qualquer URL de webhook.

Em seguida, inicie o complemento e escolha Webhooks para Google Forms no menu.

Clique no botão Criar Webhook para integrar um novo webhook com seu Google Forms. Você pode ter vários webhooks associados ao mesmo Google Form e ele enviará os dados dos formulários para todas as URLs de webhook quando uma nova resposta for recebida.

Adicionar a URL do Webhook e Parâmetros de Consulta

Na primeira tela, forneça um nome único para seu webhook (usado internamente) e escolha um método de Requisição HTTP. Você provavelmente fará uma requisição POST, mas o módulo de webhook também suporta métodos GET, PUT, PATCH e DELETE.

Em seguida, forneça a URL completa do webhook do serviço web externo que você deseja integrar com o Google Forms. Para fins de teste, recomendo usar o serviço webhook.site ou requestbin.com para obter uma URL única para inspecionar e testar seus webhooks.

URL do Formulário de Webhook
Configuração da URL do Webhook

A seção de Parâmetros de Consulta permite que você anexe parâmetros personalizados à URL do webhook. Por exemplo, se você estiver enviando webhooks de vários formulários, você pode anexar o parâmetro {{Form Id}} à sua URL para distinguir facilmente a origem de uma chamada de webhook específica.

Autorização e Autenticação

Você pode configurar seu webhook para incluir um token de portador secreto ou token de acesso para autorizar as chamadas. Você pode fazer autenticação básica com login e senha ou incluir as chaves de API com os cabeçalhos de autenticação.

Cabeçalhos Personalizados

Você também pode incluir cabeçalhos personalizados em seu(s) endpoint(s) de webhook. As chaves do cabeçalho podem ser strings ou números e não podem incluir espaços ou outros caracteres inválidos.

Corpo da Requisição

O corpo da requisição define o payload (resposta do formulário e dados personalizados) que é enviado para o serviço web quando uma entrada de formulário é recebida. Você pode enviar o payload em diferentes formatos, incluindo JSON, dados de formulário, XML e mais.

corpo da requisição do webhook

O payload pode ter metadados do formulário (como o ID do formulário, ID da resposta, URL de edição da resposta) e as respostas do usuário. Cada pergunta deve ser adicionada como um novo par de chave-valor no corpo da requisição, com o título da resposta entre chaves duplas.

Depois de definir seu webhook, clique no botão Testar e o complemento enviará uma requisição HTTP para a URL de callback usando dados do formulário da resposta mais recentemente recebida do seu Google Form.

Clique em Salvar para ativar o webhook.