Como receber webhooks no CRM (entrada), criar leads e conversões de fora

Assim como o CRM envia webhooks quando um lead avança de etapa, ele também sabe receber webhooks, ou seja, aceitar POSTs de outros sistemas e criar/atualizar leads automaticamente. É a forma padrão de conectar checkout, formulários externos, Meta Ads Lead Ads, TikTok Leads e qualquer plataforma que exponha webhook.

Como funciona

Cada workspace tem uma URL única no formato:

https://app.mkton.io/api/public/webhook/inbound/{workspace_id}/{secret}

Você cola essa URL no painel do sistema que vai enviar o dado (Facebook Business, checkout, Typeform, etc.). Toda vez que aquele sistema disparar um evento, a MKTOn recebe o JSON, aplica o mapeamento que você configurou e cria (ou atualiza) o lead na etapa que você escolher.

Passo a passo

1. CRM → Funis de venda → Automatize e escolha a etapa que vai receber os leads novos (ex.: "Novos leads").
2. Adicione o gatilho Receber webhook (URL de entrada).
3. Copie a URL de entrada e cole no sistema de origem (ex.: campo "Webhook URL" do Meta Lead Ads).
4. No modal, mapeie os campos: qual chave do JSON corresponde ao nome, e-mail, telefone e valor do lead.
5. Envie um POST de teste (mostramos o comando curl pronto no modal) e confira se o lead aparece no Kanban.

Casos de uso comuns

• Meta Lead Ads → toda submissão vira lead qualificado com origem "Facebook"
• Checkout (Hotmart, Kirvano, Kiwify) → compra aprovada vira lead na etapa "Cliente novo"
• Typeform / Tally → resposta de formulário vira lead com respostas em campos personalizados
• n8n / Zapier → agregam dados de várias fontes e mandam pro CRM já enriquecidos

Testar antes de conectar

Antes de plugar no sistema real, teste com curl direto do terminal:

curl -X POST https://app.mkton.io/api/public/webhook/inbound/SEU_WS/SEU_SECRET \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lead de teste",
    "email": "teste@exemplo.com",
    "phone": "5511999990000",
    "source": "teste-curl"
  }'

Se voltar 200 e o lead aparecer no Kanban em segundos, tá tudo certo. Se der erro, o modal mostra o log dos últimos disparos com o motivo da falha.