Guias passo a passo para usar a Villari Vita

Se você esqueceu sua senha, é possível redefini-la pelo e-mail cadastrado.

1. Acesse /login e clique em Esqueci minha senha.
2. Você será levado para /recuperar-senha. Digite o e-mail da sua conta.
3. Clique em Enviar link de recuperação.
4. Abra a caixa de entrada do e-mail e procure a mensagem com assunto "Redefina sua senha | Villari Vita". Se não encontrar, verifique a pasta de spam.
5. Clique no botão Redefinir senha dentro do e-mail.
6. Você cairá em /redefinir-senha. Digite a nova senha duas vezes (mínimo 8 caracteres).
7. Clique em Salvar nova senha. Pronto — pode fazer login com a nova senha.

Apenas corretores com CRECI ativo e validado podem anunciar imóveis. A validação é manual: você envia a certidão e o admin master da Villari Vita aprova ou pede correção.

Passo a passo

1. Faça login como corretor.
2. No menu lateral, abra Configurações → CRECI (ou acesse direto /imobiliaria/validar-creci).
3. Preencha o Número do CRECI (ex.: 12345).
4. Informe a UF (ex.: SP) — opcional, mas recomendado.
5. Em Certidão de regularidade, anexe o documento atualizado emitido pelo seu CRECI regional. Aceitamos PDF, JPG, PNG ou WEBP, até 10 MB.
6. Clique em Enviar para análise.
7. O admin master vai revisar. Você acompanha o status na mesma página.

Status possíveis

• Em análise (cinza): documento em revisão.
• Validado (verde): liberado para anunciar — válido por 1 ano.
• Rejeitado (vermelho): leia o motivo e envie nova certidão.
• Expirado (laranja): a validação venceu — envie certidão atualizada para reativar seus anúncios.

1. Faça login como construtora.
2. Acesse /painel/perfil.
3. Atualize as informações da empresa:
   • Logo e foto de perfil (idealmente PNG com fundo transparente)
   • Nome, CNPJ, descrição
   • Telefone, WhatsApp, e-mail, website
   • Redes sociais: Instagram, Facebook, LinkedIn, YouTube, TikTok
   • Coordenador de vendas e e-mail de notificação (recebem leads e propostas)
4. Clique em Salvar.

O fluxo é parecido nos dois casos, mas em URLs diferentes.

Imobiliária

1. Apenas usuários com papel OWNER ou ADMIN da imobiliária podem editar.
2. Acesse /imobiliaria/perfil.
3. Edite nome, foto, descrição, contato, redes sociais e especialidades.
4. Salve.

Corretor

1. Faça login como corretor.
2. Acesse /imobiliaria/perfil.
3. Atualize: avatar, nome, telefone, WhatsApp, e-mail, especialidades, bio e redes sociais.
4. Se você ainda não validou o CRECI, vai ver a seção dedicada na mesma página — siga o guia Validar CRECI.
5. Salve.

Toda imobiliária tem um site próprio no formato villarivita.com.br/site/[slug], com identidade visual customizável.

Passo a passo

1. Faça login como OWNER ou ADMIN da imobiliária.
2. Acesse /imobiliaria/site.
3. Configure as imagens:
   • Logo do header, logo do footer, favicon e banner
   • Marque Mostrar logo no header/footer e ajuste o tamanho do logo (24–120 px)
