Leads de anúncios caindo direto no CRM

Por que ligar o anúncio ao CRM

Responder nos primeiros minutos multiplica a chance de contato. Pra isso, o lead precisa cair no funil no segundo em que existe, com uma atividade pro vendedor — em vez de ficar numa planilha do Facebook que ninguém abre.

O CRM recebe leads de qualquer fonte de tráfego pela API pública. Abaixo, as três receitas prontas.

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

Conexão nativa (quando liberada na sua conta)

Em Configurações → Canais e integrações → Meta Ads, conecte uma conta com acesso aos leads da página. Escolha cada formulário, funil, etapa e vendedor. Revise os campos reconhecidos e ative. As respostas ficam no histórico e o vendedor recebe uma tarefa de retorno. A seção Últimas entradas mostra o resultado e permite abrir a oportunidade ou tentar novamente após corrigir uma falha. Um mesmo ID de lead não duplica a oportunidade. A conexão nativa está em validação local/piloto; só está disponível onde a equipe liberou a integração oficial.

Automação via ferramenta externa

1. Crie uma chave de API em Configurações → Chaves de API (/settings/api-keys) e 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. Pra 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.

O lead nasce no primeiro estágio do funil segundos depois do preenchimento, com telefone, e-mail e campanha.

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 referência completa de endpoints, com exemplos de cURL e JavaScript, está em [Referência da API](/guia/api).

Receita 3 · Anúncio que abre o WhatsApp

Se o 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 inbox dizendo de onde ele veio. Funciona com qualquer forma de conexão do WhatsApp no CRM. Use um código diferente por campanha.

O que dá pra medir com isso

Com a origem em campo personalizado, você consegue filtrar a base por campanha em Configurações → Empresas, pessoas e oportunidades, criar oportunidades em massa pra uma origem específica e perguntar ao Jordão "quantas oportunidades da campanha X a gente ganhou?".

O relatório de oportunidades da API (/api/v1/reporting/deals) também devolve os campos personalizados, o que permite 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.