Modulo 1.2 - Webhooks e Comunicacao Basica

1

O que sao Webhooks e como funcionam

O que e:

Webhooks sao URLs que recebem dados de outros sistemas em tempo real. Funcionam como "portas de entrada" para sua automacao, permitindo que sistemas externos ativem seus cenarios instantaneamente quando algo acontece.

Por que aprender:

Webhooks sao a base de 70% das automacoes modernas. Permitem integrar qualquer sistema que envie HTTP requests - de formularios a APIs complexas.

Conceitos-chave:

HTTP POST, Payload, Headers, Endpoint, JSON, Real-time, Request/Response.

Como Funciona um Webhook

Sistema Externo

Formulario, API, App

HTTP POST → JSON payload

Webhook Make

URL unica

→

Cenario

Processa dados

Exemplo Real

Usuario preenche formulario no seu site → Formulario envia dados para webhook → Make recebe instantaneamente → Adiciona lead no CRM, envia email de boas-vindas e notifica vendedor no Slack. Tudo em segundos!

2

Criando seu primeiro Webhook no Make

O que e:

Processo de criar um modulo Webhook no Make que gera uma URL unica. Essa URL fica "escutando" requisicoes 24/7 e inicia o cenario quando recebe dados.

Por que aprender:

Habilidade essencial e fundamental. Webhooks conectam Make a formularios, chatbots, sistemas externos, APIs de terceiros - praticamente qualquer servico web.

Conceitos-chave:

Custom webhook, Webhook URL, Data structure, Determine data structure, IP restriction.

Passo a Passo

Crie um novo cenario no Make.com
Clique no + e busque "Webhooks"
Selecione Custom webhook
Clique em "Add" para criar novo webhook
De um nome descritivo (ex: "Formulario-Contato")
Copie a URL gerada - ela comeca com hook.make.com/...
Clique em "Run once" para deixar escutando
Envie dados para a URL para definir estrutura

Exemplo de URL Webhook


            https://hook.make.com/abc123xyz789def456

Cada webhook tem URL unica e permanente

3

Recebendo dados externos

O que e:

Configurar o webhook para interpretar corretamente os dados enviados - seja JSON, form-data, ou query parameters. Definir a estrutura de dados esperada para usar nos proximos modulos.

Por que aprender:

Dados mal interpretados causam erros em toda a automacao. Entender o formato de entrada e critico para mapear corretamente os campos.

Conceitos-chave:

JSON parsing, Form data, Query string, Content-Type, Data mapping, Headers.

Formato JSON

{
  "nome": "Maria",
  "email": "maria@email.com",
  "telefone": "11999999999"
}

Form Data

nome=Maria
email=maria@email.com
telefone=11999999999

Dica Importante

Sempre use "Re-determine data structure" quando o formato dos dados mudar. Isso garante que novos campos sejam reconhecidos pelo Make.

4

Respondendo a requisicoes

O que e:

Usar o modulo "Webhook response" para enviar uma resposta HTTP de volta ao sistema que chamou. Pode incluir dados processados, confirmacoes, ou mensagens de sucesso/erro.

Por que aprender:

Muitos sistemas esperam uma resposta para confirmar que os dados foram recebidos. Sem ela, podem tentar reenviar repetidamente ou marcar como erro.

Conceitos-chave:

HTTP response, Status code, Response body, 200 OK, 400 Bad Request, Timeout.

Codigos de Status HTTP

200 OK - Sucesso, tudo funcionou
201 Created - Recurso criado com sucesso
400 Bad Request - Dados invalidos
500 Server Error - Erro no servidor

Exemplo de Resposta

{
  "success": true,
  "message": "Lead recebido com sucesso!",
  "id": "lead_12345"
}

5

Webhooks com formularios simples

O que e:

Conectar webhooks a formularios HTML ou de plataformas como Typeform, Google Forms, JotForm. Capturar submissoes automaticamente assim que usuario envia.

Por que aprender:

Formularios sao a principal forma de capturar leads e dados de usuarios. Automatizar o processamento e essencial para marketing e vendas.

Conceitos-chave:

Form submission, Lead capture, Field mapping, Auto-response, Form validation.

Plataformas Compativeis

📋

Typeform

📝

Google Forms

📄

JotForm

🌐

HTML Nativo

Formulario HTML Basico

<form action="URL_DO_WEBHOOK" method="POST">
  <input type="text" name="nome" required>
  <input type="email" name="email" required>
  <button type="submit">Enviar</button>
</form>

6

Debug e troubleshooting de webhooks

O que e:

Tecnicas para identificar e resolver problemas com webhooks: logs, ferramentas de teste (RequestBin, Postman), verificacao de headers e payloads quando algo nao funciona.

Por que aprender:

Webhooks podem falhar silenciosamente. Saber debugar economiza horas de frustracao e permite resolver problemas rapidamente.

Conceitos-chave:

Request inspector, Postman, Console log, Error 4xx/5xx, Retry logic, Timeout.

Ferramentas de Debug

•
Postman: Envie requests de teste para seu webhook e veja a resposta
•
RequestBin: Capture e inspecione requests para entender o formato
•
Make History: Verifique execucoes anteriores no historico do cenario
•
Browser DevTools: Aba Network para ver requests do navegador

Erros Comuns e Solucoes

Webhook nao dispara: Verifique se cenario esta ativo e URL correta
Dados nao aparecem: Re-determine a estrutura de dados
Erro 403: Verifique restricoes de IP no webhook
Timeout: Responda em menos de 40 segundos

Proximo Modulo

1.3 - Google Workspace Essencial

Continuar →