Webhook de entrada de leads

Endpoint

POST https://app.imobilead.me/integrate-api/integracoes/webhook/{SEU-CODIGO}

O trecho {SEU-CODIGO} é gerado pelo Imobilead quando você acessa Integrações > Adicionar integração > Webhook, informa um nome e conclui a criação da integração. Essa URL deve ser copiada e cadastrada na plataforma de origem do lead.

Como obter a URL: siga o tutorial Recebendo leads via webhook. Depois de criar a integração no painel, o Imobilead disponibiliza a sua URL exclusiva para uso nas ferramentas de conversão.

Payload aceito

O corpo da requisição deve ser enviado em JSON. Os campos abaixo cobrem os casos mais comuns de captação.

Campo	Tipo	Obrigatório	Descrição
nome	string	Sim	Nome do lead.
email	string	Não	E-mail do lead.
telefone	string	Sim	Telefone do lead com DDD.
produto	string	Não	Produto ou imóvel de interesse informado na origem.
observacao	string	Não	Observação ou mensagem enviada pelo lead.

Regra importante: envie sempre o campo nome e, sempre que possível, complemente com email e telefone para facilitar o atendimento do lead.

Exemplo de requisição

curl -X POST "https://app.imobilead.me/integrate-api/integracoes/webhook/{SEU-CODIGO}" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Nome do lead",
    "email": "emaildolead@example.com",
    "telefone": "62983282136",
    "produto": "produto-de-interesse",
    "observacao": "Observação ou mensagem do lead"
}'

Resposta esperada

{
  "message": "okay"
}

Erros comuns

Código	Motivo	Como resolver
400	Payload inválido	Ocorre quando campos obrigatórios não foram enviados ou o JSON está malformado.
415	Content-Type incorreto	Envie Content-Type: application/json para evitar rejeição do payload.
422	Dados inconsistentes	Pode acontecer quando e-mail e telefone estão ausentes ou com formato inválido.
500	Falha no processamento	Indica erro interno temporário. Implemente retentativa controlada no sistema de origem.