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

O plano da organização determina quantas filas você pode criar em um local. Consulte Faturamento e planos. Esse limite é diferente da capacidade opcional de uma fila, que limita quantos clientes podem esperar ao mesmo tempo.

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 atende de uma a cinco filas atribuídas. A vista multifila permite que a equipe trabalhe com essas filas na mesma tela.

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 atendem de uma a cinco filas atribuídas — a equipe usa a vista de uma fila ou a vista multifila.
Painéis mostram as chamadas de uma fila atribuída ou um painel combinado de até cinco filas atribuídas. Uma associação opcional a um balcão permite mostrar apenas as chamadas dele enquanto estiver online.

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.

Excluir uma fila

Exclua uma fila na guia Filas do local. A caixa de diálogo Excluir fila conta os clientes que estão aguardando ou sendo atendidos e mostra um aviso quando a contagem é maior que zero. A exclusão não espera a fila esvaziar. Ela cancela as senhas desses clientes, e as telas do cliente, do painel e do balcão deixam de exibi-las. A exclusão também remove permanentemente o histórico de senhas da fila, inclusive as senhas concluídas.

O Jonot também envia um webhook ticket.cancelled para cada senha cancelada, até 50 senhas por exclusão.

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. Clientes sem reserva e reservas seguem os mesmos horários. 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.