App de leitura e equipa de controlo

À porta, os bilhetes são lidos com um telemóvel. Este artigo explica o que faz a app de leitura, como a instalar num dispositivo Android ou num iPhone, como dar a alguém permissão para ler bilhetes, e o que dizer ao visitante cujo bilhete aparece como "inválido". No fim deste artigo terá um dispositivo a funcionar na sua entrada e saberá quem o pode utilizar.

O que faz exatamente a app de leitura?

Cada bilhete tem um código QR: aquele padrão de quadradinhos que também se vê num bilhete de comboio ou num pacote de café. Nesses quadradinhos esconde-se um código longo e único — uma espécie de número de série que só existe uma vez.

A app de leitura faz exatamente uma coisa com ele. Aponta-se a câmara do telemóvel para o código QR, a app lê o código e, em menos de um segundo, indica se essa pessoa pode entrar. Nada mais. Não há preços, nem volume de negócios, nem números de vendas — quem está à porta não precisa de ver isso e, por isso, não tem acesso a essa informação.

Depois de uma leitura válida, o bilhete fica utilizado. Quem apresentar o mesmo bilhete uma segunda vez — por exemplo, porque o reencaminhou para um amigo — recebe uma mensagem a indicar que já entrou.

Os termos técnicos deste artigo também constam do glossário.

O que precisa antes de começar

• Um telemóvel ou tablet com câmara, um por entrada: um iPhone ou iPad com iOS 15.5 ou posterior, ou um dispositivo Android com Android 6.0 ou posterior.
• A função Proprietário no painel, para convidar alguém para ler bilhetes. Só um proprietário pode convidar colaboradores.
• O código da organização da sua organização: um identificador curto sem espaços, como demo-bezoekerscentrum. Encontra-o em três sítios: na barra de endereço do seu painel, logo a seguir a /app/; em Definições → Organização, no campo Código da organização; e no topo da página Colaboradores. Também aparece em todos os e-mails de convite.
• O endereço de e-mail de cada pessoa que vai ler bilhetes.
• Meia hora, da primeira vez. Depois disso, preparar um dispositivo é coisa de dois minutos.

---

Passo 1 — convidar alguém para ler bilhetes

Quem tem a função Leitura de bilhetes é um colaborador com exatamente uma permissão: ler bilhetes. Não pode alterar produtos, não vê encomendas e não pode reembolsar dinheiro. É propositadamente assim tão limitado: à entrada está muitas vezes um voluntário que ajuda numa única noite.

1. No painel, aceda a Definições → Colaboradores.
2. Clique em Convidar um colaborador e preencha o endereço de e-mail e o nome.
3. Em Função, escolha a função Leitura de bilhetes.
4. A pessoa recebe um e-mail com um link para escolher uma palavra-passe. Esse link é válido durante 60 minutos. Assim que escolher a palavra-passe através dela, fica ativa e o endereço de e-mail fica logo confirmado. Se já tinha uma conta, fica ativa no primeiro início de sessão.

A explicação completa sobre as funções está em Colaboradores e funções.

Atenção: convide cada pessoa separadamente. Uma conta partilhada, com uma palavra-passe que circula num papelinho, parece prática, mas depois deixa de ser possível saber quem leu o quê — e não se pode retirar o acesso a uma pessoa sem deixar todas as outras de fora.

---

Passo 2 — instalar a app no telemóvel

Instalar uma app significa: ir buscar o programa a uma loja para o telemóvel. A loja depende do dispositivo.

Um iPhone ou iPad

A app está na App Store, o ícone azul com um "A" branco feito de pinceladas. No próprio dispositivo, abra Passavo na App Store, toque em Obter e confirme com o código do dispositivo, o Face ID ou o Touch ID. Também pode simplesmente procurar Passavo na App Store.

Ao fim de meio minuto, o ícone aparece no ecrã principal. A partir daí, as atualizações chegam automaticamente, tal como nas outras apps.

