ImobTotal

API e MCP

Seu CRM conectado aos sistemas da imobiliária, ao ChatGPT e ao Claude

A API REST pública liga o ImobTotal ao ERP da construtora, ao app próprio e ao sistema de qualquer parceiro. O conector MCP coloca leads, agenda e imóveis dentro do ChatGPT e do Claude. Os dois já vêm inclusos no seu plano.

Documentação interativa (Swagger): app.imobtotal.com.br/api/v1/docs

O que dá para fazer

Tudo que o CRM faz pela tela, outro sistema faz pela API

Mais de 50 rotas na versão 1, com o mesmo efeito de uma ação feita no CRM: roleta, automações, histórico e webhooks reagem do mesmo jeito.

  • Consultar leads, imóveis e equipe

    Ficha completa do lead (funil, etapa, etiquetas, corretor, interesse e histórico), catálogo de imóveis com fotos, filtros e semelhantes, empreendimentos, construtoras, corretores e equipe. Busca por ID, telefone ou referência do imóvel.

    • GET /leads
    • GET /leads/{id}/timeline
    • GET /imoveis
    • GET /corretores

  • Registrar contato e atividade

    Anotação na ficha do lead e compromisso na agenda do corretor (visita, ligação, retorno) a partir do sistema do parceiro, do app próprio ou de uma automação sua. Também cadastra leads novos vindos de landing page, portal ou formulário.

    • POST /leads
    • POST /leads/{id}/anotacoes
    • POST /leads/{id}/atividades

  • Mover etapa, corretor e etiquetas

    Altera o corretor responsável, a situação e as etiquetas do lead e move o lead de etapa no funil. O CRM registra a mudança como se fosse feita pela tela: roleta, automações e webhooks reagem do mesmo jeito.

    • PATCH /leads/{id}
    • POST /pipeline/leads
    • GET /pipeline/etapas

  • WhatsApp pela API, dentro do chat do CRM

    Envia texto para um lead já cadastrado pelo WhatsApp da imobiliária, igual ao envio feito pelo chat da ficha: a mensagem aparece no histórico e nunca vai para número avulso. Lê as conversas e os números conectados.

    • GET /whatsapp/conversas
    • POST /whatsapp/mensagens

  • Webhooks em tempo real

    O ImobTotal avisa o seu sistema na hora em que o fato acontece: lead criado, etapa alterada, corretor trocado, mensagem recebida, imóvel criado, alterado ou removido. Cada entrega vem assinada com HMAC e pode ser reenviada.

    • POST /webhooks
    • GET /webhooks/eventos
    • POST /webhooks/{id}/testar

  • Assistentes de IA via MCP

    O ChatGPT e o Claude enxergam o seu CRM: leads, agenda, funil e imóveis a uma pergunta de distância, com o login e as permissões de cada pessoa. No Claude, o assistente também registra contato, muda etapa e prepara o WhatsApp, que só sai depois da sua confirmação.

    • /api/v1/mcp (OAuth)

Rotas, eventos e limites conferidos no código do CRM ImobTotal em 05/11/2026; a lista completa está na documentação interativa.

Como ativar

Em 3 passos, a primeira chamada

  1. Emita o token no CRM

    Em Gestão › Operacional › API Tokens, crie um token com nome, validade (opcional) e as permissões por recurso: leads, imóveis, WhatsApp, portais, site e webhooks, cada um com leitura e/ou escrita. O token aparece uma única vez; guarde-o. Revogar é um clique.

  2. Mande o token no cabeçalho

    Toda chamada leva o cabeçalho x-api-key: SEU_TOKEN (ou Authorization: Bearer SEU_TOKEN). Sem token, a API responde 401; com token sem a permissão do recurso, 403.

  3. Faça a primeira chamada

    Liste os leads da conta. A resposta é JSON paginado, com funil, etapa, etiquetas e corretor de cada lead. Depois, explore as demais rotas na documentação interativa (Swagger), que já traz exemplos de corpo e de resposta.

Primeira chamadabash
curl -H "x-api-key: SEU_TOKEN" \
  "https://app.imobtotal.com.br/api/v1/leads?por_pagina=20"

