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 /corretor/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 /corretor/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 /corretor/imoveis (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 /corretor/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 /corretor/crm/pipeline — kanban com 7 etapas + Ganhas e Perdidas.
• Ganhas em /corretor/crm/ganhas — negócios fechados.
• Perdidas em /corretor/crm/perdidas — leads encerrados sem fechamento.
• Clientes em /corretor/crm/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.