Entrada de Leads

Webhook

Use este endpoint para enviar leads de fontes externas, como portais, formulários de captação e campanhas de mídia, diretamente para o Imobilead. Cada integração gera uma URL própria no momento da criação do tipo Webhook no painel.

POST Autenticação não requerida Entrega imediata

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 oficial em 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	Email 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

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 email e telefone estão ausentes ou com formato inválido.

500 - Falha no processamento

Indica erro interno temporário. Nesses casos, implemente retentativa controlada no sistema de origem.