Saída de Leads

Integração de Saída

Neste fluxo, o Imobilead envia dados de leads para um endpoint externo configurado no painel da plataforma, permitindo distribuição para CRMs, ERPs, automações e parceiros comerciais.

Webhook de saída Configuração via painel Imobilead Sem autenticação obrigatória por padrão

Como funciona

1. Configure a URL 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 Email 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 Email 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 pratica: mesmo sem autenticacao obrigatoria por padrao, o endpoint externo pode aplicar validacoes proprias, 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 conciliacoes.
  • Registrar logs de falha para permitir reconciliação e monitoramento.

Falhas mais comuns

Endpoint indisponivel

Se o sistema externo estiver fora do ar, o envio nao sera confirmado e o evento pode precisar de nova tentativa.

Timeout de resposta

Processamentos demorados devem ser enviados para fila assincrona no sistema externo.

JSON fora do contrato

Alteracoes no schema devem ser combinadas previamente entre as equipes.