Sua primeira automação no n8n

n8n é uma ferramenta de automação: você conecta caixinhas (nós), cada uma faz uma única coisa, e os dados fluem de uma para a outra. Aqui você só precisa de duas. Uma que escuta quando chega um lead do seu site, e uma que te avisa no Telegram. Aqui está o quadro inteiro:

Por que vale a pena aprender essa uma vez: um webhook é uma porta de entrada universal. Qualquer coisa que consiga enviar uma requisição web pode bater nela, um formulário, outro app, um script. E o segundo nó é trocável. Aprenda o formato webhook-para-ação uma vez e você consegue montar quase qualquer "quando X acontece, faça Y" sem subir um backend.

1. O Webhook: a porta de entrada

O nó Webhook dá ao seu fluxo um endereço próprio na internet. Quando seu site envia o formulário para esse endereço (um POST), o n8n pega e inicia o fluxo.

A única coisa que você decide aqui é o método (POST) e o path. O n8n te dá a URL completa lá em cima; copie, você vai precisar dela no último passo. Deixe a autenticação em "None" para o primeiro teste, mas defina uma chave antes de usar pra valer: uma URL aberta pode ser chamada por qualquer um.

2. O nó Telegram: o aviso

A segunda caixinha pega os dados do lead e envia para você. Primeiro você precisa de um bot do Telegram (você cria conversando com o @BotFather no Telegram, que te dá um token) e salva ele como uma credencial no n8n.

A parte interessante é o texto. O que você escrever é enviado como está, mas os trechos dentro das chaves duplas são preenchidos com os dados que vieram do formulário: {{ $json.body.name }} coloca o nome, {{ $json.body.email }} o e-mail. Então a mensagem chega já com a informação dentro dela, e não vazia.

3. Conecte seu site

Falta um último fio: seu formulário precisa enviar os dados dele para a URL do webhook. No site, quando alguém envia o formulário, você faz um POST para esse endereço com os campos no corpo. É isso: o site envia o lead, o n8n recebe, e o Telegram te avisa.

Para testar sem mexer no site ainda, o n8n tem um botão "Listen for test event": você clica nele, envia um POST de teste para a URL, e vê os dados chegando ao vivo.

Quando algo quebra

Pepinos de primeira automação, e a solução:

• O evento de teste nunca chega. Você está postando no endereço errado. O n8n tem uma URL de teste e uma URL de produção separadas; enquanto testa, clique em "Listen for test event" primeiro e poste na de teste.
• O Telegram diz "unauthorized", ou nada chega. O token do bot está errado, ou você nunca mandou mensagem para o bot. Abra uma conversa com ele, envie /start uma vez, e reenvie.
• A mensagem chega vazia. O caminho do campo não bate com os dados que chegaram. Olhe o que o n8n recebeu e copie o caminho exato: pode ser {{ $json.body.name }} ou só {{ $json.name }}.
• Funciona no teste, morto em produção. O workflow não está Active. Vire o botão Active, e aponte seu formulário para a URL de produção, não a de teste.

Agora tente isto

Dois nós foi a lição. O alcance:

• Troque a segunda caixinha. Salve o lead numa Planilha Google, mande pro seu CRM, ou envie por e-mail. Mesmo webhook, ação diferente.
• Adicione um filtro. Coloque um nó IF no meio para que só os leads que importam te avisem.
• Mande um resumo no lugar. Junte os leads do dia e deixe uma tarefa agendada enviar a lista toda noite, uma mensagem em vez de vinte.
• Encadeie. Um gatilho, várias ações em sequência: te avisar, marcar o lead, e responder automaticamente para a pessoa.

O que você acabou de construir

Algo que acontece sozinho: um lead chega, um aviso sai, sem você olhando. E o padrão não é só para Telegram. Troque o segundo nó e o mesmo webhook salva o lead numa planilha, joga ele no seu CRM, ou te envia por e-mail. A primeira automação é a difícil; a segunda é só trocar uma caixinha.