A app funciona num iPhone ou iPad com iOS 15.5 ou posterior.

Um dispositivo Android (Samsung, Google Pixel, Xiaomi, …)

A app também está no Google Play, a loja com o triângulo colorido que vem de origem em todos os dispositivos Android. No próprio dispositivo, abra Passavo no Google Play e toque em Instalar. Também pode simplesmente procurar Passavo no Google Play.

Ao fim de meio minuto, o ícone aparece entre as suas apps. A app funciona a partir do Android 6.0; as atualizações chegam depois automaticamente, tal como nas outras apps.

Através do TestFlight, se receber uma versão de teste

O TestFlight é o serviço de testes da Apple. Usamo-lo para dar primeiro uma nova versão a um pequeno grupo, antes de chegar à App Store. Não é, portanto, outra app nem uma app inferior — é a mesma app, por outra porta. Se não recebeu nenhum convite, não precisa de fazer nada com isto: a App Store normal chega.

Funciona assim:

1. Recebe de nós um convite por e-mail no endereço que indicou.
2. Primeiro, instala o próprio TestFlight a partir da App Store. É uma app gratuita da Apple, um ícone cor de laranja com um aviãozinho branco.
3. Abre o e-mail de convite no telemóvel e toca no botão que lá está.
4. O TestFlight abre e mostra a app. Toca em Instalar.

Atenção: um convite do TestFlight é pessoal e está associado a um único endereço de e-mail. Não reencaminhe o e-mail a um colega — não lhe serve de nada. Peça-nos à vontade um segundo convite; não custa nada.

Passo 3 — iniciar sessão

Abra a app. Aparecem três campos.

Campo	O que preencher
Código da organização	O identificador curto da sua organização. Maiúsculas ou minúsculas, tanto faz
Endereço de e-mail	O endereço com que a pessoa foi convidada
Palavra-passe	A palavra-passe que ele próprio escolheu

O código da organização garante que a app sabe a que organização se deve dirigir. Na mesma plataforma há centenas de associações; sem esse código, um endereço de e-mail não bastaria.

Se o início de sessão correr bem, o dispositivo aparece no painel em Caixa → Dispositivos, com a marca e o modelo do telemóvel como nome. Dê-lhe aí um nome que corresponda à realidade ("Porta 2", "Entrada lateral"): clique em Editar junto ao dispositivo e altere o Nome. Quando surge um problema, esse nome é a única coisa que ainda ajuda.

Atenção: se o início de sessão falhar, aparecem duas mensagens diferentes, e a diferença é importante. "Dados de acesso incorretos" significa que o código, o endereço ou a palavra-passe estão errados. Uma mensagem sobre falta de permissão de leitura significa que a conta existe, mas não tem a função Leitura de bilhetes — nesse caso, volte ao passo 1.

Após cinco tentativas falhadas no espaço de um minuto, a app espera um pouco. Não é uma avaria; serve para travar quem esteja a tentar adivinhar palavras-passe.

---

Passo 4 — obter o manifesto

Ao iniciar sessão, sempre que a app é aberta com rede, e sempre que o pedir, a app obtém um manifesto: a lista de bilhetes do dia. Pense na lista de convidados que um porteiro tem na mão. Para o atualizar manualmente, aceda na app a Definições → Atualizar manifesto.

Com ele, a app continua a ler bilhetes quando a rede falha, e a rede falha. Numa cave, numa tenda, num prado com trezentas pessoas todas agarradas ao telemóvel.

A app decide cada leitura sozinha, com base nesse manifesto, e mostra a resposta de imediato. Assim que há ligação, envia as leituras. À porta, não se nota nada disso.

O manifesto não contém os códigos dos bilhetes, apenas a sua impressão digital — um cálculo irreversível feito sobre o código. Um dispositivo roubado com um manifesto descarregado não fornece, portanto, um único código QR utilizável.

