Hospedes
O que e o Diretorio de Hospedes
O Diretorio de Hospedes e o cadastro central de todas as pessoas que ja se hospedaram ou estao cadastradas nas suas propriedades. Ele funciona como um CRM hoteleiro, armazenando informacoes de contato, historico de estadias, preferencias e status VIP.
Cada hospede pertence ao tenant (conta) e pode ter reservas em qualquer propriedade dentro dessa conta. O cadastro e compartilhado entre propriedades — ou seja, se um hospede se hospedou no Hotel A e depois no Hotel B (da mesma rede), ele aparece como um unico registro.
Acessando o Diretorio
Acesse Menu lateral → Hospedes para visualizar a lista completa de hospedes cadastrados.
Informacoes na listagem
| Coluna | Descricao |
|---|---|
| Nome | Nome completo do hospede |
| Endereco de e-mail principal | |
| Telefone | Numero de telefone |
| Estadias | Quantidade de estadias registradas |
| VIP | Indicador de status VIP (badge colorido) |
| Verificado | Badge indicando se o hospede confirmou seus dados |
| Ultima estadia | Data do ultimo check-out |
Busca e Filtros
O diretorio oferece busca e filtros avancados para localizar hospedes rapidamente:
Busca por texto
Digite no campo de busca para encontrar hospedes por:
- Nome (busca parcial — “Maria” encontra “Maria Silva” e “Ana Maria”)
- Telefone
- Ultimos 6 digitos do documento
Filtros disponiveis
| Filtro | Opcoes |
|---|---|
| Status VIP | Todos, Apenas VIP, Silver, Gold, Platinum |
| Verificado | Todos, Verificados, Nao verificados |
| Nacionalidade | Lista de paises |
| Numero de estadias | Faixa (ex: 1-5, 6-10, 10+) |
| Ultima estadia | Intervalo de datas |
| Tags | Filtra por tags atribuidas (ex: business, repeat, group-leader) |
Dica: Combine filtros para segmentar hospedes. Por exemplo: VIP Gold + mais de 5 estadias + ultima estadia nos ultimos 6 meses = seus melhores clientes ativos.
Criar um Novo Hospede
Para cadastrar um hospede manualmente:
- Acesse Hospedes → Novo Hospede (botao no canto superior direito)
- Preencha os campos obrigatorios e opcionais:
Campos do cadastro
| Campo | Obrigatorio | Descricao |
|---|---|---|
| Nome completo | Sim | Nome e sobrenome do hospede |
| Nao | Endereco de e-mail para comunicacao | |
| Telefone | Nao | Numero com DDD e codigo do pais |
| Tipo de documento | Nao | CPF, RG, Passaporte, DNI, CC ou Outro |
| Numero do documento | Nao | Numero do documento selecionado |
| Pais do documento | Nao | Pais emissor (codigo ISO) |
| Validade do documento | Nao | Obrigatorio para passaportes |
| Data de nascimento | Nao | Para calculo de idade e deteccao de menor |
| Nacionalidade | Nao | Pais de origem do hospede |
| Endereco | Nao | Rua, numero, complemento, bairro, cidade, estado, CEP, pais |
| Contato de emergencia | Nao | Nome, telefone e relacao com o hospede |
- Clique em Salvar
Nota: Hospedes tambem sao criados automaticamente quando fazem uma reserva pelo motor de reservas (Guest Booking Portal). Nesse caso, o cadastro ja vem marcado como verificado.
Importante: Documentos de identificacao sao armazenados com criptografia AES-256 via AWS KMS. Apenas os ultimos 6 digitos ficam visiveis para consulta rapida na interface.
Detalhes do Hospede
Ao clicar em um hospede na lista, voce acessa o perfil completo com as seguintes secoes:
Informacoes pessoais
Todos os dados cadastrais (nome, contato, documento, endereco). O botao Editar permite atualizar qualquer campo.
Historico de estadias
Tabela cronologica com todas as reservas do hospede:
| Coluna | Descricao |
|---|---|
| Propriedade | Onde a estadia ocorreu |
| Unidade | Quarto/cama utilizado |
| Check-in | Data de entrada |
| Check-out | Data de saida |
| Valor total | Valor pago pela estadia |
| Status | Confirmada, Concluida, Cancelada, No-show |
Preferencias
Informacoes sobre as preferencias do hospede, registradas pela equipe ou informadas pelo proprio hospede:
- Tipo de quarto preferido
- Andar preferido
- Configuracao de cama (casal, solteiro, etc.)
- Restricoes alimentares
- Necessidades de acessibilidade
- Solicitacoes especiais recorrentes
Status VIP
Se o hospede for VIP, exibe o nivel (Silver, Gold ou Platinum) e os beneficios associados. Veja mais em Gestao VIP.
Consentimento LGPD
Indicadores de consentimento:
- Data do consentimento
- Tipo de consentimento (completo, marketing ou essencial)
- Link para revogar/atualizar consentimento
Editar Informacoes do Hospede
- Acesse o perfil do hospede
- Clique em Editar
- Modifique os campos desejados
- Clique em Salvar
Todas as alteracoes sao registradas no log de auditoria com:
- Quem alterou
- Quando alterou
- Quais campos foram modificados (valores anterior e novo)
Atenção: Alteracoes em documentos de identificacao requerem permissao de nivel Admin.
Mesclar Hospedes Duplicados
E comum que o mesmo hospede seja cadastrado mais de uma vez (por exemplo, uma vez pelo motor de reservas e outra manualmente pela recepcao). O Opero oferece uma funcionalidade de merge para unificar esses registros.
Como funciona o merge
- Acesse o perfil de um dos hospedes duplicados
- Clique em Acoes → Mesclar com outro hospede
- Busque e selecione o hospede duplicado
- O sistema exibe uma comparacao lado a lado dos dois registros
- Escolha qual informacao manter para cada campo divergente
- Confirme a mesclagem
O que acontece apos o merge
- O hospede secundario e marcado como
mergedIntoId(referencia ao registro principal) - Todas as reservas do secundario sao reatribuidas ao registro principal
- Estatisticas (numero de estadias, total gasto) sao somadas
- O registro secundario nao e deletado fisicamente — ele fica inativo e marcado como mesclado
- A operacao e registrada no log de auditoria
Importante: O merge e irreversivel. Revise cuidadosamente a comparacao antes de confirmar.
Dica: O sistema pode sugerir hospedes possivelmente duplicados com base em nome similar, e-mail ou documento. Fique atento as notificacoes de “possivel duplicata”.
Badge de Verificacao
O badge de verificacao indica que o hospede confirmou seus dados pessoais. Existem quatro canais de verificacao:
| Canal | Descricao |
|---|---|
| Hospede clicou no link magico enviado por e-mail | |
| SMS | Hospede digitou o codigo de 6 digitos recebido por SMS |
| Self-service | Hospede se cadastrou pelo motor de reservas (auto-verificado) |
| Legacy | Migrado de sistema anterior (marcado manualmente) |
Por que a verificacao importa
- Seguranca: Garante que os dados de contato sao reais
- Comunicacao: E-mails e SMS so sao enviados para contatos verificados
- Confiabilidade: Reservas de hospedes verificados tem menor risco de no-show
- LGPD: A verificacao ajuda a comprovar que o hospede e o titular dos dados
Fluxo de verificacao
- Equipe cria o hospede (via dashboard ou API) → status: Nao verificado
- Sistema envia link magico (e-mail) ou codigo (SMS)
- Hospede confirma → status: Verificado (com data e canal registrados)
Hospedes que se cadastram diretamente pelo motor de reservas ja nascem verificados (canal “self”).
Menores de Idade
O Opero trata menores de idade com protecoes especiais em conformidade com a LGPD:
- O campo Data de nascimento determina automaticamente se o hospede e menor
- Menores devem ter um responsavel legal vinculado (campo
parentGuardianId) - O consentimento de dados do menor deve ser registrado pelo responsavel
- Comunicacoes de marketing NAO sao enviadas para menores
Vincular responsavel
- Acesse o perfil do hospede menor
- Na secao “Responsavel Legal”, clique em Vincular
- Busque e selecione o responsavel (que deve ser um hospede adulto cadastrado)
- Confirme o vinculo
Tags
Tags sao rotulos livres que voce pode atribuir a hospedes para segmentacao:
Exemplos de tags comuns:
business— viajantes corporativosrepeat— hospedes recorrentesgroup-leader— lider de grupo/excursaoearly-bird— costuma reservar com antecedencialast-minute— reservas de ultima horaevento-2026— participante de evento especifico
Como usar tags
- Acesse o perfil do hospede
- Na secao “Tags”, digite a nova tag e pressione Enter
- Para remover, clique no X ao lado da tag
Tags podem ser usadas como filtro na listagem de hospedes e em segmentacoes para campanhas de marketing (via OCP).
Estatisticas do Hospede
O perfil exibe metricas automaticas que ajudam a entender o valor do hospede:
| Metrica | Descricao |
|---|---|
| Total de estadias | Numero de reservas concluidas (check-out realizado) |
| Total gasto | Soma de todas as diarias + servicos consumidos |
| Ultima estadia | Data do check-out mais recente |
Essas metricas sao atualizadas automaticamente a cada check-out e sao utilizadas internamente para:
- Calculo de elegibilidade VIP
- Segmentacao de campanhas
- Relatorios de receita por hospede
Quem pode gerenciar hospedes
| Papel | Permissoes |
|---|---|
| Admin | Tudo: criar, editar, mesclar, deletar, alterar VIP, gerenciar documentos |
| Operacional | Criar, editar dados basicos, visualizar historico |
| Financeiro | Apenas visualizar (para consulta de cobrancas) |
Integracao com outros modulos
- Reservas → Toda reserva referencia um hospede cadastrado
- Motor de Reservas (GBP) → Criacao automatica de hospedes verificados
- Financeiro → Contas a receber vinculadas ao hospede
- OCP (Comunicacao) → Envio de e-mails e WhatsApp para hospedes verificados
- Governanca → Preferencias do hospede informam prioridade de limpeza
- Dashboard → Metricas de hospedes ativos, novos e recorrentes