Filas

Uma fila é uma lista de espera com nome dentro de um estabelecimento. Quando um cliente entra numa fila, recebe uma senha com um número sequencial. O pessoal no balcão chama as senhas da fila uma a uma. O visor anuncia cada chamada.

Anatomia de uma fila

Cada fila tem:

Nome — o rótulo legível mostrado aos clientes e ao pessoal (ex.: “Sem marcação”, “Marcações”).
Slug — um identificador seguro para URL usado no URL de entrada do cliente. Gerado automaticamente a partir do nome da fila.
URL de entrada do cliente — o URL completo que os clientes visitam para entrar nesta fila:
```
https://customer.jonot.io/{org-slug}/{location-slug}/{queue-slug}/
```
Este URL também é codificado no QR code que partilha à entrada.
Limite de capacidade (opcional) — o número máximo de senhas que podem estar no estado WAITING em simultâneo. Quando a fila está cheia, novas tentativas de entrada são recusadas com uma mensagem de “fila cheia”. Deixe em branco para ilimitado.
Tempo de atendimento esperado — os minutos típicos para atender um cliente (1–1440), definidos no formulário de criação/edição da fila. Serve para estimar o tempo de espera do cliente antes de a fila ter histórico ao vivo suficiente para medir o seu próprio ritmo (consulte Estimativa do tempo de espera).

Várias filas por estabelecimento

Um estabelecimento pode ter qualquer número de filas. Isto permite gerir linhas de atendimento separadas em paralelo — por exemplo:

Uma clínica com filas de “Consulta Geral” e “Levantamento na Farmácia”
Uma repartição pública com filas de “Passaporte” e “Renovação de Cartão de Cidadão”
Um banco com filas de “Particulares” e “Empresas”

Cada fila tem a sua própria lista de espera independente. Um balcão é associado a uma fila específica no momento da associação, pelo que os balcões que atendem “Sem marcação” não veem senhas de “Marcações”.

A fila como unidade de gestão

A fila é a unidade central em torno da qual os dispositivos e o pessoal se organizam:

Quiosques são associados a uma fila — os clientes que tocam no quiosque entram nessa fila específica.
Balcões são associados a uma fila — o pessoal chama senhas dessa fila.
Visores mostram todas as chamadas ativas de um estabelecimento, as chamadas da fila de um balcão específico, ou um painel combinado com até 5 filas.

A criação e gestão de filas é feita no admin, no separador Filas do estabelecimento. Consulte Criar uma Fila para as instruções passo a passo.

Limite de capacidade

Pode limitar quantos clientes podem esperar numa fila em simultâneo definindo um limite de capacidade (o campo Máximo em espera no formulário de criação/edição da fila). Quando o limite é atingido:

O fluxo de entrada do cliente mostra uma mensagem de “fila cheia”.
O quiosque mostra o estado de fila cheia.
A fila deixa de aceitar entradas até que uma senha em espera saia (seja chamada, cancelada ou movida).

O limite é aplicado de forma atómica — dois clientes que tentem entrar exatamente ao mesmo tempo não podem ambos fazer a contagem ultrapassar o limite. Deixe o campo em branco para uma fila ilimitada (predefinição).

Estado da fila

Todas as filas têm um estado manual que o pessoal controla independentemente do horário de funcionamento:

Ativa — o estado normal. Os clientes podem entrar e os balcões podem chamar senhas.
Em pausa — interrompe temporariamente a entrada. Novas entradas são recusadas, mas todos os que já estão em espera mantêm o seu lugar. Use-o para uma pausa curta ou para reduzir uma acumulação antes de deixar entrar mais pessoas.
Fechada — interrompe a entrada como uma pausa, mas sinaliza que a fila terminou por agora. As senhas em espera são mantidas em vez de canceladas. Reabrir uma fila encerrada é uma ação de admin — um balcão não a pode reabrir sozinho.

Quando uma fila está em pausa ou encerrada, um cliente que já esteja em espera vê uma faixa de estado na sua senha, e quem tenta entrar é dispensado com uma mensagem correspondente em vez de um erro genérico. Uma faixa de pausa tranquiliza o cliente de que o seu lugar é mantido e a fila vai retomar; uma faixa de encerrada é mais cautelosa — a senha é mantida mas pode não ser atendida, pelo que se pede ao cliente que verifique com o pessoal.

Definir o estado:

No admin, um gestor da organização ou gestor do local define o estado (Ativa / Em pausa / Encerrada) no formulário de edição da fila.
No balcão, o pessoal pode alternar entre Ativa e Em pausa com um único botão Pausar fila / Retomar fila — o caminho rápido para uma pausa momentânea sem sair do balcão. Encerrar (e reabrir a partir de encerrada) mantém-se no admin.

As alterações de estado têm efeito imediato e são transmitidas em tempo real a todos os balcões, visores e clientes ligados.

Horário de funcionamento

O horário de funcionamento de um estabelecimento atua como um controlo temporal sobre todas as suas filas. Quando o estabelecimento está fora do horário configurado, as tentativas de entrada são recusadas com uma mensagem de “fora de horário” e o seletor de filas voltado para o cliente mostra um estado “Encerrado — abre às [hora]”. O balcão e o visor mostram um selo Encerrado (horário).

O horário é configurado no estabelecimento (não por fila) em Admin → [Estabelecimento] → Horário:

Fuso horário — fuso horário IANA (ex.: Europe/Lisbon). Todo o horário é avaliado neste fuso, com correção automática para o horário de verão.
Horário semanal — intervalos de abertura/encerramento para cada dia da semana. Um dia sem intervalos está totalmente encerrado. São suportados vários intervalos por dia (ex.: para modelar uma pausa para almoço: 08:00–12:00 e 13:00–17:00).
Horário que atravessa a meia-noite — é suportado um intervalo em que a hora de encerramento é depois da meia-noite (ex.: sexta-feira 20:00–02:00). Indique a hora de encerramento com um valor de relógio normal (02:00); quando a hora de encerramento é igual ou anterior à hora de abertura, o editor trata-a automaticamente como o dia seguinte e mostra uma indicação de dia seguinte junto ao campo de encerramento.

Exceções de data

Exceções de data única (feriados, horários especiais) são geridas na secção Exceções por data do editor de horário:

Exceção de encerramento — marca uma data específica como totalmente encerrada, independentemente do horário semanal (ex.: um feriado).
Exceção de horário personalizado — substitui o horário semanal numa data específica por um conjunto diferente de intervalos. Uma exceção de encerramento numa determinada data tem precedência sobre a prolongação da meia-noite do dia anterior.

As exceções aparecem numa lista abaixo do horário semanal e podem ser adicionadas, editadas ou eliminadas a qualquer momento.