Atualize o manifesto pouco antes de abrir as portas. Um bilhete vendido depois da última atualização não está no dispositivo. Veja abaixo como a app lida com isso.

---

Bilhetes vendidos depois da atualização

Um bilhete vendido depois de o manifesto ter sido obtido não está no dispositivo. A partir da versão 1.2 da app, acontece o seguinte:

• com rede, a app verifica esse código online de imediato e mostra a resposta: válido, com o produto e o nome, ou inválido. Isso demora no máximo alguns segundos. Uma segunda leitura do mesmo bilhete é depois reconhecida pelo dispositivo, mesmo sem rede;
• sem rede, isso não é possível: a app indica inválido e coloca a leitura na fila de espera. Se vender à porta enquanto se leem bilhetes, garanta que os dispositivos estão online.

Bilhetes de teste. Um bilhete de uma encomenda de teste (paga no modo de teste do seu fornecedor de pagamentos) nunca dá acesso. A app mostra então Bilhete de teste — sem acesso. Quem apresenta um bilhete destes não pagou de facto: encaminhe-o para a bilheteira.

---

O que aparece no ecrã

Resultado	Significado
VÁLIDO	Pode entrar. O bilhete fica agora utilizado.
ATENÇÃO	Este bilhete já foi lido; o ecrã mostra a que horas. No caso de um passe anual: já entrou hoje.
INVÁLIDO	Não deixar entrar sem verificar. O código não está no manifesto (desconhecido, falsificado ou vendido depois da última atualização), o bilhete foi cancelado ou reembolsado, ou um passe anual está bloqueado ou não é válido neste dia.

Além de uma cor, cada resultado tem também um ícone e uma palavra. Não é exagero: à entrada há pessoas sob sol intenso ou com daltonismo, e nesse caso a cor, por si só, não é sinal suficiente.

Numa leitura válida aparece também o produto e, se existirem, o horário e o nome do visitante. Se o bilhete foi vendido através de um revendedor, o nome deste também aparece. Parece um pormenor até alguém aparecer à sua frente com um voucher de um site de reservas: fica logo a saber para quem o encaminhar.

O que dizer perante "atenção" ou "inválido"?

É a parte mais difícil do trabalho, e não tem nada a ver com tecnologia. Algumas frases que funcionam:

• "Este bilhete aparece como utilizado. Será que já entrou, ou outra pessoa recebeu o mesmo código?"
• "Não estou a obter um ecrã verde. Posso pedir-lhe que se afaste um momento? Assim resolvemos isto juntos e deixo a fila avançar."
• "Não o posso deixar entrar com este código, mas o meu colega na bilheteira pode procurar a sua encomenda."

Três coisas que não deve fazer: discutir na fila, chamar falsificador a alguém ou deixar entrar à mesma porque há muita gente. Peça à pessoa que se afaste, deixe a fila avançar e peça a alguém com acesso ao painel que procure a encomenda. Consulte Acompanhar encomendas.

---

Como manter a fila a andar

A app lê depressa. A fila para por razões completamente diferentes.

• Aumente o brilho do telemóvel do visitante. A câmara não lê um ecrã escuro. Basta pedir: "Pode aumentar um pouco o brilho do ecrã?"
• Fora com a capa. Uma película protetora escurecida ou uma capa tipo livro sobre o ecrã é a causa mais comum de uma leitura que falha.
• Deixe o visitante mostrar o ecrã, não lhe pegue no telemóvel. É mais rápido, e não fica responsável se alguma coisa cair.
• Diga antecipadamente onde as pessoas se devem colocar. Uma placa dez metros antes da porta a dizer "Tenha o bilhete pronto" poupa mais tempo do que uma app mais rápida.
• O papel também se lê. Um bilhete impresso em papel branco, bem esticado, é muitas vezes a leitura mais rápida da noite.
• Com sol intenso: fique de costas para o sol, ou use o próprio corpo para fazer sombra sobre o ecrã do visitante.

