Como enviar um webhook do CRM para outro sistema (guia completo)

Se você já se pegou copiando dados do CRM pra outra plataforma na mão, atualizando uma planilha, avisando o financeiro no WhatsApp, criando um projeto no Trello toda vez que fecha uma venda -, você precisa de webhook. É a forma mais simples do CRM avisar outros sistemas que algo aconteceu, em tempo real, sem código.

O que é um webhook, em uma frase

Webhook é um POST HTTP que sai do CRM assim que um gatilho é disparado, carregando os dados do evento em formato JSON. Quem recebe (Zapier, Make, seu ERP, Slack) decide o que fazer com isso: criar linha na planilha, mandar mensagem, gerar boleto.

Quando usar (casos reais)

• Etapa "Venda ganha" → cria linha no Google Sheets de comissão
• Etapa "Perdido" → dispara pesquisa NPS pelo Typeform pedindo o motivo
• Etapa "Contrato assinado" → gera cobrança automática no Asaas ou no seu gateway
• Novo lead qualificado → alerta o closer no Slack ou Discord
• Reunião marcada → cria evento no Google Calendar e avisa o vendedor
• Cliente novo → cria projeto de onboarding no ClickUp ou Trello

Passo a passo no MKTOn

1. No painel, entre em CRM → Funis de venda e clique em Automatize (ícone de raio).
2. Escolha a etapa onde o gatilho deve disparar (ex.: "Fechado").
3. Clique em Adicionar gatilho → grupo Integrações → escolha um dos presets de webhook (Venda ganha, Remarketing, Cobrança…) ou o Enviar webhook genérico.
4. Cole a URL de destino no campo indicado (você pega essa URL na plataforma que vai receber, Zapier, Make, Slack, etc.).
5. Opcional: clique em Gerar automaticamente pra criar um segredo HMAC. O destinatário usa esse segredo pra confirmar que o POST veio mesmo da MKTOn.
6. Clique em Testar pra ver a resposta e em Salvar. Pronto, a partir de agora, todo lead que entrar naquela etapa dispara o webhook.

O que vai dentro do JSON

Cada preset envia um evento nomeado (`sale.won`, `remarketing.add`, `billing.request`…) junto dos dados completos do lead: id, nome, telefone, e-mail, valor, tags, funil, etapa de origem e destino, responsável. A prévia do JSON aparece no próprio modal de configuração, dá pra copiar e colar no destino pra montar o mapeamento antes mesmo do primeiro disparo.

{
  "event": "sale.won",
  "event_id": "evt_01H...",
  "workspace_id": "ws_...",
  "sent_at": "2026-07-08T14:32:11Z",
  "lead": {
    "id": "lead_...",
    "name": "Fulano de Tal",
    "email": "fulano@exemplo.com",
    "phone": "5511999998888",
    "value": 1500,
    "tags": ["quente"],
    "pipeline": "Funil principal",
    "stage_from": "Negociação",
    "stage_to": "Fechado",
    "responsible": { "id": "user_...", "name": "Vendedor" }
  },
  "sale": { "valor": 1500, "produto": "Plano Pro" }
}

Segurança: use o segredo HMAC

Como a URL do webhook é pública, qualquer pessoa que descobrir o endereço pode postar dados falsos no seu sistema. Pra evitar isso, a MKTOn assina cada POST com HMAC-SHA256 usando o segredo que você cadastra. O header X-MKTOn-Signature carrega a assinatura, do outro lado, você recalcula e confere. Sistemas como Zapier e Make aceitam essa validação nativamente.

E se eu quiser fazer o contrário, receber webhook?

Isso é o inverso: você quer que outro sistema (Meta Ads, checkout, formulário externo) avise a MKTOn quando algo acontece. Cobrimos isso no guia "Como receber webhook no CRM", com a URL de entrada da workspace e o mapeamento de campos.