ImobTotalCentral de Ajuda

Integração de leads via API

A API de leads permite que sistemas externos (um formulário do seu site próprio, uma landing page, outra ferramenta) enviem leads automaticamente para o CRM. É um recurso mais técnico — normalmente quem usa é quem cuida do seu site/marketing.

Onde fica

Menu Gestão › Tokens de API (a chave de autenticação). Sua Licença (CodSite) aparece abaixo do seu nome ao clicar na foto de perfil.

Como funciona (visão geral)

O sistema externo faz uma requisição POST para o endpoint do ImobTotal, com a sua chave de autenticação, enviando os dados do lead em JSON. O lead entra no CRM e passa pela Roleta, como qualquer outro.

  • Endpoint: https://imob3.sobressai.com.br/importacoes/integraleads/{CodSite} (troque {CodSite} pela sua licença).
  • Método: POST
  • Cabeçalhos: Content-Type: application/json e Authorization: Basic SUA_CHAVE (a chave é exclusiva da sua conta).
  • Corpo (exemplo):
{
  "name": "João da Silva",
  "email": "[email protected]",
  "message": "Vi seu anúncio e tenho interesse.",
  "leadOrigin": "Site",
  "phoneNumber": "5551992240000",
  "clientListingId": "CA0123"
}

name, email e phoneNumber são os principais; clientListingId (a referência do imóvel) vincula o lead a um imóvel; leadOrigin é a origem que aparece no CRM.

Dica: se você não é técnico, mande este tutorial e a chave (com cuidado) para quem cuida do seu site — é uma configuração de uma vez só.

Problemas comuns

  • Erro de autenticação — a chave precisa ser copiada exatamente como aparece no painel, no formato Authorization: Basic ....
  • Lead não vinculou ao imóvel — confira o clientListingId (precisa ser a referência real de um imóvel ativo).
  • Lead não foi distribuído — depende das regras da Roleta; veja se há regra/regra padrão que cubra essa origem.

Perguntas frequentes

Onde acho minha Licença (CodSite)? Clique na sua foto de perfil; a licença aparece abaixo do nome.

Isso é o mesmo que a integração do Facebook? Não. A API é para sistemas/formulários próprios; os anúncios do Facebook têm a integração dedicada.