4. Defina as cores no padrão hex (#XXXXXX) ou RGB:
   • Cor primária e secundária
   • Fundo e texto do header e do footer
   • Cor dos botões
5. Preencha textos: título do site, descrição, conteúdo do hero, texto sobre e política de privacidade.
6. Decida se quer exibir perfis em destaque (corretores) na home.
7. Clique em Salvar.
8. Veja o resultado em villarivita.com.br/site/{seu-slug} — páginas disponíveis: início, sobre, buscar, construtoras, corretores.

Domínio próprio

Para usar um domínio como www.suaimobiliaria.com.br:

1. Acesse /imobiliaria/dominio.
2. Informe o domínio que você possui.
3. Siga as instruções de DNS — a Villari Vita cuida de SSL e propagação via Cloudflare automaticamente.

Empreendimento é o produto da construtora — pode ser loteamento, condomínio horizontal ou vertical.

Criar

1. Faça login como construtora.
2. Acesse /painel/empreendimentos e clique em Novo empreendimento.
3. Preencha:
   • Nome, cidade, tipo (Loteamento, Condomínio, Vertical)
   • Endereço completo: CEP, rua, número, complemento, bairro
   • Latitude e longitude (são geocodificadas automaticamente a partir do endereço)
   • Descrição, termos de pagamento, % mínima de pagamento
   • Data de entrega, área total, número de andares (vertical)
   • Tipologias: para cada planta, informe quartos, suítes, banheiros, área e área privativa
4. Clique em Salvar. Você será redirecionado para a página de detalhe do empreendimento.

Abas do empreendimento

Após criar, complete cada aba:

• Unidades — adicione manualmente, importe CSV ou configure webhook.
• Mídias — fotos, vídeos e tour virtual.
• Plantas — implantação e plantas das tipologias.
• Documentos — folder, tabela de vendas, manual da obra.
• Equipe — gerentes comerciais que aparecem na página pública.
• Notas para corretores — informações privadas (regras de comissão, condições especiais).

Imóvel pronto (avulso) é diferente de empreendimento. Ele é cadastrado em Meus imóveis.

1. Acesse /painel/meus-imoveis (construtora) ou /imobiliaria/imoveis (imobiliária / corretor).
2. Clique em Novo imóvel.
3. Preencha:
   • Título claro e específico (ex.: "Apartamento 2 quartos próximo ao metrô Sé")
   • Tipo: Apartamento, Casa, Comercial, Terreno
   • Finalidade: Venda ou Aluguel
   • Preço, área privativa, quartos, vagas
   • Endereço, bairro, cidade
   • Fotos em alta resolução (a primeira vira capa)
4. Salve como rascunho ou publique direto.

Status do imóvel

• DRAFT — rascunho, só você vê.
• AVAILABLE — publicado e visível no marketplace.
• RESERVED — reservado, ainda visível mas marcado.
• SOLD — vendido (ou alugado).

A listagem em Meus imóveis tem abas: Venda, Aluguel, Rascunho e Inativos.

Existem duas variações: a versão simples (construtora) e a versão com proposta (corretor).

Versão construtora — para enviar a um corretor

1. Vá no detalhe do empreendimento.
2. Clique em Compartilhar com corretor.
3. (Opcional) Personalize título e mensagem inicial.
4. Clique em Gerar link.
5. Use os botões Copiar, Abrir ou WhatsApp.

O destinatário acessa fotos sem login. Para ver unidades, plantas e arquivos, ele precisa entrar como corretor da Villari Vita.

Versão corretor — para enviar ao cliente final

1. No detalhe do empreendimento ou imóvel, clique em Compartilhar.
2. Selecione o cliente (lead existente) ou crie um novo.
3. Monte a proposta:
   • Selecione tipologias e unidades
   • Defina se quer ocultar preços
   • Defina se quer mostrar disponibilidade em tempo real
   • Adicione múltiplas opções para o mesmo cliente
4. Gere o link e envie por WhatsApp ou copie.

A proposta é enviada da reserva da unidade — quando o corretor reserva uma unidade de um empreendimento, ele monta a proposta e envia para a construtora analisar.

Passo a passo (corretor)

1. Acesse /imobiliaria/reservas.
2. Clique na reserva que deseja transformar em proposta (ou faça uma nova reserva via empreendimento).
3. Clique em Enviar proposta.
4. Preencha os itens da proposta:
   • Ato — valor pago no momento da assinatura
   • Entrada — valor de entrada parcelada
   • Parcela mensal — quantidade × valor
   • Balão — reforços (anuais ou semestrais)
   • Chaves — valor pago na entrega
5. O total é calculado automaticamente. Adicione observações livres se quiser.
6. Clique em Enviar. A proposta vai com status PENDING para a construtora.

Lado construtora

Em /painel/reservas, a construtora vê propostas pendentes e pode Aceitar ou Recusar. O corretor recebe a notificação e pode reenviar uma proposta revisada se necessário.

O CRM da construtora é uma visualização consolidada dos leads que chegaram aos empreendimentos.

1. Acesse /painel/crm.
2. Você verá um kanban com 7 colunas: Novo Lead, Tentativa de contato, Atendimento, Oportunidade, Visita marcada, Visita realizada, Fechamento.
3. Cada card mostra nome do lead, empreendimento de interesse e corretor responsável.
4. O contador no topo de cada coluna indica quantos leads estão em cada etapa.

O CRM do corretor é interativo, com kanban arrastável e gestão completa do pipeline.

Visão geral

• Pipeline / Em negociação em /imobiliaria/negociacoes — kanban com 7 etapas + Ganhas e Perdidas.
• Ganhas em /imobiliaria/negociacoes?status=won — negócios fechados.
• Perdidas em /imobiliaria/negociacoes?status=lost — leads encerrados sem fechamento.
• Clientes em /imobiliaria/clientes — base completa de contatos.

Trabalhar um lead

1. Abra Pipeline.
2. Use o filtro de busca para encontrar por nome, WhatsApp, e-mail, produto ou comentário.
3. Clique no card para abrir o Editar lead: ajuste nome, WhatsApp, produto vinculado, observações, etc.
4. Para mover de etapa, arraste o card para a coluna seguinte (drag-and-drop).
5. Use o botão Toque hoje para marcar que você teve contato hoje — útil para priorizar quem está esfriando.

Visualizações

No topo da página você alterna entre:

• Kanban — visão padrão por etapas.
• Lista — tabela ordenável.
• Grid — cards em grade, bom para muitos leads.

Criar cliente manual

1. Clique em + Novo cliente.
2. Preencha nome e WhatsApp (mínimo).
3. Vincule a um produto (empreendimento ou imóvel) opcionalmente.
4. Salve — ele entra na coluna Novo Lead.

O webhook permite que sistemas externos (ERP, CRM da construtora, planilhas, n8n/Make/Zapier) sincronizem unidades de um empreendimento com a Villari Vita por HTTP POST.

1. Gerar credenciais no painel

1. Faça login como construtora.
2. Acesse o empreendimento em /painel/empreendimentos → aba Unidades.
3. Clique em Drive / CSV (abre o modal "Atualizar unidades").
4. Expanda a seção Receber por Webhook.
5. Clique em Gerar credenciais de Webhook.
6. Copie e guarde:
   • URL do Webhook (ex.: https://www.villarivita.com.br/api/webhook/units/{token})
   • Secret (string de 48 caracteres)

2. Configurar o sistema externo

3. Montar o payload

Mínimo (campos obrigatórios — linhas sem eles são ignoradas):

{
  "units": [
    { "number": "201", "area_m2": 65.5, "price_brl": 350000 }
  ]
}

Completo (todos os campos aceitos):

{
  "units": [
    {
      "block": "A",
      "floor": 2,
      "number": "201",
      "area_m2": 65.5,
      "private_area_m2": 58.0,
      "price_brl": 350000,
      "bedrooms": 2,
      "suites": 1,
      "bathrooms": 2,
      "parking_spaces": 1,
      "storage_count": 1,
      "storage_number": "D-12",
      "status": "AVAILABLE",
      "notes": "Vista para o parque"
    }
  ]
}

Aliases em PT-BR também funcionam: numero, quartos, vagas, preco, area_total, etc. (lista completa na tela de documentação dentro do painel).

4. Status aceitos

O campo status é case-insensitive e aceita: AVAILABLE, RESERVED, SOLD, UNAVAILABLE. Se omitido, assume AVAILABLE.

5. Testar com curl

curl -X POST "https://www.villarivita.com.br/api/webhook/units/SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-webhook-secret: SEU_SECRET" \
  -d '{
    "units": [
      { "number": "TESTE-01", "area_m2": 50, "price_brl": 200000 }
    ]
  }'

6. Respostas

• 200 { "upserted": N, "errors": [] } — sucesso.
• 401 — token ou secret incorreto.
• 422 — payload sem unidades válidas.
• 500 — erro interno.

Comportamentos importantes

• Upsert por chave composta: unidades com mesmo number + floor + block são atualizadas (preço, vagas, depósitos), não duplicadas. Pode reenviar a mesma carga sem medo.
• Formato numérico flexível: aceita 350000 (EN puro) ou "R$ 350.000,00" (BR formatado).
• Sem rate limit hoje, mas dispare em batch ou apenas quando houver mudança real.

A integração com o Sienge sincroniza automaticamente as unidades de um empreendimento direto do ERP, usando a API oficial do Sienge (Bulk Data API v1). A Villari Vita busca as unidades e seus status comerciais de tempos em tempos e mantém o painel atualizado — sem planilha, sem webhook, sem digitação manual.

O que você precisa antes de começar

• Acesso de administrador à plataforma Sienge da sua construtora.
• Permissão para abrir o Painel de Integrações do Sienge (onde ficam as credenciais de API).
• O empreendimento já cadastrado no Sienge, com as unidades e o estoque comercial preenchidos.
• O empreendimento correspondente já criado na Villari Vita (veja Cadastrar empreendimento).

Parte A — O que fazer dentro do Sienge

Todo o passo a passo abaixo acontece na plataforma Sienge, não na Villari Vita.

1. Liberar o módulo de API (se ainda não estiver ativo)

1. Entre no Sienge como administrador.
2. Acesse o menu Integração de Dados → Painel de Integrações (em algumas contas aparece como API Sienge ou Plataforma de Integrações).
3. Se for a primeira vez, o Sienge pode pedir a contratação/ativação do módulo de API. A liberação é feita pelo time do Sienge — abra um chamado com o suporte deles se o painel não estiver disponível.

2. Criar um usuário de API

1. Dentro do Painel de Integrações, vá em Credenciais de API (ou Usuários de API).
2. Clique em Novo / Gerar credencial.
3. Dê um nome que identifique o uso, ex.: Villari Vita.
4. O Sienge vai gerar um par de credenciais:
   • Usuário da API (uma string, ex.: minhaconstrutora-abc123)
   • Senha da API (gerada automaticamente)
5. Copie e guarde a senha agora. O Sienge mostra a senha apenas no momento da criação — depois ela não aparece mais. Se perder, gere uma nova credencial.

3. Anotar o subdomínio

O subdomínio é o identificador da sua construtora no Sienge. É a parte que aparece na URL quando você acessa o sistema:

https://minhaconstrutora.sienge.com.br
                ↑
         este é o subdomínio: "minhaconstrutora"

A API da Villari Vita vai montar a URL no formato api.sienge.com.br/{subdominio}/public/api/v1. Anote exatamente como aparece, sem https:// e sem .sienge.com.br.

4. Descobrir o ID do empreendimento (enterpriseId)

Cada empreendimento no Sienge tem um código numérico. É ele que diz à Villari Vita quais unidades buscar.

1. No Sienge, acesse Cadastros → Empreendimentos (ou Obras / Empreendimentos).
2. Localize o empreendimento que quer sincronizar.
3. Anote o código dele — é um número inteiro (ex.: 42). Costuma aparecer na coluna "Código" da listagem ou no topo da tela de detalhe do empreendimento.

Resumo do que você sai do Sienge com

Parte B — O que configurar na Villari Vita

1. Faça login como construtora.
2. Acesse o empreendimento em /painel/empreendimentos → aba Unidades.
3. Clique em Drive / CSV (abre o modal "Atualizar unidades").
4. Role até a seção ERP Sienge e expanda.
5. Clique em Configurar integração.
6. Preencha o formulário com os dados que você anotou do Sienge:
   • Subdomínio Sienge — ex.: minhaconstrutora
   • Usuário API — o usuário gerado no Painel de Integrações
   • Senha API — a senha gerada na criação da credencial
   • ID do empreendimento (enterpriseId) — o código numérico do empreendimento no Sienge
7. Escolha o Intervalo de sincronização: a cada 6h, 12h ou 24h.
8. Deixe o Status como Ativa.
9. Clique em Testar conexão. A Villari Vita faz uma chamada de teste à API do Sienge sem importar nada. Você deve ver a mensagem verde de conexão OK.
10. Com o teste passando, clique em Salvar.

Como a sincronização funciona

• A Villari Vita verifica as integrações ativas de hora em hora e dispara a sincronização de cada empreendimento conforme o intervalo escolhido (6h/12h/24h desde a última sync).
• Cada sincronização busca todas as unidades e tabelas de preço do empreendimento no Sienge.
• O estoque comercial do Sienge é convertido nos status da Villari Vita: disponível, reservada, vendida ou indisponível.
• O resultado entra como uma importação pendente de revisão — você confere o que vai mudar (criadas, atualizadas, marcadas indisponíveis) e aplica. Nada é alterado no seu painel sem essa confirmação.
• O card ERP Sienge mostra o status da integração, a data da última sincronização, o resumo da última carga e a estimativa da próxima.

Gerenciar a integração depois

No mesmo card ERP Sienge você tem três ações:

• Editar — atualizar subdomínio, usuário, senha, ID do empreendimento ou intervalo.
• Pausar / Reativar — interrompe temporariamente as sincronizações sem perder a configuração.
• Remover — apaga a integração. As unidades já importadas continuam no sistema, mas param de sincronizar.

Status da integração

• Ativa — sincronizando normalmente no intervalo configurado.
• Pausada — configuração mantida, mas sem sincronizações automáticas.
• Erro — a última tentativa falhou. O card mostra a mensagem do erro.

Resolução de problemas