Usuários, Corretores, Funções e Filiais

Resumo

O Mapaprop permite que cada imobiliária organize sua equipe de trabalho por meio de usuários, funções, filiais e corretores. Cada conta tem um administrador principal e pode incorporar vendedores e corretores conforme o plano contratado.

Com esse sistema você pode:

• Dar acesso a cada membro da equipe com seu próprio usuário e senha.
• Atribuir cada vendedor ou corretor à filial onde trabalha.
• Controlar que cada pessoa gerencie apenas os imóveis da sua filial (os demais são exibidos em modo somente leitura). Mensagens e contatos são exclusivos de cada filial.
• Organizar a estrutura da empresa em múltiplas sedes ou escritórios.
• Gerenciar quem recebe as consultas de cada imóvel publicado.

Os limites de usuários e filiais se aplicam automaticamente ao criar ou reativar pessoas, e são atualizados imediatamente ao trocar de plano.

Tipos de Usuário

Tabela comparativa

Administrador

O administrador é o responsável principal da conta.

• É criado automaticamente quando a conta é registrada no Mapaprop.
• Tem acesso completo a todas as funções: imóveis, mensagens, contatos, filiais, usuários, configuração, faturamento e mais.
• Só pode existir um administrador por conta.
• Não pode ser excluído nem desativado.
• Não ocupa nenhuma cota de usuários do plano.

Vendedor

O vendedor é um membro da equipe criado pelo administrador para atuar dentro de uma filial.

• É criado pelo administrador em Configuração > Usuários.
• Deve sempre ser atribuído a uma filial existente no momento da criação.
• Pode ver todos os imóveis da empresa, mas só pode editar, excluir e publicar os da sua filial. Os imóveis de outras filiais são exibidos em modo somente leitura. Quanto a mensagens e contatos, ele só vê os da sua filial.
• Não pode criar nem editar outros usuários, nem administrar filiais.
• Pode ser desativado e reativado pelo administrador a qualquer momento (sujeito aos limites do plano).
• Ocupa uma cota dentro dos limites do plano.

Corretor

O corretor é um tipo especial de vendedor pensado para corretores independentes que fazem parte da imobiliária.

• É criado pelo administrador em Configuração > Usuários.
• Ao ser criado, é gerada automaticamente uma filial com o seu nome. Não é necessário escolher uma filial existente.
• Sua filial é exclusiva: não pode ser excluída enquanto o corretor existir. Para liberar a filial, primeiro é preciso desativar o corretor.
• Nome e e-mail sincronizados: ao editar um corretor em Configuração > Usuários, o nome e o e-mail são atualizados automaticamente na sua filial. Se o nome mudar, a URL pública da filial também é regenerada. O e-mail da filial do corretor não pode ser editado diretamente na página de filiais; só muda se o usuário corretor for editado.
• Ocupa uma cota no total de vendedores do plano e, além disso, uma cota no total de corretores.
• Disponível a partir do plano Pro+.

Quando um corretor é criado, sua filial começa com dados incompletos. O corretor deve completar seu endereço, telefone e localização antes que imóveis possam ser atribuídos a ele. Enquanto faltarem dados, o sistema exibe o badge "Dados incompletos" na lista de filiais e na lista de usuários.

Funções e Permissões

Administrador — Acesso total

O administrador tem acesso completo a todas as funções do sistema, sem exceção. Ele vê todos os imóveis, mensagens e contatos de todas as filiais. Pode criar, editar e excluir qualquer recurso. Gerencia usuários, filiais, integrações, faturamento e configuração da empresa. Não tem restrições de nenhum tipo.

Vendedor — Acesso detalhado

O vendedor atua dentro da empresa com acesso diferenciado de acordo com a área e a filial. A seguir, detalha-se cada função do sistema.

Convenções da tabela:

• ✅ = Acesso completo
• 👁 = Somente leitura (pode ver, mas não modificar)
• ❌ = Sem acesso

Imóveis

O vendedor vê todos os imóveis da empresa. Os da sua filial ele pode gerenciar completamente. Os de outras filiais ele pode ver e compartilhar, mas não modificar.

Nota visual: Os imóveis de outra filial são exibidos com um badge indigo com o nome da filial. Na ficha do imóvel aparece o indicador "Somente leitura" e os botões de edição ficam ocultos. Se o vendedor tentar acessar diretamente a página de edição de um imóvel de outra filial, o sistema o redireciona automaticamente para a visualização de leitura.