Troque SEU_TOKEN pelo token emitido no CRM. A resposta traz os 20 primeiros leads em JSON, com funil, etapa, etiquetas e corretor.

Ver todas as rotas na documentação

MCP

Seu CRM dentro do Claude e do ChatGPT

O conector MCP é o padrão aberto que deixa o assistente de IA consultar outros sistemas. Endereço: https://app.imobtotal.com.br/api/v1/mcp. A autorização é com o seu login do CRM, e cada pessoa da equipe conecta a própria conta.

No Claude

  1. No Claude, abra Configurações › Conectores e clique em "Adicionar conector personalizado".
  2. Cole o endereço https://app.imobtotal.com.br/api/v1/mcp e dê um nome fácil de reconhecer, como "ImobTotal".
  3. Autorize com o seu login do CRM e clique em Permitir. Pronto: pergunte pelos seus leads numa conversa nova.

No ChatGPT

  1. No ChatGPT, abra Configurações › Modo desenvolvedor (beta) e escolha adicionar um conector MCP.
  2. Cole o endereço https://app.imobtotal.com.br/api/v1/mcp e dê um nome ao conector.
  3. Autorize com o seu login do CRM. No ChatGPT, o uso é de consulta: leads, agenda, funil e imóveis.

ChatGPT e Claude

Consulta

Leads e histórico de atendimento, agenda do dia, funil etapa por etapa, imóveis disponíveis e compatíveis com o lead, metas e bolsão de oportunidades. A resposta vem do seu CRM, e não da internet.

Claude

Escrita

Registrar contato, cadastrar ou corrigir lead, mudar etapa e etiquetas, criar compromisso na agenda. O assistente mostra o resumo do que vai alterar e pergunta se pode executar.

Claude

Confirmação em duas etapas

Enviar WhatsApp, enviar imóvel e alterações em lote: a ferramenta de preparo devolve um resumo e um token de confirmação (10 minutos, uso único). Nada sai para o cliente antes do seu OK.

Contatos protegidos e tudo auditado

  • Cada pessoa vê só o que o acesso dela no CRM permite: a conexão herda as permissões do usuário que autorizou.
  • Telefone e e-mail de proprietário não saem pelo conector; listas de leads vêm com contatos mascarados.
  • Pedido de lista de contatos é recusado, e o administrador recebe um aviso por e-mail quando alguém tenta.
  • Toda chamada, consulta ou escrita, fica na auditoria do CRM por app e por usuário; o administrador vê e revoga qualquer conexão na hora.

As conexões ativas da equipe ficam em Gestão › Conexões de IA. Detalhe do recurso em CRM no ChatGPT e no Claude.

Webhooks

8 eventos avisam o seu sistema na hora

Em vez de o outro sistema perguntar "mudou alguma coisa?", o ImobTotal faz um POST assinado para a sua URL no momento em que o fato acontece.

  • lead.criadoLead novo na conta, por qualquer origem: site, portal, WhatsApp, API ou cadastro manual.
  • lead.etapa_alteradaO lead mudou de etapa no funil, pela tela, pela API, por robô ou automação.
  • lead.corretor_alteradoO lead trocou de corretor responsável.
  • roleta.distribuidoA roleta (ou a regra de entrada do lead) entregou o lead a um corretor.
  • lead.mensagem_recebidaO lead mandou mensagem no WhatsApp conectado ao CRM.
  • imovel.criadoImóvel cadastrado (ou duplicado) pelo CRM ou pela API.
  • imovel.alteradoImóvel editado; agrupado em 1 aviso por imóvel a cada 60 segundos.
  • imovel.removidoImóvel enviado para a lixeira.

Assinatura HMAC em todo POST

Cada entrega chega com os cabeçalhos X-Imobtotal-Event, X-Imobtotal-Delivery, X-Imobtotal-Timestamp e X-Imobtotal-Signature (t=<timestamp>,v1=<HMAC-SHA256 em hexadecimal do segredo sobre "<t>.<corpo>">). O segredo whsec_… aparece só na criação e na rotação.

Reentrega automática e manual