---

Várias entradas

Cada dispositivo lê de forma independente. Pode perfeitamente usar quatro numa mesma porta. As leituras são registadas como observações separadas: quem leu o quê, e quando, continua visível, mesmo quando dois dispositivos veem o mesmo bilhete com pouco tempo de diferença.

Atenção: um dispositivo não sabe de imediato o que outro dispositivo leu. Só o fica a saber quando atualiza o manifesto. Se alguém apresentar o mesmo código em duas entradas com pouco tempo de diferença, o segundo dispositivo pode, portanto, ainda mostrar VÁLIDO. Mais tarde, essa segunda leitura aparece como Já lido no painel: em Definições → Colaboradores, no colaborador, em Detalhes, na lista Leituras.

---

Um dispositivo perdido

Um telemóvel que anda de mão em mão à entrada acaba por se perder um dia. Nesse caso, faça o seguinte, por esta ordem:

1. Retire a permissão de leitura ao utilizador que tinha sessão iniciada nesse dispositivo. Aceda a Definições → Colaboradores e clique em Eliminar junto a essa pessoa; o acesso dela à sua organização desaparece. A permissão de leitura é verificada de novo em cada pedido, por isso o dispositivo fica de fora na sincronização seguinte.
2. Peça a essa pessoa que altere a palavra-passe, para que também não seja possível voltar a iniciar sessão. Se mais tarde voltar a ler bilhetes, convide-a de novo.
3. Coloque o dispositivo como inativo em Caixa → Dispositivos (abra-o com Editar e desative Ativo), para que deixe de aparecer como utilizável na sua lista.
4. Depois, inicie simplesmente sessão na app no dispositivo de substituição. Este aparece sozinho na lista como novo dispositivo.

A identificação do dispositivo é guardada por nós em forma de hash, por isso nem uma cópia da base de dados permite obter um dispositivo funcional. E, como se disse acima: o manifesto no dispositivo perdido não contém códigos utilizáveis.

---

Lista de verificação: uma hora antes de abrir as portas

• Cada dispositivo de leitura está carregado ou ligado a uma bateria externa.
• Cada dispositivo tem sessão iniciada e mostra o nome correto da organização.
• O manifesto foi atualizado em cada dispositivo.
• O brilho do ecrã está alto e o bloqueio automático está definido para, pelo menos, dois minutos.
• Sabe quem está em que entrada e quem pode abrir o painel quando for preciso procurar um bilhete.
• Há um dispositivo de reserva pronto, ou pelo menos um segundo telemóvel com a app instalada.
• A sua equipa de controlo sabe o que dizer perante "inválido".
• Também vende à porta? Então cada dispositivo de leitura tem rede, para poder voltar a atualizar o manifesto depois de uma venda.

---

A mesma app faz mais do que ler bilhetes

A app não serve apenas para ler bilhetes. Quem inicia sessão com a função Bilheteira, Administrador ou Proprietário recebe, depois de iniciar sessão, um ecrã inicial com dois mosaicos: Ler e Caixa. O segundo abre a caixa completa da bilheteira dentro da própria app, num iPad ou num tablet Android — prático numa mesa onde se vende e se leem bilhetes. No topo há um botão para alternar rapidamente.

Para a sua equipa de controlo, nada muda. Quem tem apenas a função Leitura de bilhetes não vê esse ecrã inicial: depois de iniciar sessão, a app vai diretamente para o ecrã de leitura, como sempre. Não aparecem preços, montantes nem números de vendas.

Como configurar a caixa num tablet está explicado em A caixa da bilheteira.

---

Erros frequentes

