ImobTotalCentral de Ajuda

Integração de leads via API

Atualizado em 3 ago 2026

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 › API Tokens (/gestao/api-tokens) — é onde você cria a chave de autenticação. O token precisa ter permissão de escrita em Leads.

A tela tem três botões de cópia — Copiar URL, Copiar x-api-key e Copiar body — porque essas três coisas vão em campos diferentes da requisição, nunca juntas.

Como funciona (visão geral)

O sistema externo faz uma requisição POST para o endpoint do ImobTotal, com o token no cabeçalho e os dados do lead em JSON no corpo. O lead entra no CRM e passa pela Roleta, como qualquer outro.

  • Endpoint: https://app.imobtotal.com.br/api/v1/leads
  • Método: POST
  • Cabeçalhos: Content-Type: application/json e x-api-key: SEU_TOKEN
  • Corpo (exemplo):
{
  "name": "João da Silva",
  "email": "[email protected]",
  "message": "Vi seu anúncio e tenho interesse.",
  "leadOrigin": "Site",
  "phoneNumber": "5551992240000",
  "clientListingId": "CA0123",
  "originLeadId": "form-2026-0142"
}

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; originLeadId é o identificador do lead no sistema de origem e evita atendimento duplicado.

Você não precisa informar a sua Licença (CodSite) — ela já vem no token.

A resposta confirma o recebimento e devolve um id_log. O processamento acontece em segundos, e você acompanha pelo id_log na Auditoria da Roleta (/gestao/roleta).

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

Problemas comuns

  • Erro de autenticação — o token vai no cabeçalho x-api-key, copiado exatamente como aparece no painel, e precisa ter permissão de escrita em Leads.
  • O JSON foi parar dentro do cabeçalho — cabeçalho e corpo são campos separados da requisição. Algumas ferramentas de formulário têm um único campo de texto e não deixam montar o corpo; nesse caso elas não servem para o POST direto — use o webhook nativo da ferramenta ou uma ponte (Make, Zapier) que receba o formulário e faça o POST.
  • 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 (ou regra padrão) que cubra essa origem.
  • Lead duplicado — o mesmo corpo enviado de novo em até 30 minutos é deduplicado. Para controle próprio, mande originLeadId.

Perguntas frequentes

Preciso informar minha Licença (CodSite)? Não. A imobiliária é identificada pelo token. (Sua licença continua visível abaixo do seu nome ao clicar na foto de perfil, se precisar dela para outra coisa.)

E o endereço antigo /api/public/integraleads? Ele continua existindo, mas não é o caminho para integração própria: é o canal por onde os portais (VivaReal, ZAP, OLX, Facebook) enviam leads, com chave provisionada pelo suporte e autenticação própria. Essa chave não é emitida pelo painel — para o seu formulário, use /api/v1/leads com x-api-key.

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.

Veja também