Qualquer 2xx em até 10 segundos conta como entregue. Se falhar, o CRM tenta de novo até 8 vezes ao longo de cerca de 1 hora; o ID da entrega se repete para você não processar duas vezes. Pelo painel ou pela API, dá para reenviar uma entrega e disparar um ping de teste.

Regras simples

Até 10 webhooks por conta, só endereço público em https, histórico de entregas guardado por 30 dias. Vinte falhas seguidas pausam o webhook e avisam o administrador por e-mail; reativar é um PATCH.

Limites e segurança

Porta aberta, com trava e medida

Os limites existem para um sistema mal configurado não derrubar o seu CRM. Para o uso normal de uma integração, sobra folga.

ItemLimiteDetalhe
Chamadas à API60 por minutoPor token (20 a cada 10 s, 600 por hora). Catálogo de imóveis: 300 por minuto.
Conector MCP60 chamadas por minutoPor conexão. Alterações pelo MCP: 60 por hora por usuário; consultas seguem normais.
WhatsApp pela API300 mensagens por diaPor conta, com 20 por lead e 30 s entre mensagens ao mesmo lead. Só para lead já cadastrado.
PermissõesPor recursoLeads, imóveis, WhatsApp, portais, site e webhooks, cada um com leitura e/ou escrita (ex.: leads:read, imoveis:write).
Token da APIValidade que você defineSem validade ou com data de expiração; revogável com 1 clique, sem afetar os outros tokens.
Token do MCP90 dias, renovávelToken itm_… pessoal; a conexão por OAuth renova sozinha a cada uso.
WebhooksHMAC-SHA256Só https, até 10 por conta, reentrega automática, segredo rotacionável.

Rotas, eventos e limites conferidos no código do CRM ImobTotal em 05/11/2026; a lista completa está na documentação interativa.

Incluso no seu plano

API e MCP vêm inclusos no seu plano, sem módulo à parte

Em qualquer plano do ImobTotal, você emite o token, conecta o sistema do parceiro ou o assistente de IA e começa a usar. Veja os planos e as integrações nativas.

Perguntas sobre a API e o MCP

A API e o MCP custam à parte?+
Não. API REST e conector MCP estão inclusos no seu plano, em todos os planos do ImobTotal. Você emite o token em Gestão › Operacional › API Tokens (ou autoriza o assistente com o seu login) e começa a usar.
Preciso de programador para usar?+
Para a API, sim: normalmente é o desenvolvedor da construtora, do ERP ou do app parceiro que consome as rotas, com o token que você emitiu. Para o MCP, não: é copiar o endereço, colar no Claude ou no ChatGPT e autorizar com o seu login do CRM.
Quais permissões um token pode ter?+
Permissões por recurso: leads, imóveis, WhatsApp, portais, site e webhooks, cada um com leitura e/ou escrita. Um token só de consulta de leads tem apenas leads:read; outro pode criar imóveis com imoveis:write. Cada token tem nome, validade opcional e pode ser revogado com um clique.
O ChatGPT consegue alterar dados do CRM?+
No ChatGPT, o uso é de consulta: leads, agenda, funil e imóveis. As ações que alteram o CRM (registrar contato, mudar etapa e etiquetas, preparar WhatsApp) rodam pelo Claude, sempre com a sua confirmação, e tudo fica na auditoria.
Como sei que um webhook veio mesmo do ImobTotal?+
Pela assinatura: todo POST traz X-Imobtotal-Signature com t=<timestamp> e v1=<HMAC-SHA256 do segredo sobre "<t>.<corpo>">. Confira o v1 com o seu segredo whsec_… e recuse se o timestamp estiver a mais de 5 minutos do seu relógio.
Onde está a documentação?+
Na documentação interativa (Swagger) em app.imobtotal.com.br/api/v1/docs, com todas as rotas, filtros, exemplos de corpo e de resposta. O catálogo de eventos de webhook, com exemplo de payload, está em GET /api/v1/webhooks/eventos.

Veja a API e o MCP funcionando na sua operação

Na demonstração gratuita, mostramos o CRM e como ele se conecta ao sistema do seu parceiro e ao assistente de IA que a sua equipe já usa.

  • Migração grátis
  • Implantação grátis no plano anual
  • Sem fidelidade
  • Suporte humano 4,8/5
  • LGPD