Filas

Uma fila é uma lista de espera com nome dentro de um local. Quando um cliente entra em uma fila, recebe uma senha com um número sequencial. A equipe no balcão chama as senhas da fila uma a uma. O painel anuncia cada chamada.

Anatomia de uma fila

Cada fila tem:

Nome — o rótulo legível mostrado aos clientes e à equipe (ex.: “Sem agendamento”, “Agendamentos”).
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 compartilha à entrada.
Limite de capacidade (opcional) — o número máximo de senhas que podem estar no estado WAITING simultaneamente. 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 — o tempo normal para atender um cliente, de 1 a 1440 minutos. Defina-o no formulário da fila. O Jonot usa esse valor para estimar o tempo de espera até ter dados recentes suficientes para calcular o ritmo real da fila. Consulte Estimativa do tempo de espera.

Várias filas por local

Um local pode ter qualquer número de filas. Assim, você pode manter filas separadas ao mesmo tempo. Por exemplo:

Uma clínica com filas de “Consulta Geral” e “Retirada 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, por isso os balcões que atendem “Sem agendamento” não veem senhas de “Agendamentos”.

A fila como unidade de gestão

Os dispositivos e a equipe trabalham com as filas desta forma:

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 — a equipe chama senhas dessa fila.
Painéis mostram todas as chamadas ativas de um local, 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, na aba Filas do local. Consulte Criar uma Fila para as instruções passo a passo.

Limite de capacidade

Pode limitar quantos clientes podem esperar em uma fila simultaneamente 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 servidor aplica o limite como uma única operação. Mesmo que dois clientes tentem entrar ao mesmo tempo, a fila não ultrapassa o limite. Deixe o campo em branco para não limitar a fila.

Estado da fila

Todas as filas têm um estado manual que a equipe 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, e indica que o atendimento terminou por enquanto. As senhas em espera permanecem na fila. Apenas um administrador pode reabrir uma fila encerrada.

Quando a fila está pausada ou encerrada, os clientes em espera veem uma faixa de estado na senha. Quem tenta entrar recebe uma mensagem específica. A faixa de pausa informa que o lugar está mantido e que a fila vai continuar. A faixa de encerrada informa que a senha foi mantida, mas pode não ser atendida, e orienta o cliente a falar com a equipe.

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, a equipe 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) continua sendo uma ação do admin.

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

Horário de funcionamento

O horário de funcionamento de um local controla quando os clientes podem entrar em todas as suas filas. Fora desse horário, os clientes não podem entrar e veem uma mensagem de “fora de horário”. O seletor de filas mostra “Encerrado — abre às [hora]”. O balcão e o painel mostram um selo Encerrado (horário).

O horário é configurado no local (não por fila) em Admin → [Local] → 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 gerenciadas na seçã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 em uma data específica por um conjunto diferente de intervalos. Uma exceção de encerramento em uma determinada data tem precedência sobre a prolongação da meia-noite do dia anterior.

As exceções aparecem em uma lista abaixo do horário semanal e podem ser adicionadas, editadas ou excluídas a qualquer momento.