Nota sobre filial: Ao criar ou editar um imóvel, o vendedor tem a filial pré-selecionada e não pode alterá-la. O campo aparece desabilitado com o texto "A filial é atribuída automaticamente à sua filial." O backend também impõe o branchId a partir da sessão como proteção adicional.

Mensagens (Caixa de entrada)

O vendedor só vê as mensagens de consultas sobre imóveis da sua filial.

Contatos (CRM)

O vendedor vê os contatos da sua filial, os que ele mesmo criou, e os contatos históricos sem filial atribuída.

Nota: Os contatos históricos (criados antes do sistema de filiais) aparecem como "Sem filial" e são visíveis para todos os vendedores.

Reservas e Aluguéis por Temporada

Redes Imobiliárias / MLS

Site

Configuração

Suporte

Painel (Dashboard)

Resumo rápido: o que um vendedor NÃO pode fazer

O vendedor nunca pode:

• Gerenciar usuários (criar, editar, desativar, reativar)
• Criar ou editar filiais
• Editar Minha Empresa
• Alterar o plano ou a assinatura
• Conectar contas externas (Zonaprop, MercadoLibre, Instagram)
• Administrar redes imobiliárias
• Configurar serviços de IA ou API Token
• Editar, excluir ou publicar imóveis de outra filial
• Ver mensagens ou contatos de outra filial
• Atribuir filiais a contatos
• Cancelar a conta

Filiais

As filiais permitem organizar o trabalho por sede ou escritório.

• Cada conta tem pelo menos uma filial principal, que é criada automaticamente quando a conta é registrada.
• Podem ser criadas filiais adicionais conforme o plano contratado.
• Todo imóvel deve estar atribuído a uma filial. Ao publicar um imóvel, os dados de contato que o interessado vê no portal são os da filial atribuída a esse imóvel.
• A filial principal não pode ser excluída.

Dados de uma filial

A filial principal e Minha Empresa

A filial principal representa a identidade pública da imobiliária. Seus dados de contato são os que aparecem no portal quando um visitante consulta sobre um imóvel atribuído a essa filial.

Existe uma sincronização automática e bidirecional entre a filial principal e a seção Minha Empresa:

• Se você modificar os dados de Minha Empresa, os dados da filial principal são sobrescritos automaticamente.
• Se você modificar os dados da filial principal, eles são atualizados automaticamente em Minha Empresa (exceto o nome da filial, que é independente).

Isso significa que não é necessário atualizar os dois lugares separadamente: qualquer mudança em um se reflete no outro automaticamente.

Filiais e Notificações

Este é um conceito fundamental para entender como funcionam as consultas dos interessados.

Como chegam as consultas

Quando um visitante vê um imóvel em um portal de publicação e envia uma mensagem de consulta, ocorre o seguinte:

Visitante consulta o imóvel no portal
        |
        v
É gerada uma consulta (lead)
        |
        +----> É enviada ao e-mail da filial atribuída ao imóvel
        |
        +----> É enviada uma cópia ao e-mail do administrador (Minha Empresa)
        |
        +----> Se o e-mail do administrador for o mesmo da filial:
               recebe-se UMA ÚNICA notificação (não é duplicada)
        |
        +----> A mensagem entra na Caixa de Entrada de Mensagens do sistema

Implicações práticas

A filial que você atribui a um imóvel determina quem recebe as consultas desse imóvel. Por isso é importante:

• Manter atualizado o e-mail de cada filial.
• Atribuir corretamente cada imóvel à filial responsável por atendê-lo.
• Completar os dados das filiais de corretores antes de publicar imóveis nelas.

Se a filial tiver um e-mail incorreto ou desatualizado, as consultas não chegarão ao destinatário correto. Elas ficarão apenas na Caixa de Entrada do sistema.

Perfis Públicos de Filiais

Cada filial tem uma URL pública para seu perfil nos portais de publicação: /office/{nome-seo}. Esse perfil mostra os dados de contato, biografia, logo, foto de perfil e listagem de imóveis da filial.

A URL é gerada automaticamente a partir do nome da filial. Se o nome mudar, a URL é regenerada.

Na página do corretor (/broker/{nome-seo}) também é exibida uma seção "Nossa equipe" com os escritórios e corretores que têm imóveis publicados.

Corretores e Suas Filiais

Como funciona um corretor

Ao criar um corretor, o sistema gera automaticamente uma filial com o nome do corretor. Essa filial pertence exclusivamente a ele: só o corretor trabalha nela, e é lá que seus imóveis são atribuídos.

