Leads de anúncios caindo direto no CRM

Lead de anúncio que não entra no CRM é dinheiro queimado

Você paga pelo clique, o lead preenche o formulário… e a resposta demora porque o lead ficou preso numa planilha do Facebook que ninguém abre. Estudos de resposta a lead são unânimes: responder nos primeiros minutos multiplica a chance de contato. O caminho é um só — o lead cai no funil no segundo em que existe, com uma atividade pro vendedor.

O CRM já recebe leads de qualquer fonte de tráfego hoje, pela API pública. Esta página é a receita pronta.

Receita 1 · Meta Lead Ads (formulário instantâneo) via Zapier ou Make

O formulário instantâneo do Facebook/Instagram é o formato mais comum de captação. A ponte é uma automação de 10 minutos:

1. Crie uma chave de API em Configurações → Chaves de API (/settings/api-keys) · guarde o token rmk_....
2. No Zapier (ou Make/n8n), crie a automação com o gatilho "Facebook Lead Ads · New Lead" e conecte a página do Facebook.
3. Adicione a ação Webhooks/HTTP → POST para https://crmdojordao.com.br/api/v1/deals com o header Authorization: Bearer rmk_... e o corpo:

``json { "title": "Lead do anúncio · {{nome do lead}}", "contact": { "name": "{{nome}}", "phone": "{{telefone}}", "email": "{{email}}" }, "customFields": { "origem_lead": "Inbound" } } ``

1. Quer saber qual campanha trouxe o lead? Crie um campo personalizado (ex.: campanha) em Configurações → Campos personalizados e mapeie {{campaign_name}} do Zapier pra ele. Na hora de filtrar a base ou pedir um raio-X pro Jordão, essa informação vale ouro.

Pronto: o lead nasce no primeiro estágio do funil segundos depois de preencher o formulário — com telefone, e-mail e campanha carimbados.

Receita 2 · Formulário do seu site / landing page

Mesmo endpoint, sem intermediário: o backend do seu site (ou a ferramenta de landing page com webhook de saída) faz o POST /api/v1/deals no envio do formulário. Repasse os parâmetros utm_source, utm_medium e utm_campaign da URL pra campos personalizados — é assim que o clique do Google Ads ou do Meta chega com a origem preservada.

⚠️ A chave de API fica no servidor, nunca no código da página que o navegador carrega.

A referência completa de endpoints, com exemplos prontos de cURL e JavaScript, está em [Referência da API](/guia/api).

Receita 3 · Anúncio que abre o WhatsApp

Se o seu anúncio manda o lead direto pro WhatsApp, use o link com mensagem pré-preenchida identificando a campanha:

`` https://wa.me/5531999999999?text=Olá! Vi o anúncio [PROMO-AGO] e quero saber mais ``

A primeira mensagem do lead já chega no seu inbox dizendo de onde ele veio — funciona com qualquer forma de conexão do WhatsApp no CRM. Use um código diferente por campanha e você sabe o que está trazendo gente sem depender de ferramenta nenhuma.

O que dá pra medir com isso

Com a origem em campo personalizado, você consegue: filtrar a base por campanha em Configurações → Base de Leads, criar negócios em massa pra uma origem específica, e perguntar ao Jordão coisas como "quantos negócios da campanha X a gente ganhou?". O relatório de negócios da API (/api/v1/reporting/deals) também devolve os campos personalizados — dá pra plugar num Google Sheets ou BI.

Erros comuns

• Lead duplicado a cada envio: use o header Idempotency-Key no POST (qualquer string única por lead, ex. o ID do lead no Facebook). Reenvio com a mesma chave não cria de novo.
• 401 na chamada: token errado ou revogado · confira em Configurações → Chaves de API.
• Campo personalizado não aparece: o campo precisa existir ANTES (Configurações → Campos personalizados) e o key usado no JSON é o identificador do campo, não o rótulo.