Callback de atualização de leads

Endpoint

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

Como obter o token

1. Acesse o painel do Imobilead com perfil autorizado para integrações.
2. Abra a área de configurações da integração de Callback.
3. Gere ou copie o token vinculado ao ambiente que fará as atualizações.
4. Armazene esse valor com segurança e renove-o quando houver rotação de credenciais.

Como enviar a autenticação

Informe o token no header Authorization usando o formato Bearer.

Authorization: Bearer seu-token-de-integracao

Campos atualizáveis

Campo	Tipo	Descrição
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 responsável pela continuidade do atendimento.
notes	string	Observações operacionais adicionadas ao lead.
tags	array	Lista de tags para classificação e automações.
appointment_at	datetime	Data e hora de agendamento, quando houver.
external_reference	string	Chave do sistema externo para conciliação.

Obrigatório: envie sempre o lead_id junto com pelo menos um campo de atualização. Requisições sem token válido ou sem identificador do lead devem ser rejeitadas.

Exemplo completo com autenticação

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 sábado pela manhã.",
    "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 autenticação e atualização

Código	Motivo	Descrição
401	Token ausente	O header Authorization não foi enviado ou está vazio.
403	Token inválido	O token informado não pertence ao ambiente configurado ou foi revogado.
419	Token expirado	Renove a credencial no painel e atualize o segredo no sistema integrador.
404	Lead não encontrado	O lead_id informado não existe ou não pertence ao contexto da integração.