A relação entre o corretor e sua filial tem regras especiais:

• Nome e e-mail sincronizados: o nome e o e-mail do corretor estão vinculados à sua filial. Se o nome do corretor mudar, o nome da filial é atualizado e sua URL pública é regenerada. Se o e-mail do corretor mudar, o e-mail da filial é atualizado automaticamente. Não é possível alterar o e-mail diretamente na página da filial; apenas no perfil do usuário corretor.
• Filial protegida: a filial do corretor não pode ser excluída enquanto o corretor existir. Para liberar a filial, primeiro é preciso desativar o corretor.
• Dados inicialmente incompletos: quando o corretor é criado, sua filial começa apenas com nome e e-mail. O corretor deve completar seu endereço, telefone e localização geográfica antes que imóveis possam ser atribuídos a ele.

Filiais e notificações para corretores

Os imóveis do corretor são atribuídos à sua própria filial. As consultas dos interessados chegam ao e-mail do corretor (que é o e-mail da sua filial). Além disso, o administrador recebe uma cópia. Se o e-mail do corretor coincidir com o do administrador, é enviada apenas uma notificação.

Limites por Plano

A quantidade de usuários e filiais que uma conta pode ter depende do plano contratado. O administrador nunca conta nesses limites.

Tabela de limites

Notas importantes sobre os limites

• O administrador da conta nunca conta nos limites. O indicador na tela, por exemplo "2/3 vendedores", mostra apenas os vendedores ativos.
• Um corretor ocupa uma cota de vendedor e uma cota de corretor ao mesmo tempo. Por exemplo, no Pro+ o limite é de 5 vendedores e 1 corretor: esse corretor ocupa uma das 5 cotas de vendedor mais a única cota de corretor.
• Nos planos Free, Hosting, Website e Plus não há corretores. A função de corretores está disponível a partir do Pro+ em diante.
• No Business e no Business Manager, o limite de corretores é o mesmo que o de vendedores. Não são somados, são compartilhados dentro da mesma cota total. Por exemplo, no Business é possível ter 30 vendedores, 30 corretores, ou qualquer combinação que não ultrapasse 30 no total.
• Os corretores também contam como filiais, porque cada corretor tem sua própria filial. No Pro+, o limite é de 3 filiais, e uma delas pode ser a de um corretor.

Como o indicador é exibido na tela

Em Configuração > Usuários e Configuração > Filiais há um indicador que mostra o uso atual em relação ao limite, por exemplo:

• "2/3 vendedores ativos"
• "2/3 filiais"

Quando o limite é atingido, o botão de adicionar é desabilitado e aparece um link para atualizar o plano.

Criar Usuários

Criar um Vendedor

1. Vá em Configuração > Usuários.
2. Clique em Adicionar Usuário.
3. Selecione a aba Vendedor.
4. Preencha nome, e-mail e senha.
5. Selecione a filial onde o vendedor vai trabalhar.
6. Confirme. O vendedor receberá um e-mail com as instruções de acesso.

Criar um Corretor

1. Vá em Configuração > Usuários.
2. Clique em Adicionar Usuário.
3. Selecione a aba Corretor.
4. Preencha nome, e-mail e senha. Não é necessário escolher filial.
5. Confirme. Será criada automaticamente uma filial com o nome do corretor.
6. O corretor deve completar os dados da sua filial (endereço, telefone, localização geográfica) antes que os imóveis possam ser atribuídos a ele.

A aba Corretor fica desabilitada se o plano não incluir corretores ou se o limite já tiver sido atingido. Só está disponível a partir do plano Pro+.

Enquanto a filial do corretor tiver dados incompletos, o sistema exibe um aviso visível na lista de usuários e na lista de filiais.

Desativar e Reativar Usuários

Desativar um vendedor

Para desativar um vendedor, entre na sua ficha em Configuração > Usuários e pressione o botão Desativar.

• Apenas o administrador pode desativar vendedores.
• Um vendedor desativado não pode fazer login.
• Seus imóveis, mensagens e contatos são mantidos intactos.
• Não é possível desativar o único usuário ativo da conta.
• O vendedor desativado aparece na seção Usuários Desativados, que pode ser expandida na mesma tela de Configuração > Usuários.

Desativar um corretor

Para desativar um corretor, entre na sua ficha em Configuração > Usuários e pressione o botão Desativar Corretor. O sistema pedirá para confirmar a reatribuição da sua filial antes de continuar.

Desativar um corretor também implica liberar sua filial, já que a filial pertence exclusivamente a ele. Ao desativar um corretor, ocorre automaticamente e sem perda de dados o seguinte:

1. Todos os seus imóveis são reatribuídos a outra filial.
2. Todos os seus contatos são reatribuídos à mesma filial de destino.
3. Sua filial é excluída.
4. O corretor fica desativado e não pode fazer login.

Como funciona a reatribuição de acordo com a quantidade de filiais:

• Se a conta tem 2 filiais (a do corretor e a principal): a reatribuição é feita automaticamente para a filial principal. O administrador apenas confirma a ação.
• Se a conta tem 3 ou mais filiais: o administrador escolhe para qual filial serão reatribuídos os imóveis e contatos do corretor antes de confirmar.

O corretor desativado aparece na seção Usuários Desativados da lista de usuários.

Reativar um usuário

Os usuários desativados aparecem na seção Usuários Desativados de Configuração > Usuários. Para reativar um deles, clique no seu nome para abrir sua ficha e pressione o botão Ativar.

• O administrador pode reativar um usuário desativado a qualquer momento.
• Para poder reativá-lo, a quantidade de vendedores ativos não pode ultrapassar o limite do plano vigente naquele momento.
• Se o plano atual não tiver cotas disponíveis, a reativação não será permitida até que uma cota seja liberada ou o plano seja atualizado para um superior.

Usuários Desativados

Os usuários desativados são exibidos em uma seção separada dentro de Configuração > Usuários, chamada Usuários Desativados. Essa seção fica fechada por padrão e pode ser expandida para ver o histórico.

A partir daí o administrador pode:

• Ver todos os usuários que foram desativados.
• Clicar em qualquer usuário para abrir sua ficha e reativá-lo, desde que haja cota disponível no plano.

Os dados dos usuários desativados (imóveis, contatos, mensagens) são sempre preservados. Apenas o acesso ao sistema é bloqueado.

Excluir uma Filial

Ao excluir uma filial que não seja a principal, o sistema reatribui automaticamente seus imóveis, contatos e usuários para outra filial.

• Se a conta tiver exatamente duas filiais (a que está sendo excluída e a principal): o sistema reatribui tudo automaticamente para a principal. Não é necessária nenhuma ação adicional.
• Se a conta tiver três ou mais filiais: o sistema pedirá para escolher para qual filial serão reatribuídos os imóveis e os usuários antes de confirmar a exclusão.
• As filiais de corretores não podem ser destino da reatribuição. O seletor lista apenas filiais regulares (a principal ou filiais sem corretor). O motivo: a filial de um corretor é o espaço privado desse corretor; transferir imóveis ou contatos do cliente para ela mudaria sua titularidade.
• As filiais de corretores não podem ser excluídas diretamente. Para liberar a filial de um corretor, primeiro é preciso desativar o corretor em Configuração > Usuários. Quando o corretor é desativado, a reatribuição ocorre automaticamente como parte do mesmo processo.

A filial principal também não pode ser excluída. Deve sempre existir pelo menos uma filial.

Mudanças de Plano

Upgrade (mudar para um plano superior)

• Os novos limites se aplicam imediatamente.
• A partir desse momento podem ser criados mais usuários e filiais conforme o novo plano.
• Não é necessário fazer login novamente para que a mudança tenha efeito.
• Os usuários desativados não são reativados automaticamente. O administrador deve reativá-los manualmente.

Downgrade (mudar para um plano inferior)

• Se a quantidade de vendedores ativos ultrapassar o limite do novo plano, o sistema desativará automaticamente os vendedores excedentes.
• Os vendedores desativados automaticamente são os mais antigos (os que estão há mais tempo na conta). Os mais recentes permanecem ativos.
• O administrador nunca é desativado por um downgrade.
• Todos os dados dos usuários desativados (imóveis, mensagens, contatos) são preservados.
• O administrador pode escolher quais usuários reativar dentro do novo limite disponível.

Regras Importantes

Perguntas Frequentes

O indicador de usuários em Configuração mostra "2/3 vendedores". O administrador não é contado aí, certo?

Correto. O indicador mostra apenas os vendedores ativos em relação ao limite do plano. O administrador nunca conta.

Temos um corretor que saiu da empresa. Podemos excluir a filial dele?

Para liberar a filial de um corretor, primeiro é preciso desativá-lo em Configuração > Usuários. Ao desativá-lo, o sistema reatribui automaticamente seus imóveis e contatos para outra filial e depois exclui a filial dele. Nenhum dado é perdido.

Ao desativar um corretor, os imóveis dele são perdidos?

