Atualizacao de Leads

Callback

Endpoint protegido para atualizar um lead que ja existe no Imobilead. Este e o unico fluxo que exige autenticacao por token.

POST Token obrigatorio Atualiza lead existente

Endpoint

POST https://seu-dominio.com/callback/

Como obter o token

  1. Acesse o painel do Imobilead com perfil autorizado para integracoes.
  2. Abra a area de configuracoes da integracao de Callback.
  3. Gere ou copie o token vinculado ao ambiente que fara as atualizacoes.
  4. Armazene esse valor com seguranca e renove-o quando houver rotacao de credenciais.

Como enviar a autenticacao

Informe o token no header Authorization usando o formato Bearer.

Authorization: Bearer seu-token-de-integracao

Campos atualizaveis

Campo Tipo Descricao
lead_id string Identificador do lead dentro do Imobilead.
status string Novo status comercial, como novo, em-atendimento, ganho ou perdido.
broker_email string Corretor responsavel pela continuidade do atendimento.
notes string Observacoes operacionais adicionadas ao lead.
tags array Lista de tags para classificacao e automacoes.
appointment_at datetime Data e hora de agendamento, quando houver.
external_reference string Chave do sistema externo para conciliacao.
Obrigatorio: envie sempre o lead_id junto com pelo menos um campo de atualizacao. Requisicoes sem token valido ou sem identificador do lead devem ser rejeitadas.

Exemplo completo com autenticacao

curl -X POST "https://seu-dominio.com/callback/" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer seu-token-de-integracao" \
  -d '{
    "lead_id": "imd-102938",
    "status": "em-atendimento",
    "broker_email": "lucas@imobiliaria.com",
    "notes": "Cliente pediu visita no sabado pela manha.",
    "tags": ["prioridade-alta", "visita-agendada"],
    "appointment_at": "2026-04-20T14:00:00Z",
    "external_reference": "crm-55421"
  }'

Resposta esperada

{
  "success": true,
  "message": "Lead atualizado com sucesso.",
  "lead_id": "imd-102938"
}

Erros de autenticacao e atualizacao

401 - Token ausente

O header Authorization nao foi enviado ou esta vazio.

403 - Token invalido

O token informado nao pertence ao ambiente configurado ou foi revogado.

419 - Token expirado

Renove a credencial no painel e atualize o segredo no sistema integrador.

404 - Lead nao encontrado

O lead_id informado nao existe ou nao pertence ao contexto da integracao.