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/jsoneAuthorization: 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.