Não. Todos os seus imóveis e contatos são reatribuídos automaticamente à filial escolhida pelo administrador (ou à principal se houver apenas duas filiais). Os dados nunca são perdidos.

Se reduzirmos o plano e vendedores forem desativados automaticamente, os imóveis deles são perdidos?

Não. Os dados são preservados. Apenas o acesso desse usuário é bloqueado. O administrador pode reatribuir os imóveis dele a outra filial ou reativá-lo se houver cota disponível.

Podemos ter dois administradores?

Não. Atualmente cada conta tem um único administrador. Para dar acesso amplo a outra pessoa, é possível criar um vendedor. Um vendedor tem acesso a imóveis, mensagens e contatos da sua filial, mas não pode gerenciar usuários nem configurar a conta.

Se melhorarmos o plano, os vendedores desativados são reativados sozinhos?

Não. O upgrade amplia a cota disponível, mas os usuários desativados não são reativados automaticamente. O administrador deve reativá-los manualmente em Configuração > Usuários.

Onde vejo quantos usuários e filiais meu plano tem disponíveis?

Em Configuração > Usuários e Configuração > Filiais é exibido um indicador com o uso atual e o limite do plano, por exemplo "3 / 5 vendedores".

Um corretor pode ter imóveis atribuídos em filiais que não são as dele?

Não. Os imóveis criados por um corretor são atribuídos automaticamente à sua filial. No entanto, o corretor pode ver todos os imóveis da empresa (de qualquer filial) em modo somente leitura: pode consultá-los, compartilhá-los e ver suas estatísticas, mas não pode editá-los nem publicá-los.

Posso reativar um corretor que desativei?

Sim, desde que haja cota disponível no plano. Ao reativá-lo, o corretor fica como vendedor comum atribuído a uma filial existente. Sua filial própria anterior não é recriada automaticamente. Se quiser que ele volte a ter filial própria, é preciso criá-lo novamente como corretor.

Por que não consigo editar o e-mail da filial de um corretor pela página da filial?

O e-mail da filial do corretor está sincronizado com o e-mail do seu usuário. Só pode ser alterado editando o usuário corretor em Configuração > Usuários. Isso garante que o e-mail de notificações do corretor e o da sua filial sempre coincidam.

Se eu mudar o nome do corretor, o nome da filial é atualizado?

Sim. Ao editar o nome do corretor em Configuração > Usuários, o nome da sua filial é atualizado automaticamente. A URL pública da filial também é regenerada para refletir o novo nome.

Para qual e-mail chegam as consultas de um imóvel publicado?

As consultas chegam ao e-mail da filial atribuída ao imóvel. Além disso, o administrador sempre recebe uma cópia. Se o e-mail do administrador for o mesmo da filial, é enviada apenas uma notificação (não é duplicada).

O que acontece se uma filial não tiver e-mail ou tiver um e-mail incorreto?

As consultas dos imóveis atribuídos a essa filial não chegarão por e-mail ao responsável. Elas ficarão disponíveis apenas na Caixa de Entrada de Mensagens do sistema. É importante manter atualizado o e-mail de cada filial.

O que significa o badge "Dados incompletos" em uma filial?

Significa que a filial tem campos obrigatórios não preenchidos: endereço, telefone principal, e-mail ou localização geográfica (país, estado, cidade). Até que esses dados sejam completados, não é recomendável atribuir imóveis a essa filial, já que as notificações e os dados de contato públicos ficarão incompletos.

Se eu modificar Minha Empresa, os dados da filial principal são atualizados?

Sim. Existe uma sincronização automática: as mudanças em Minha Empresa sobrescrevem os dados da filial principal, e as mudanças na filial principal atualizam Minha Empresa. A única exceção é o nome da filial, que não sincroniza com o nome da empresa.

Um vendedor pode ver imóveis de outras filiais?

Sim. O vendedor vê todos os imóveis da empresa, incluindo os de outras filiais. Os imóveis de outras filiais aparecem com um badge da filial e em modo somente leitura: ele pode vê-los, compartilhá-los, enviá-los por e-mail e ver estatísticas, mas não pode editá-los, excluí-los nem publicá-los. Quanto a mensagens e contatos, o vendedor só vê os da sua própria filial.

Quantas pessoas podem acessar o sistema no plano Plus?

No Plus: 1 administrador (que não conta no limite) mais até 3 vendedores. No total, 4 pessoas podem fazer login.

Ajudas relacionadas

• Usuários
• Filiais