Ferramentas · Presença

O módulo Presença pelo assistente: ver a lotação, marcar a chegada e a saída (de você, de um membro ou de um visitante), listar quem está no espaço e o histórico, corrigir ou remover visitas e gerar e revogar os links de quiosque. O quiosque em si é uma tela do visitante no iPad da recepção; o assistente gerencia os links, não opera o quiosque.

Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.

#Em resumo

O espaço se cria com create_space e module: "attendance", com o argumento attendance para a configuração; update_space muda só o que você mandar e mantém o resto.

A equipe, aqui, é o proprietário, o administrador, o moderador e o financeiro; o financeiro lê e marca, mas não gera nem revoga link de quiosque. Os papéis são os das rotas: o assistente nunca faz mais do que a pessoa conectada faria na tela.

#A configuração do espaço

O argumento attendance de create_space e update_space aceita:

#get_attendance_overview

Só consulta

Lotação do espaço. Só o número de pessoas e a lotação (nunca nomes), a visita aberta de quem pergunta e o modo de check-in (off, button ou code). Papel mínimo: qualquer que veja o espaço.

Peça assim: "Quantas pessoas estão na Unidade Centro agora?"

#check_in

Altera

Registrar a chegada. Sem profile_id, é a sua chegada, e só se o espaço deixa o membro marcar (a equipe sempre pode se marcar). Com profile_id, a equipe registra a chegada de outro membro; o membro comum é recusado. Quem não tem acesso ao espaço (plano vencido, grupo fora) é recusado, até pela equipe. É idempotente: com uma visita já aberta, devolve essa visita (already_checked_in: true). Um visitante sem conta é check_guest_in. Papel: qualquer (a sua); moderador ou financeiro (de outro).

Devolve: visit e already_checked_in.

Peça assim: "Registre a minha chegada na Unidade Centro." · "Marque a chegada da Maria no coworking."

#check_out

Altera

Registrar a saída. Sem parâmetros além do espaço, fecha a sua visita aberta. A equipe fecha a de um membro (profile_id) ou qualquer visita aberta (visit_id, de list_present). Sem visita aberta, a resposta é 409. Papel: qualquer (a sua); moderador ou financeiro (de outro).

Peça assim: "Estou saindo."

#list_present

Só consulta

Quem está aqui. As visitas abertas, de membros e de visitantes, da mais nova à mais antiga, com o nome e a hora da chegada, mais a contagem e a lotação. O membro vê só o número, em get_attendance_overview. Papel mínimo: moderador (ou financeiro).

Peça assim: "Quem está na casa agora?"

#list_visits

Só consulta

O histórico. As visitas do espaço, da mais nova à mais antiga: quem, chegada, saída, o tipo (membro ou visitante), se está aberta ou foi fechada automaticamente. O administrador e o proprietário leem qualquer período; o moderador e o financeiro veem só hoje (a API estreita o intervalo). Papel mínimo: moderador (ou financeiro).

Peça assim: "Quantos visitantes vieram na semana passada?"

#list_my_visits

Só consulta

As suas visitas. O seu histórico, da mais nova à mais antiga, com o resumo do mês (visitas, dias e minutos) no fuso da comunidade. Papel mínimo: qualquer.

Peça assim: "Quantos dias eu fui ao coworking neste mês?"

#update_visit

Altera

Corrigir uma visita. Muda a chegada (check_in_at) e/ou a saída (check_out_at). A saída não pode ser antes da chegada nem no futuro; mandar a saída numa visita aberta a fecha. O administrador e o proprietário corrigem qualquer dia; o moderador e o financeiro, só a visita de hoje e com as datas dentro de hoje (ontem devolve 403). A correção entra no registro de atividades com quem a fez. Papel mínimo: moderador (ou financeiro).

Peça assim: "O Pedro esqueceu de marcar a saída: ele saiu às 18h. Feche a visita dele."

#delete_visit

Pede confirmação

Remover uma visita. A visita sai das listas e dos números (uma aberta deixa de contar na lotação) e a remoção entra no registro de atividades. Não apaga o membro. Papel mínimo: administrador.

Devolve: na primeira chamada, o resumo e o código de confirmação.

#check_guest_in

Altera

Registrar um visitante. A equipe registra a chegada de quem não tem conta, com o membro que o recebe (o anfitrião, que precisa ter acesso ao espaço). A empresa e o telefone são pedidos ou recusados conforme a configuração do quiosque. É idempotente por nome e anfitrião: com a visita aberta, devolve already_checked_in: true. Se o espaço avisa os anfitriões, ele recebe um e-mail. O visitante conta na lotação. Papel mínimo: moderador (ou financeiro).

Peça assim: "Registre o visitante Pedro Alves, da Acme, que veio ver a Ana."

#list_attendance_kiosks

Só consulta

Os quiosques. Os aparelhos do espaço, ativos e revogados: nome, quem criou, quando, o último uso e o estado. Nunca o link, que só aparece quando é criado. Papel mínimo: moderador (ou financeiro).

#create_attendance_kiosk

Altera

Gerar o link de um quiosque. Um por iPad ou local. Devolve kiosk, a url e um warning: a URL aparece uma única vez e é secreta, como uma senha. Quem a tem registra visitantes. O assistente pede à pessoa para abri-la no aparelho e não compartilhá-la; se perder, é revogar e gerar outra. Papel mínimo: moderador (proprietário, administrador ou moderador; o financeiro não).

Peça assim: "Gere o link do quiosque do iPad da recepção da Unidade Centro."

#revoke_attendance_kiosk

Pede confirmação

Revogar um quiosque. O link para de funcionar na hora e não volta (gere outro). As visitas já registradas ficam. Papel mínimo: moderador (proprietário, administrador ou moderador).

Devolve: na primeira chamada, o resumo (o nome e o último uso do aparelho) e o código de confirmação.

#Relacionados

• Presença
• Ferramentas
• Dinheiro e confirmação
• Receitas