O que são Webhooks

O que é

Webhooks são "notificações automáticas" enviadas de um sistema para outro quando algo acontece. Em vez de você perguntar constantemente "aconteceu algo novo?", o sistema avisa você automaticamente.

Analogia simples

Imagine dois cenários:

Sem webhook (polling):

Você liga para a pizzaria a cada 5 minutos: "Minha pizza ficou pronta?"

"Não." ... 5 min depois ... "Ficou pronta?" "Não." ... "Ficou?" "Sim!"

Com webhook:

Você pede a pizza e diz: "Me liga quando ficar pronta."

A pizzaria liga: "Sua pizza está pronta!"

Webhooks funcionam como esse "me avisa quando acontecer".

Quando usar

• Receber leads de landing pages automaticamente
• Ser notificado quando um pagamento é confirmado
• Sincronizar dados com outros sistemas
• Disparar automações baseadas em eventos
• Integrar com ferramentas no-code (Zapier, Make)

Como funciona no Deskito

Webhooks de Entrada (Receber dados)

Outros sistemas enviam dados para o Deskito:

[Landing Page] → POST → [Deskito Webhook] → [Lead criado]

Webhooks de Saída (Enviar dados)

Deskito avisa outros sistemas quando algo acontece:

[Lead criado no Deskito] → POST → [Seu Sistema]

Conceitos Importantes

URL do Webhook

Endereço único que recebe os dados:

https://pmzxvyiyaaanmebcccvy.supabase.co/functions/v1/lead-webhook?token=abc123

Token de Autenticação

Código secreto que garante que só você pode usar o webhook:

?token=seu_token_secreto_aqui

Payload

Os dados enviados no webhook, geralmente em formato JSON:

{
  "name": "João Silva",
  "email": "joao@email.com",
  "phone": "(11) 99999-9999"
}

Método HTTP

Tipo de requisição. Para webhooks, usamos POST:

• GET = Buscar dados
• POST = Enviar dados ← Webhooks usam isso
• PUT = Atualizar dados
• DELETE = Remover dados

Passo a passo: Criar seu primeiro Webhook

1. Acesse Configurações → Integrações
2. Clique em Webhooks de Leads
3. Clique em Novo Webhook
4. Preencha: - Nome: Landing Page Principal - Status inicial: Novo Lead - Ativar automações: Sim/Não
5. Clique em Criar
6. Copie a URL gerada - você vai usar na sua landing page

Exemplo prático

Cenário: Conectar formulário do site ao CRM

1. Crio webhook no Deskito chamado "Site Institucional"

2. Recebo a URL: https://...../lead-webhook?token=xyz

3. Configuro meu formulário para enviar POST para essa URL

4. Quando alguém preenche o formulário:

- Dados são enviados automaticamente

- Lead aparece no CRM em segundos

- Automação de WhatsApp dispara (se configurada)

Testando seu Webhook

Pelo Deskito

1. Acesse o webhook criado
2. Clique em Testar
3. Preencha dados de exemplo
4. Clique em Enviar
5. Verifique se o lead foi criado

Por ferramentas externas

Use ferramentas como:

• Webhook.site - Para ver o que está sendo enviado
• Postman - Para enviar requisições de teste
• Insomnia - Alternativa ao Postman

Erros Comuns

Dicas e boas práticas

• Guarde o token em local seguro
• Sempre teste antes de usar em produção
• Monitore os logs de recebimento
• Use HTTPS (obrigatório para segurança)
• Não compartilhe URLs de webhook publicamente

Links relacionados:

• Eventos disponíveis
• Estrutura do payload
• Exemplos em JSON