Introdução

👋
Bem-vindo
A API pública do Imoview Next conecta o seu sistema ao CRM da imobiliária. Em poucos minutos você já entrega leads, publica imóveis e sincroniza a base. Depois, dá para acompanhar e conduzir o atendimento (visitas, propostas, agenda) e ler os contratos da administração.

Comece em 5 minutos

Gere a chave e faça a primeira chamada bem-sucedida.

Conceitos-chave

Catálogo por nome, características, ações nomeadas, limites e erros.

Autenticação

Chave Bearer, escopos por rota, quem concede e rotação.

Enviar um lead

Entregue interessados e proprietários na fila de atendimento.

Conduzir o atendimento

Anotar, agendar visita, registrar parecer e incluir proposta.

Publicar um imóvel

Do catálogo à publicação, com moderação, fotos e proprietários.

Buscar e sincronizar

Filtre, pagine e mantenha a sua base em dia.

Cadastrar pessoas

Clientes, proprietários e contatos por nome.

Referência da API

Todos os endpoints, com exemplos e "Try It".

🔌 O que dá para integrar

Fluxo	O que você faz	Escopo
🎯 Leads	Entregar interessados e proprietários (captação) direto na fila de atendimento	`leads:write`
🏠 Imóveis	Publicar, atualizar, consultar e mudar a situação; fotos por URL, proprietários e etiquetas	`imoveis:read` / `imoveis:write`
🏗️ Lançamentos	Incluir e manter empreendimentos, blocos e unidades	`lancamentos:read` / `lancamentos:write`
🏢 Condomínios	Cadastrar e consultar condomínios e empreendimentos	`condominios:read` / `condominios:write`
👥 Pessoas	Cadastrar e consultar clientes, proprietários e demais contatos	`pessoas:read` / `pessoas:write`
🤝 Atendimento	Ler e buscar atendimentos, captações, visitas, propostas e negócios; anotar, descartar, agendar e conduzir visita, incluir proposta	`<objeto>:read` / `atendimentos:write`, `visitas:write`, `propostas:write`
🗓️ Agenda	Ler, incluir, alterar, concluir e cancelar atividades	`atividades:read` / `atividades:write`
📄 Contratos	Ler contratos e os movimentos de aluguel e repasse (módulo Administrativo)	`contratos:read`
🔑 Chaves	Ler as chaves do imóvel e o painel dos quadros	`chaves:read`
⚙️ Configurações	Listas de apoio, feriados, usuários, etiquetas; incluir cidade, bairro e mídia	vários (ver Autenticação)

🗺️ Como funciona

flowchart LR
  A["Seu sistema<br/>portal, site, app, ERP"] -->|"API pública"| B(("Imoview Next<br/>CRM"))
  B --> C["🎯 Leads<br/>fila de atendimento"]
  B --> D["🏠 Imóveis<br/>publicar e sincronizar"]
  B --> E["👥 Pessoas<br/>clientes e proprietários"]
  B --> F["🤝 Atendimento<br/>visitas e propostas"]
  B --> G["📄 Contratos<br/>aluguel e repasse"]
  B -.->|"webhooks"| A

🌐 Base URL

https://api.imoviewnext.com.br/pub/v1

🧭 Quatro princípios que guiam a API

Tudo por nome, não por id. Tipo de imóvel, bairro, cidade, unidade, característica, motivo e tipo de atividade vão pelo nome cadastrado no convênio. Nome inexistente ou ambíguo devolve 422, nunca criação silenciosa. A integração fica legível e independente dos ids internos.
Cadastro é de cada convênio. Características, tipos de imóvel, bairros, motivos e tipos de contato variam de uma imobiliária para outra. Por isso existe o catálogo (as rotas de Configurações): consulte-o antes de escrever.
Ação nomeada, nunca edição livre. No fluxo comercial (atendimento, visita, proposta, atividade), a API oferece ações com rota própria, e cada recusa volta com um código estável. Não há parâmetro para pular regra, e a API não exclui: inativa ou muda a situação.
Moderação na inclusão. Imóvel criado por API nasce em em_moderacao e só entra em feed de portal quando alguém do convênio libera, dentro do produto.

📘
Por onde começar
Gere sua chave e faça a primeira chamada em Comece em 5 minutos. Depois, leia os Conceitos-chave antes de integrar imóveis, pessoas e atendimento.