Documentação de Integração

Como enviar leads do Make.com para o CRM

Endpoint Base

https://raposoprimeplanejados.com.br/functions/receiveWebhookLeads

⚠ O token deve ser enviado como query parameter: ?token=SEU_TOKEN

Resumo Rápido

Método HTTP

POST

GET, PUT e DELETE são rejeitados (erro 405)

Content-Type Aceitos

application/json

application/x-www-form-urlencoded

Importante: O token da agência é determinado pela URL (?token=xxx), não pelo payload. Certifique-se de usar a URL correta para cada agência.

Campos Aceitos

Todos os campos abaixo são opcionais, exceto nome e telefone. Campos não reconecidos são ignorados silenciosamente.

Campo	Tipo	Descrição	Valores
`nome`OBRIGATÓRIO	string	Nome completo do lead
`telefone`OBRIGATÓRIO	string	Telefone com DDD e DDI (ex: 5511999998888)
`email`	string	E-mail do lead
`tipo_ambiente`	string	Tipo de ambiente desejado
`urgencia`	enum	Nível de urgência	`urgentenormal`
`imovel_status`	enum	Status do imóvel	`prontoem_obraplanta`
`tipo_projeto`	enum	Tipo de projeto	`casa_completaparcial`
`profissao`	enum	Profissão do lead	`arquitetoespecificadoroutro`
`faixa_investimento`	enum	Faixa de investimento	`ate_30k30k_60k60k_100kacima_100k`
`prazo_inicio`	enum	Prazo desejado para iniciar	`imediatamenteate_30_diasate_3_mesespesquisando`
`utm_source`	string	Origem UTM (padrão: 'Meta Ads')
`utm_medium`	string	Mídia UTM
`utm_campaign`	string	Campanha UTM
`utm_term`	string	Termo UTM
`utm_content`	string	Conteúdo UTM

Passo a Passo: Make.com

Crie um novo cenário no Make.com

Acesse o Make.com, clique em Create a new scenario e adicione o módulo que recebe os dados (ex: Webhook, Facebook Lead Ads, Google Sheets, etc.).

Adicione o módulo HTTP → Make a request

Após o módulo de trigger, adicione o módulo HTTP → "Make a request". Este módulo enviará os dados para a nossa API.

Configure a URL

Insira a URL completa com o token da agência correspondente:

https://raposoprimeplanejados.com.br/functions/receiveWebhookLeads?token=SEU_TOKEN

Substitua SEU_TOKEN pelo token da integração correta (visível no CRM → Integrações).

Configure o método e o Content-Type

Method: POST

Body type: Raw

Content type: JSON (application/json)

Monte o corpo (body) da requisição

Use os campos do trigger (mapeados via {{1.campo}}) para preencher o JSON. Exemplo:

Body JSON — Exemplo no Make.com

{
  "nome": "João Silva",
  "telefone": "5511999998888",
  "email": "joao@email.com",
  "tipo_ambiente": "Cozinha",
  "urgencia": "urgente",
  "imovel_status": "pronto",
  "tipo_projeto": "casa_completa",
  "profissao": "arquiteto",
  "faixa_investimento": "30k_60k",
  "prazo_inicio": "ate_30_dias",
  "utm_source": "Meta Ads",
  "utm_medium": "paid_social",
  "utm_campaign": "campanha_verao_2026",
  "utm_term": "conjunto_a_interesse",
  "utm_content": "criativo_video_01"
}

Mapeie cada campo do formulário/lead para a chave correspondente. Os campos nome e telefone são obrigatórios.

Teste e ative o cenário

Clique em Run once para testar. Se tudo estiver correto, você receberá uma resposta de sucesso:

Resposta de Sucesso (HTTP 200)

{
  "success": true,
  "lead_id": "6a48225a444ff74a98ddbe32",
  "message": "Lead recebido com sucesso"
}

Se faltar nome ou telefone, você receberá um erro 400:

Resposta de Erro (HTTP 400)

{
  "error": "Nome e telefone são obrigatórios"
}

Após validar, ative o cenário com o botão ON no canto inferior esquerdo.

Exemplos de Payload

Exemplo 1 — JSON (recomendado para Make.com)

{
  "nome": "João Silva",
  "telefone": "5511999998888",
  "email": "joao@email.com",
  "tipo_ambiente": "Cozinha",
  "urgencia": "urgente",
  "imovel_status": "pronto",
  "tipo_projeto": "casa_completa",
  "profissao": "arquiteto",
  "faixa_investimento": "30k_60k",
  "prazo_inicio": "ate_30_dias",
  "utm_source": "Meta Ads",
  "utm_medium": "paid_social",
  "utm_campaign": "campanha_verao_2026",
  "utm_term": "conjunto_a_interesse",
  "utm_content": "criativo_video_01"
}

Exemplo 2 — Form-URL-Encoded (formato nativo do Meta Lead Ads)

nome=João Silva
&telefone=5511999998888
&email=joao@email.com
&tipo_ambiente=Cozinha
&urgencia=urgente
&imovel_status=pronto
&tipo_projeto=casa_completa
&faixa_investimento=30k_60k
&prazo_inicio=ate_30_dias
&utm_source=Meta Ads
&utm_medium=paid_social
&utm_campaign=campanha_verao_2026

Exemplo 3 — cURL (para testes manuais)

curl -X POST \
  'https://raposoprimeplanejados.com.br/functions/receiveWebhookLeads?token=SEU_TOKEN_AQUI' \
  -H 'Content-Type: application/json' \
  -d '{
    "nome": "João Silva",
    "telefone": "5511999998888",
    "email": "joao@email.com"
  }'

Compatibilidade: Meta Lead Ads (formato nativo)

A API também aceita o payload nativo do Meta Lead Ads (com field_data). O sistema mapeia automaticamente os campos nativos do Meta para os campos do CRM:

Campo Meta (field_data)	→ Campo CRM
`full_name`	nome
`email`	email
`phone_number`	telefone
`campaign_name`	utm_campaign
`adset_name`	utm_term
`ad_name`	utm_content
`page_name`	pagina_origem

Se utm_source não for enviado explicitamente, o padrão será "Meta Ads".

Validações e Erros Comuns

400 — Nome e telefone obrigatórios

Ocorre quando os campos nome ou telefone estão vazios ou ausentes.

405 — Method Not Allowed

Ocorre quando a requisição não é POST.

Token inválido ou inativo

Se o token não existir ou estiver inativo, o lead será criado como Agencia 1 (padrão). Sempre confira o token na URL.

500 — Erro interno

Erro inesperado no servidor. Verifique o formato do JSON enviado.

Raposo Prime Italínea · Documentação de Integração de Webhooks