Notificações Push

O Jonot envia uma notificação do sistema aos clientes quando a sua senha transita para CALLED — mesmo quando o separador do navegador está em segundo plano ou o telemóvel está bloqueado. As notificações também são enviadas quando uma senha saltada é chamada de volta e depois chamada de novo.

Como funciona

1. Um cliente está prestes a entrar numa fila e vê o ecrã do seletor de filas.
2. Aparece um cartão de adesão a push acima da lista de filas — o cliente toca em Notificar-me e concede permissão do navegador antes de entrar.
3. O navegador regista uma subscrição Web Push.
4. O cliente entra na fila e recebe uma senha. A subscrição fica associada à senha no servidor.
5. Quando um balcão chama a senha, o servidor envia uma mensagem push para todas as subscrições ativas dessa senha.
6. O dispositivo do cliente acorda e mostra uma notificação do sistema com o número da senha, o nome da fila e o estabelecimento. Tocar na notificação abre o ecrã da senha.
7. As subscrições são automaticamente eliminadas quando a senha atinge um estado terminal (COMPLETED, CANCELED ou NO_SHOW) ou quando o endpoint push expira (navegador cancelou a subscrição / permissão revogada).

Os clientes que não aderiram no seletor de filas ainda podem aderir a partir do ecrã da senha — é mostrado um cartão de notificação enquanto a senha estiver WAITING ou CALLED.

Notificações de chamada de volta de senhas saltadas

Se a senha de um cliente for saltada (passa ao estado SKIPPED), a sua subscrição push é mantida ativa. Quando o pessoal chama de volta a senha (fazendo-a voltar a WAITING) e depois a chama, o cliente recebe a notificação push — mesmo que tenha fechado a página da senha.

Isto significa que um cliente que aderiu e depois se ausentou continua a ser notificado quando o pessoal o chama de volta, sem precisar de manter o navegador aberto.

Adesão — experiência do cliente

Estado	Mostrado
Pedido (permissão ainda não solicitada)	Cartão de adesão (seletor de filas + ecrã da senha)
Permissão concedida + subscrito	Confirmação “Vamos notificá-lo — pode fechar este separador”
Permissão negada	Conselho alternativo + ligação para as definições do navegador
Navegador não suportado	Nada (ignorado silenciosamente)

Assim que subscrito, as notificações push são entregues pelo navegador mesmo quando o separador está fechado ou o telemóvel está em segundo plano — os clientes não precisam de manter a página da senha aberta.

Indicador de reconexão

Se o dispositivo do cliente perder a sua ligação WebSocket enquanto a página da senha está aberta (por exemplo, depois de ficar offline por breves instantes), aparece no ecrã um selo Ligação perdida — a restabelecer…. Só é mostrado para senhas não terminais e nunca no carregamento inicial da página. A ligação é restabelecida automaticamente; não é necessária nenhuma ação manual.

iOS — necessário adicionar ao ecrã principal

O iOS Safari 16.4+ suporta Web Push, mas apenas quando a aplicação foi adicionada ao Ecrã Principal (modo autónomo). No iOS Safari no navegador normal:

• O seletor de filas mostra um cartão de orientação Adicionar o Jonot ao ecrã principal acima da lista de filas.
• Depois de adicionar ao Ecrã Principal, o cliente reabre o Jonot a partir do ícone do Ecrã Principal e aparece o pedido de adesão normal.

Cuidado

Os clientes no iOS têm de adicionar o Jonot ao seu Ecrã Principal antes de poderem receber notificações push. A aplicação deteta o iOS automaticamente e guia o cliente pelos passos.

Apenas transacional — sem marketing

As subscrições push estão associadas a uma única senha. São estritamente transacionais: existe uma subscrição para o ciclo de vida de uma senha. Não há nenhum mecanismo para enviar mensagens promocionais ou em massa — apenas os eventos de senha CALLED acionam uma notificação.

Base do RGPD / consentimento: a subscrição está associada à senha que o cliente acabou de criar. A mesma base de consentimento (interesse legítimo / execução do contrato) que cobre a própria senha cobre a notificação única. Não é necessária nenhuma recolha de consentimento separada.

Referência técnica

• Normas: Web Push com encriptação de payload segundo a RFC 8291 (AES-128-GCM) e pedidos autenticados por VAPID segundo a RFC 8292.
• Armazenamento de subscrições: cada subscrição está associada a uma senha e é eliminada automaticamente quando essa senha atinge um estado terminal.