Uma API para imobiliária serve para uma coisa simples: fazer o seu CRM conversar com o resto. O site feito por fora, o formulário do Elementor, o RD Station, a planilha do gerente e o sistema do contador. Na Viniun, isso fica em Integrações › API & Webhooks, sem precisar pedir desenvolvimento para ninguém.
Neste guia você vê as chaves de API, os webhooks, o endereço para receber leads de outros sistemas e a central de integrações. Se o que você procura é ligar o CRM a uma IA, o caminho é outro: veja conectar o CRM imobiliário ao ChatGPT.
Para que serve uma API para imobiliária?
A API é a porta pela qual outro sistema lê ou envia dados para o seu CRM, com autorização. O webhook é o contrário: o CRM avisa o outro sistema quando algo acontece. Juntos, eliminam o trabalho de copiar e colar.
- O site próprio mostra os imóveis sempre atualizados e manda cada contato para o funil.
- O formulário de uma landing page cria o lead direto no CRM.
- A planilha do gerente lê leads e propostas sem exportar arquivo.
- O ERP ou o contador recebe aviso de contrato assinado e negócio concluído.
Como funcionam as chaves de API na Viniun?
Cada sistema ganha a sua chave, com nome e só as permissões que precisa. Assim, se uma integração para de ser usada, você revoga só aquela.
As telas são da conta de demonstração da Viniun, com dados fictícios.
Permissões possíveis
| Permissão | Uso comum |
|---|---|
| Ler imóveis / criar e editar imóveis | Site próprio, sistema de anúncios |
| Ler leads / criar leads | Planilha do gerente, formulários externos |
| Ler propostas, contratos e transações | Contador, ERP, relatórios |
| Ler dados do site | Bairros, edifícios e construtoras no site próprio |
| Site no navegador (chave pública) | Site feito por fora: só o que o site já mostra e os formulários |
Cuidados que já vêm prontos
- A chave aparece uma única vez, na criação. Guarde como senha.
- Chave secreta fica bloqueada no navegador: só funciona de servidor para servidor.
- A chave pública do site pode ser limitada aos domínios do seu site. Outro site que copiar a chave é recusado.
- A tela mostra quantas chamadas cada chave fez e quando foi usada por último.
Como receber leads de outros sistemas no CRM?
A aba Receber leads dá um endereço único de recebimento. Tudo o que chega ali vira lead no funil, com origem "formulário externo", rodízio entre corretores e aviso ao corretor. Basta uma chave com a permissão "Criar leads".
O sistema reconhece nome, telefone ou WhatsApp, e-mail, mensagem, código do imóvel e os parâmetros UTM da campanha. O resto do formulário também é guardado e aparece na ficha do lead. Se o seu sistema mandar um identificador próprio, um reenvio com o mesmo identificador não duplica o lead.
Passo a passo por ferramenta
- Elementor (WordPress): nas ações após o envio, adicione Webhook e cole o endereço com a chave.
- RD Station Marketing: crie um webhook com gatilho "Conversão". Cada conversão vira um contato no lead, e o mesmo telefone não duplica.
- Typeform: em Connect › Webhooks, cole o endereço com a chave.
- Zapier e Make: use a ação de webhook (POST) com a chave no cabeçalho e mapeie nome, telefone, e-mail e mensagem.
Também dá para receber leads por e-mail: você aponta uma caixa como leads@suaimobiliaria.com.br e a Viniun lê as mensagens a cada 5 minutos. Essa leitura usa a cota de IA do plano. Leads de portais têm caminho próprio, explicado em integração com portais de imóveis.
O que são webhooks e quais eventos a Viniun avisa?
No webhook, você cadastra o endereço do seu sistema e escolhe os eventos. A Viniun envia um aviso em JSON sempre que um deles acontece:
| Evento | Quando dispara |
|---|---|
| lead.criado | Um lead novo entrou |
| lead.etapa / lead.convertido | O lead mudou de etapa ou virou cliente |
| imovel.publicado / imovel.despublicado | Um imóvel entrou ou saiu do ar |
| visita.agendada | Uma visita foi agendada |
| proposta.enviada / proposta.aceita | Uma proposta foi enviada ou aceita |
| contrato.assinado | O contrato foi assinado por todos |
| transacao.etapa / transacao.concluida | A transação mudou de etapa ou o negócio foi concluído |
| automacao.disparada | Uma automação usou a ação "webhook" |
Entrega confiável
- Todo envio leva uma assinatura no cabeçalho, para o seu sistema conferir que o aviso veio mesmo da Viniun.
- Se o seu sistema estiver fora do ar, a Viniun tenta de novo com espera crescente, de 1 minuto até 12 horas.
- Depois de 10 falhas seguidas, o webhook é desativado e o motivo aparece na tela. Ao reativar, o contador zera.
- O botão de teste envia um aviso na hora, para você conferir a integração.
Dá para criar um site próprio com IA ligado à API?
Sim. A aba Crie seu site com IA traz um texto pronto para colar no Lovable, no v0, no Claude ou no ChatGPT. A IA monta o site com os seus imóveis sempre atualizados, envia cada contato para o funil com o corretor do rodízio e deixa uma página por imóvel, dados estruturados e sitemap para o Google.
Depois de publicar, limite a chave pública ao domínio do site novo e faça um contato de teste. Para o site saber na hora quando um imóvel entra ou sai do ar, cadastre um webhook com os eventos de imóvel publicado e despublicado. Se preferir o site pronto da plataforma, veja site imobiliário com SEO e portais.
O que fica na central de integrações da imobiliária?
Em Integrações ficam as conexões dos serviços que a imobiliária usa, cada uma com o selo "Ligada" ou "Desligada" e um botão de teste. Nada depende de configuração no servidor.
- Facebook, Instagram e Google: anúncios, Pixel, página, Instagram e mensagens, conectados com login.
- ChatGPT, Claude e Gemini: o conector da equipe e a busca pública dos seus imóveis na IA.
- Google Agenda: cada corretor conecta a sua.
- WhatsApp, e-mail, cobrança pelo Asaas (boleto, Pix e cartão do aluguel), telefonia, consulta de restrição de CPF e assinatura eletrônica.
Cada uma tem as condições do serviço: a cobrança precisa de conta no Asaas, a consulta de CPF usa a conta do bureau da imobiliária, e o WhatsApp oficial depende da API da Meta. Veja o conjunto em sistema de integração e marketing.
Como começar a integrar a Viniun com outros sistemas?
- No menu lateral, abra Integrações › API & Webhooks.
- Em Chaves de API, toque em Nova chave, dê um nome ("Site próprio", "Contador") e marque só as permissões necessárias.
- Para formulários externos, abra Receber leads, copie o endereço e siga o passo a passo da sua ferramenta.
- Para avisar outro sistema, crie um webhook, escolha os eventos e use o botão de teste.
- Faça um contato de teste e confira o lead no funil.
Os leads que chegam por API seguem o mesmo atendimento do CRM imobiliário com WhatsApp e IA. Para usar o Claude no dia a dia da equipe, veja Claude para imobiliária. Quer ajuda para planejar suas integrações? Agende uma demonstração.
Perguntas frequentes
Preciso de programador para receber leads do meu formulário?
Na maioria dos casos, não. A tela traz o passo a passo para Elementor, RD Station, Typeform, Zapier e Make: basta colar o endereço de recebimento com a chave. Programação só é necessária em sistema próprio.
O mesmo lead pode entrar duplicado?
O sistema usa o telefone para não duplicar o contato no RD Station e aceita um identificador do seu sistema: um reenvio com o mesmo identificador não cria outro lead.
Como sei que o aviso do webhook veio mesmo da Viniun?
Todo envio leva uma assinatura no cabeçalho, calculada com um segredo do seu webhook. O seu sistema confere a assinatura antes de aceitar o aviso.
O que acontece se o meu sistema ficar fora do ar?
A Viniun tenta de novo com espera crescente, de 1 minuto até 12 horas. Depois de 10 falhas seguidas, o webhook é desativado e o motivo aparece na tela para você corrigir e reativar.
Posso colocar a chave de API no código do site?
Só a chave pública do site, que lê o que o site já mostra e envia os formulários. Limite essa chave ao domínio do seu site. As chaves secretas ficam bloqueadas no navegador e só funcionam pelo servidor.
Equipe Viniun
Time de produto e conteúdo da Viniun
Quem constrói a Viniun — CRM, site, WhatsApp com IA e gestão para imobiliárias, corretores e construtoras — conta aqui cada novidade da plataforma e o que aprende no dia a dia do mercado imobiliário.
Gostou? Receba os próximos no seu e-mail
O que muda na plataforma, explicado para quem usa, e ideias que dá para aplicar no mesmo dia em marketing, atendimento e gestão.
- No máximo 1 e-mail por semana
- Sem spam e sem repassar seus dados
- Cancele quando quiser, com um clique
