# Presença

> O espaço de check-in e check-out do espaço físico (coworking, sede, escritório): o membro marca Cheguei e Fui embora, a equipe vê quem está aqui e registra visitantes, e o quiosque do iPad na recepção recebe o visitante sem login. Lotação, histórico, saída automática, e-mail ao residente e dados pessoais.

O módulo **Presença** registra **quem está no espaço físico agora e quem passou por ele**, sejam membros ou visitantes. É o caderno da recepção dentro da Memberfy: o membro marca a própria chegada, a equipe marca a de quem esqueceu e registra os visitantes, e o visitante se anuncia sozinho num **quiosque** (um iPad ou tablet na entrada), sem criar conta.

Cada espaço Presença é **uma unidade física**. Um coworking com duas casas cria dois espaços, cada um com a sua lotação, a sua lista, os seus quiosques e o seu histórico.

> [!NOTE]
> A Presença é **registro**, não controle de acesso: não abre porta, não usa localização nem foto e não prova que a pessoa está mesmo no local. Para jornada de trabalho, use um sistema de ponto.

## Para que serve

| Comunidade | Presença |
|---|---|
| Coworking | A recepção vê quem está na casa, os residentes marcam a chegada e os convidados se anunciam no iPad |
| Sede de associação | A diretoria sabe quantas pessoas vieram na semana e em que dia a casa lota |
| Escritório de empresa | Quem está no andar hoje, sem caderno |
| Espaço de eventos | Entrada e saída de quem usa a sala, com a lotação à vista |

## Como funciona

### O que o espaço guarda

Cada **visita** tem a chegada, a saída (enquanto não sai, está "aqui agora"), quem é (membro ou visitante) e como foi marcada: pela equipe, pelo próprio membro, pelo quiosque ou pela saída automática. Visita de visitante guarda ainda o nome, a empresa e o telefone (conforme a configuração) e o **anfitrião**, o membro que ele veio ver.

Todo horário é lido no **fuso do país da comunidade**: "hoje" e "das 9h" são da casa, não do navegador de quem olha.

### A configuração do espaço

Na criação do espaço, e depois em **Configurar espaço** (barra **Gerenciar presença**), a tela pede estes três campos:

| Campo | O que faz | Padrão |
|---|---|---|
| **Quem marca a chegada** | **Só a equipe**: os membros veem a lotação e o próprio histórico, e a equipe marca. **Os membros, com um botão**: o membro toca em **Cheguei** e **Fui embora**. Vale a palavra dele, e a tela avisa que não há prova de que esteja mesmo no local | Só a equipe |
| **Lotação (opcional)** | Máximo de pessoas ao mesmo tempo, de 1 a 100000. Aparece como "32 de 60". É informativa: **nunca impede um check-in**. Conta membros e visitantes | Sem limite |
| **Saída automática às** | O horário, no fuso da comunidade, em que toda visita ainda aberta é fechada (ver [Saída automática](#saida-automatica)) | 23:59 |

No assistente de criação e em **Configurar espaço**, a seção **Quiosque de convidados** traz mais quatro ajustes (também por [assistente](/mcp/ferramentas-presenca) ou API, campo `moduleConfig.attendance`):

| Campo | O que faz | Padrão |
|---|---|---|
| **Empresa do convidado** | Se o quiosque e o registro pela equipe perguntam a empresa: **Não perguntar**, **Opcional** ou **Obrigatório** | Não perguntar |
| **Telefone do convidado** | O mesmo, para o telefone. O nome é sempre obrigatório | Não perguntar |
| **Avisar quem foi visitado** | Liga e desliga o [e-mail ao residente](#e-mail-ao-residente) na chegada do visitante | Ligado |
| **Voltar à tela inicial após (segundos)** | De 5 a 60 segundos até o quiosque voltar sozinho ao começo, depois da confirmação ou da inatividade | 10 |

### Quem faz o quê

| Ação | Membro | Financeiro | Moderador | Administrador e proprietário |
|---|---|---|---|---|
| Ver a lotação (só o número) e o próprio estado | Sim | Sim | Sim | Sim |
| **Cheguei** e **Fui embora** de si mesmo (se o espaço permite) | Sim | Sim | Sim | Sim |
| Ver **quem está aqui**, com nome | Não | Sim | Sim | Sim |
| Marcar chegada e saída de **qualquer membro** e de **visitante** | Não | Sim | Sim | Sim |
| Corrigir os horários de uma visita | Não | Só as de hoje | Só as de hoje | Qualquer dia |
| Ver o histórico do espaço | Não | Só o de hoje | Só o de hoje | Completo, com filtro de datas |
| **Remover** uma visita | Não | Não | Não | Sim |
| Ver a lista de aparelhos de quiosque | Não | Sim, sem o link | Sim | Sim |
| **Gerar** e **revogar** o link do quiosque | Não | Não | Sim | Sim |
| Configurar o espaço | Não | Não | Não | Sim |

A equipe, neste módulo, é o **proprietário, o administrador, o moderador e o financeiro**. Quem entra no espaço segue a regra de qualquer espaço: visibilidade, plano e grupo. **Quem não tem acesso ao espaço não faz check-in, e a equipe também não o marca**: a mensagem diz o motivo (plano vencido, grupo fora).

### O que o membro vê

O espaço abre na aba **Presença**:

- o estado dele: *"Você está aqui desde 09:12"* ou *"Você não fez check-in"*;
- o botão **Cheguei** (ou **Fui embora**), se o espaço deixa o membro marcar. Se não deixa, a tela diz *"O check-in aqui é feito pela equipe, na recepção."*;
- a **lotação**, sem nomes: *"32 de 60"* ou *"32 aqui agora"*. Sem ninguém: *"Seja o primeiro a fazer check-in"*.

Na aba **Meu histórico** ficam as visitas dele, por dia, com a chegada e a saída, e o resumo de **Este mês**: visitas, dias diferentes e tempo aqui. O membro nunca vê o nome de outro membro.

### O que a equipe vê

Além das duas abas do membro, a equipe tem **Quem está aqui**, **Histórico** e **Quiosque**.

- **Quem está aqui** lista as visitas abertas de membros e de visitantes (nome, foto ou iniciais, desde quando e, no visitante, o anfitrião), com busca por nome e o contador. Dali a equipe **marca a chegada** de um membro (busca por nome), **marca a chegada de um visitante**, **marca a saída** com um toque, **corrige os horários** e, administrador e proprietário, **remove** a visita.
- **Histórico** lista as visitas do espaço, com filtros por **Quem** (membros, visitantes), **Estado** (aqui agora, encerradas) e datas. Moderador e financeiro veem só as de hoje; administrador e proprietário veem qualquer período.

Visita fechada pela saída automática aparece marcada como **Saída automática** e **não entra na permanência média**. Corrigir o horário de uma delas faz da saída uma marcação da equipe.

### Visitante registrado pela equipe

Na aba **Quem está aqui**, **Marcar visitante** abre um formulário para quem não tem conta: **nome**, **empresa** e **telefone** (conforme a configuração) e **quem o visitante veio ver**, o anfitrião, que precisa ser um membro com acesso ao espaço. O visitante entra na lista e na lotação, e o anfitrião recebe o [e-mail](#e-mail-ao-residente) se o espaço avisa. Registrar de novo o mesmo nome com o mesmo anfitrião, enquanto a visita está aberta, não duplica: a tela diz que o visitante já estava com check-in.

### O quiosque

O **quiosque** é uma tela pública para o iPad ou tablet da recepção. Ele funciona **sem login de pessoa**, mas **só em um aparelho autorizado**: o acesso é um **link secreto**, um por aparelho, que a equipe gera e pode revogar a qualquer momento. Sem o link, o quiosque não mostra nada, e a busca de residentes nunca fica aberta na internet.

O quiosque ocupa a tela inteira, sem menu, sem login e sem navegação, com o logo e as cores da comunidade e no idioma do aparelho.

**O membro não marca presença no quiosque.** Ele é só do visitante: deixar o membro "buscar o próprio nome" numa tela pública permitiria marcar por outra pessoa e exigiria listar todos os residentes. O membro marca pelo botão do app (se o espaço deixa) ou pede à equipe.

**Chegada do visitante:**

1. Na tela inicial, toca em **Sou visitante: fazer check-in**.
2. Digita o **nome completo** (e a empresa e o telefone, se o espaço pede).
3. Procura **quem veio ver**: a busca começa com **3 letras**, encontra pelo **início de qualquer palavra** do nome ("Silva" acha "João Silva") e mostra **no máximo 8 pessoas**, só com nome e foto ou iniciais, nunca e-mail, telefone, papel ou plano. Só aparece quem tem acesso ao espaço.
4. Lê o aviso de privacidade e toca em **Confirmar**: *"Maria Souza veio ver João Lima"*.
5. A tela diz *"Bem-vindo, Maria!"* e, quando o aviso ao anfitrião saiu, que **o anfitrião foi avisado** (se o aviso está desligado ou passou do teto, essa frase não aparece). Depois **volta sozinha ao início**. Se alguém parar no meio, ela também volta e **apaga o que foi digitado**.

**Saída do visitante:**

1. Na tela inicial, toca em **Estou saindo: fazer check-out**.
2. A tela lista só os **visitantes com check-in aberto hoje**, com o nome abreviado ("Maria S.") e a hora da chegada, e tem um **campo de busca** para filtrar pelo nome.
3. O visitante toca na própria linha e confirma (*"Fazer o check-out de Maria S.?"*). A tela volta ao início.

O quiosque **não mostra quem mais está na casa**: nem membros, nem visitantes que já saíram, nem anfitrião, empresa ou telefone de ninguém.

> [!WARNING]
> Quem tem o link do quiosque registra visitantes e vê os nomes abreviados dos visitantes de hoje. Trate-o como uma senha.

## Passo a passo

### Criar o espaço

*Papel: proprietário ou administrador.*

1. Em **Adicionar Espaço**, abra a aba **Coworking** e escolha o módulo **Presença**.
2. Em **Quem marca a chegada**, escolha **Só a equipe** ou **Os membros, com um botão**.
3. Se quiser, preencha a **Lotação** e ajuste a **Saída automática às**.
4. Defina a visibilidade e crie o espaço. Para uma segunda unidade, crie um segundo espaço.

Para mudar a configuração depois, use **Configurar espaço** na barra **Gerenciar presença**.

### Marcar Cheguei e Fui embora

*Papel: qualquer membro, se o espaço permite.*

1. Abra o espaço **Presença**.
2. Toque em **Cheguei**. A tela passa a mostrar *"Você está aqui desde 09:12"*.
3. Ao sair, toque em **Fui embora**. A visita fecha com a duração.

Tocar em **Cheguei** duas vezes não cria duas visitas.

### Marcar a chegada de um membro

*Papel: equipe (proprietário, administrador, moderador ou financeiro).*

1. Na aba **Quem está aqui**, toque em **Marcar chegada**.
2. Busque o membro pelo nome (2 letras ou mais) e toque nele em **Fazer check-in**.
3. Para a saída, toque em **Marcar saída** na linha dele.

### Corrigir os horários

*Papel: equipe. Moderador e financeiro só as visitas de hoje; administrador e proprietário, qualquer dia.*

1. Na linha da visita, escolha **Corrigir horários**.
2. Ajuste o dia e o horário da **Chegada** e da **Saída** (no relógio da comunidade). Para encerrar uma visita aberta, preencha a saída.
3. Toque em **Salvar**. A saída não pode ser antes da chegada nem no futuro, e a correção entra no [registro de atividades](/membros/registros-de-atividades) com quem a fez.

### Remover uma visita

*Papel: proprietário ou administrador.*

Na linha da visita, **Remover visita** e **Remover** para confirmar. A visita sai das listas e dos números, e a remoção fica no registro de atividades. Isso não apaga o membro.

### Registrar um visitante pela equipe

*Papel: equipe.*

1. Na aba **Quem está aqui**, toque em **Marcar visitante**.
2. Preencha o nome (e a empresa e o telefone, se o espaço pede) e busque o anfitrião.
3. Toque em **Fazer check-in do visitante**.

### Gerar o link do quiosque

*Papel: proprietário, administrador ou moderador.*

1. Na aba **Quiosque**, dê um nome ao aparelho (por exemplo, *"Tablet da recepção"*) e toque em **Gerar link**.
2. A tela mostra o link **uma única vez**, com o botão **Copiar** e o aviso de que ele é secreto. Copie e toque em **Concluir**.
3. Abra o link no iPad ou tablet da recepção. O aparelho guarda a autorização, tira o código do endereço da tela e, nas próximas vezes, entra direto no quiosque. Recarregar a página mantém o quiosque.

Se perder o link, **revogue o aparelho e gere outro**: a Memberfy guarda só uma impressão do código, nunca o link. Crie um link por aparelho ou local; não há limite.

**No iPad**, deixe o quiosque como um aplicativo: com o link aberto no Safari, toque em **Compartilhar** e em **Adicionar à Tela de Início**. O ícone abre o quiosque em tela cheia. Para o iPad não sair do quiosque, ligue o **Acesso Guiado** (**Ajustes** › **Acessibilidade**).

### Ver e revogar os aparelhos

*Papel: ver a lista, toda a equipe (o financeiro sem o link); revogar, proprietário, administrador ou moderador.*

A aba **Quiosque** lista cada aparelho com o nome, quem o criou, o **último uso** (ou *"Nunca usado"*) e o estado, **Ativo** ou **Revogado**. Um uso estranho (um aparelho que ninguém deveria ter) é motivo para revogar.

1. Na linha do aparelho, toque em **Revogar**.
2. Confirme em **Revogar**.

A revogação vale **na hora**: o próximo toque do aparelho mostra *"Aparelho não autorizado. Peça um novo link à equipe."* As visitas já registradas continuam como estão. Não dá para reativar um link revogado: gere outro.

## E-mail ao residente

Quando o visitante faz check-in (pelo quiosque ou pela equipe), o **anfitrião** recebe um e-mail: *"Maria Souza chegou para ver você"*, com o nome, a empresa (se informada), a hora da chegada e a unidade. O telefone do visitante não vai no e-mail.

- A hora sai **no fuso da comunidade**, no idioma do residente.
- O e-mail vai por uma **fila**: o visitante não espera o envio.
- Há um **teto de 10 e-mails por hora para cada anfitrião**, para ninguém usar o quiosque como disparador de spam. Passando do teto, a visita é registrada normalmente e o e-mail não sai.
- Dá para desligar o aviso na configuração do espaço (ver [A configuração do espaço](#a-configuracao-do-espaco)).

Check-in e check-out de membro não geram e-mail nem aviso.

## Saída automática

Para uma visita esquecida aberta não virar uma permanência de 40 horas, o sistema confere **de 15 em 15 minutos** todas as visitas abertas, de membros e de visitantes. Passou o horário de **Saída automática às** (no fuso da comunidade), a visita é fechada com a saída nesse horário do dia da chegada. Se a chegada foi depois dele, fecha no fim daquele dia.

A visita fechada assim vem marcada como **Saída automática**, não conta na permanência média e não gera aviso. O proprietário ou o administrador pode corrigir a saída; a equipe, as de hoje.

## Dados e privacidade

A Presença guarda **onde e quando uma pessoa esteve** (membro) e **o nome, e se o espaço pedir a empresa e o telefone, de um visitante que não tem conta**. É dado pessoal. O que vale:

- **A comunidade é a controladora dos dados**; a Memberfy é a operadora. Cabe à comunidade definir a finalidade, e atender o pedido de quem quiser saber o que foi guardado.
- **Nada é apagado.** As visitas de membros e de visitantes ficam guardadas. Remover uma visita a tira das listas e dos números, e a remoção fica no registro de atividades.
- **Sem localização, foto, documento ou biometria.** A empresa e o telefone são opcionais, conforme a configuração.
- **Quem vê o quê**: o membro vê só as próprias visitas e a lotação; a equipe vê quem está aqui; o histórico completo é do proprietário e do administrador. O quiosque mostra só os visitantes com check-in aberto de hoje, com nome abreviado.
- **O aviso no quiosque**: antes de confirmar, o visitante lê que o nome e os dados informados são registrados para a visita e que ficam guardados.
- **Os residentes** podem ter o nome mostrado na busca de anfitrião do quiosque (só nome e foto, de quem tem acesso ao espaço).

> [!TIP]
> Convém **afixar um aviso na recepção**, perto do iPad, dizendo o que a comunidade decidir, por exemplo que os visitantes são registrados e que os dados ficam com a comunidade, e avisar os residentes de que o nome deles pode aparecer na busca do quiosque. A Memberfy não substitui a orientação jurídica da sua comunidade.

## Exemplos

**Coworking com recepção.** Espaço **Presença · Unidade Centro**, lotação de 60, **Só a equipe** marca. A recepção abre **Quem está aqui** e registra os residentes que chegam. Um iPad na entrada roda o quiosque: o convidado digita o nome, procura a residente que vai visitar e a residente recebe o e-mail. Às 23:59 o sistema fecha o que ficou aberto.

**Associação com botão.** Espaço **Sede**, **Os membros, com um botão**. Cada associado toca em **Cheguei** ao entrar. A diretoria olha o **Histórico** de um mês e vê em que dias a sede lota.

**Duas casas.** Dois espaços, **Presença · Centro** e **Presença · Zona Sul**, cada um com o seu quiosque. O mesmo membro pode ter uma visita aberta em cada uma.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *O check-in pelo próprio membro não está ativado neste espaço. Peça à equipe para marcar a sua chegada.* | O espaço está como **Só a equipe**: peça à recepção, ou troque para **Os membros, com um botão** |
| *Você não pode fazer check-in aqui porque não tem acesso a este espaço.* | Confira o plano, o grupo e a visibilidade do espaço |
| *Este membro não pode ser marcado porque não tem acesso a este espaço (plano vencido ou grupo fora).* | Regularize o acesso do membro antes de marcá-lo |
| *Não há visita aberta para marcar a saída* | A pessoa já saiu (ou foi fechada pela saída automática). Veja o **Histórico** |
| *A saída não pode ser antes da chegada.* / *A data não pode estar no futuro* | Corrija o horário informado |
| *Só owner ou admin corrige a visita de outro dia* | Peça ao proprietário ou ao administrador |
| *Este aparelho não está mais autorizado* | O link foi revogado: gere outro na aba **Quiosque** |
| *Este aparelho ainda não tem um link. Abra o link do quiosque que a equipe gerou.* | Abra, no aparelho, o link completo que a equipe copiou |
| *Muitas tentativas. Tente de novo em N segundos.* | Espere o tempo indicado |
| *Ninguém encontrado. Tente outras letras.* (anfitrião) | O residente precisa ter acesso ao espaço; tente o início do nome |

## Perguntas frequentes

**O visitante precisa de conta?**
Não. Ele se anuncia no quiosque, ou a equipe o registra, só com o nome (e a empresa e o telefone, se o espaço pede).

**O membro pode usar o quiosque?**
Não. O membro marca pelo botão **Cheguei** (se o espaço deixa) ou pede à equipe.

**Perdi o link do quiosque. Dá para ver de novo?**
Não: ele aparece uma vez. Revogue o aparelho e gere outro.

**A lotação impede alguém de entrar?**
Não. Ela é informativa; o check-in continua liberado depois de lotar, e a tela avisa que a lotação foi atingida.

**Posso ter mais de um quiosque?**
Sim, um por aparelho ou local, sem limite.

**Moderador e financeiro podem corrigir o histórico?**
Só as visitas de hoje. Remover e corrigir qualquer dia é do proprietário e do administrador.

**A Presença serve para controlar a jornada de trabalho?**
Não. É registro de presença e de lotação, sem espelho de ponto.

**O visitante recebe algum e-mail?**
Não: quem recebe é o anfitrião.

## Pelo assistente

O assistente mostra a lotação, marca chegada e saída (de si, de um membro ou de um visitante), lista quem está aqui e o histórico, corrige e remove visitas e gerencia os links de quiosque. Ver [Ferramentas · Presença](/mcp/ferramentas-presenca).

## Na API

Com `X-CommunityId` no cabeçalho: `GET /api/attendance/spaces/{spaceId}/overview` (lotação e a visita aberta de quem pergunta), `POST .../check-in`, `POST .../check-out`, `POST .../guest-check-in`, `GET .../present`, `GET .../visits`, `GET /api/attendance/me/visits`, `PATCH` e `DELETE /api/attendance/visits/{visitId}`, e os aparelhos em `GET`, `POST` e `DELETE .../kiosks`. O quiosque chama `/api/attendance/kiosk/*` (`session`, `hosts`, `check-in`, `open`, `check-out`) com o cabeçalho `X-Kiosk-Token`, sem `X-CommunityId`. A referência completa, gerada da API, aparece em [Referência da API](/api/introducao) quando a Presença chegar às comunidades.

## Relacionados

- [Módulos](/conceitos/modulos)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)
- [Visibilidade e acesso](/conceitos/visibilidade-e-acesso)
- [Registros de atividades](/membros/registros-de-atividades)
- [Criar e organizar espaços](/espacos/criar-e-organizar-espacos)