• Uma única conta para toda a equipa de controlo. Deixa de ser possível ver quem leu o quê e de retirar o acesso a uma só pessoa. Convide cada um separadamente.
• Não atualizar o manifesto. Os bilhetes vendidos nessa manhã não estão no dispositivo e recebem INVÁLIDO. Atualize pouco antes de abrir as portas.
• Terminar sessão com leituras ainda pendentes. As leituras que ainda não foram enviadas perdem-se ao terminar sessão. Verifique primeiro em Definições: aparece "Tudo enviado"? Se não, toque em Enviar agora.
• O telemóvel com bloqueio automático aos trinta segundos. Quem está à porta passa a noite inteira a desbloquear o dispositivo. Aumente esse tempo.
• Reencaminhar um convite do TestFlight. Está associado a um único endereço de e-mail. Peça um segundo convite.
• Discutir na fila por causa de um bilhete inválido. Peça à pessoa que se afaste e deixe a fila avançar.

---

E se …

E se a câmara não ler nada?

Verifique três coisas, por esta ordem: o brilho do ecrã do visitante está alto, há uma capa ou película por cima, e a lente da câmara do seu próprio dispositivo está suja? Uma lente que passou uma noite no bolso das calças fica baça. Uma passagem com a manga resolve mais do que se imagina.

E se não houver rede nenhuma?

Nesse caso, a app continua a ler com base no manifesto que já tem. Não se nota nada. As leituras vão para uma fila de espera no dispositivo e são enviadas assim que houver ligação de novo — mesmo que seja horas depois.

O que não é possível nessa situação: reconhecer um bilhete vendido depois de o manifesto ter sido obtido — a app mostra-o como INVÁLIDO. Se vender à porta enquanto se leem bilhetes, garanta que há rede na entrada e atualize o manifesto depois de cada venda dessas.

E se o mesmo bilhete for lido duas vezes?

No mesmo dispositivo, a segunda leitura indica ATENÇÃO, com a hora da primeira leitura. Noutro dispositivo, isso só acontece depois de esse dispositivo ter atualizado o manifesto; consulte "Várias entradas" acima. A primeira leitura continua a ser a válida. Se uma leitura mais antiga só chegar mais tarde porque um dispositivo estava offline, a hora de entrada passa para esse momento mais antigo: a ordem em que as pessoas realmente entraram pesa mais do que a ordem em que a rede a transmitiu.

E se um visitante não encontrar o bilhete?

Procure a encomenda no painel e reenvie o e-mail de confirmação. Também pode marcar o visitante na própria app: procure-o pelo nome no separador Hoje e toque em Fazer check-in. Conta como uma leitura normal.

E se o telemóvel de leitura ficar sem bateria?

É para isso que serve o dispositivo de reserva da lista de verificação. Um segundo dispositivo inicia sessão, obtém o manifesto e funciona de imediato. As leituras do dispositivo sem bateria acabam por chegar assim que voltar a ser ligado e tiver rede — mesmo que seja no dia seguinte, desde que ninguém termine sessão nesse dispositivo entretanto.

---

Perguntas frequentes

A app tem algum custo? Não. A app faz parte da sua assinatura. O que é preciso é um dispositivo capaz de a executar.

Quantos dispositivos posso usar? Tantos quantas as entradas que tiver. Cada dispositivo lê de forma independente e mantém a sua própria fila de espera.

A minha equipa de controlo vê quanto faturámos? Não. A app de leitura não tem preços, montantes nem números de vendas. Só mostra o necessário para deixar alguém entrar.

Os passes anuais também funcionam na app de leitura? Sim. Um passe anual tem o mesmo tipo de código QR e está no mesmo manifesto, com o número de visitas que permite por dia. Consulte Passes anuais.

Cada pessoa da equipa de controlo tem de ter o seu próprio dispositivo? Não, o dispositivo pertence à entrada e não à pessoa. Se houver troca de turno, a pessoa seguinte pode continuar no mesmo dispositivo — mas as leituras ficam em nome de quem tem a sessão iniciada. Se quiser registar isso com precisão, peça à nova equipa que volte a iniciar sessão. Antes de terminar sessão, toque em Definições → Enviar agora, senão as leituras pendentes perdem-se.