Integração de saída de leads

Como funciona

1. Configure a URL de destino. No painel do Imobilead, informe a URL do sistema que deve receber o lead.
2. Dispare a integração. Quando um lead atender ao critério definido na operação, o Imobilead envia o payload para o endpoint configurado.
3. Processe o JSON recebido. O sistema externo deve validar os dados, registrar o lead e retornar um status HTTP de sucesso.
4. Confirme o recebimento. Responda rapidamente para evitar timeout e reenvios indevidos pelo fluxo integrador.

Formato do payload enviado

{
  "nome": "Lead de Teste",
  "email": "emaildolead@example.com",
  "telefone": "5562983282136",
  "produto": "Nome do produto de interesse",
  "id_portal": 144810,
  "notas": "Notas do lead",
  "id": "b0609d8d-195c-413f-8d74-7508ffe8d3d3",
  "user": {
    "nome": "Nome do usuário",
    "email": "usuario@gmail.com",
    "whatsapp": "+5511999999999"
  }
}

Campos do payload

Campo	Tipo	Descrição
nome	string	Nome do lead enviado pelo Imobilead.
email	string	E-mail do lead, quando informado no cadastro.
telefone	string	Telefone do lead no formato recebido pela plataforma.
produto	string	Produto, imóvel ou interesse relacionado ao lead.
id_portal	integer	Identificador interno do portal ou origem vinculada à integração.
notas	string	Observações adicionais associadas ao lead.
id	string	Identificador único do lead no Imobilead, útil para conciliação no sistema externo.
user.nome	string	Nome do usuário ou corretor relacionado ao lead.
user.email	string	E-mail do usuário ou corretor responsável.
user.whatsapp	string	WhatsApp do usuário ou corretor para contato rápido.

Resposta esperada do sistema externo

Para confirmar o recebimento, o endpoint externo deve retornar um status HTTP de sucesso, preferencialmente 200 OK ou 201 Created, junto com um JSON simples.

{
  "success": true,
  "message": "Lead recebido pelo sistema externo.",
  "external_reference": "crm-55421"
}

Boa prática: mesmo sem autenticação obrigatória por padrão, o endpoint externo pode aplicar validações próprias, como allowlist de IP, assinatura customizada ou token privado definido entre as partes.

O que o sistema externo deve tratar

• Validar o corpo JSON e o esquema esperado.
• Responder dentro do timeout acordado para evitar reenvios.
• Persistir o id do Imobilead para futuras conciliações.
• Registrar logs de falha para permitir reconciliação e monitoramento.

Falhas mais comuns

Falha	O que acontece
Endpoint indisponível	Se o sistema externo estiver fora do ar, o envio não será confirmado e o evento pode precisar de nova tentativa.
Timeout de resposta	Processamentos demorados devem ser enviados para uma fila assíncrona no sistema externo.
JSON fora do contrato	Alterações no schema devem ser combinadas previamente entre as equipes.