Personalize o Quiosque

O quiosque pode imprimir senhas físicas usando uma impressora ESC/POS. As senhas incluem o nome da organização, o nome do local, o nome da fila, o número da senha e o texto de cabeçalho/rodapé que configurou no local.

Requisitos

A impressão exige um aplicativo nativo de quiosque. O quiosque executado apenas no navegador não pode imprimir: ele mostra cada número de senha na tela com um QR code para o celular (consulte Acompanhar a senha no celular). As conexões compatíveis dependem do aplicativo:

Aplicativo	Rede	USB	Bluetooth
Aplicativo Android de quiosque	Sim	Sim	Sim
Cliente de quiosque de desktop (macOS, Windows, Linux)	Sim	Sim	Não

A impressão por USB no desktop exige configuração adicional no Windows e no Linux. Consulte Impressoras USB (desktop).

Apenas o quiosque imprime senhas. O balcão não imprime; ele mostra um aviso quando uma impressora de quiosque do local está off-line.

Configurar uma impressora

Depois que você associa um novo quiosque Android ou de desktop, o quiosque abre a configuração da impressora se não houver nenhuma impressora configurada. A tela lista as impressoras que o quiosque encontra, cada uma marcada com o seu tipo de conexão, e um formulário para adicionar uma impressora de rede pelo endereço.

Em Modo de idioma da impressora, escolha o modo compatível com a sua impressora. A maioria das impressoras usa Europa Ocidental (CP858). Escolha Chinês simplificado (Epson GB18030) apenas para uma impressora compatível com esse modo.
Escolha a impressora de uma destas formas:
- Em Impressoras disponíveis, selecione a impressora e toque em Ligar. Se a impressora não estiver na lista, toque em Procurar impressoras.
- Em Adicionar uma impressora de rede manualmente, insira o endereço IP da impressora e toque em Ligar.
O quiosque se conecta à impressora e imprime uma senha de teste automaticamente. Não há uma etapa separada de teste nem de salvamento.
Confira a senha de teste. Se ela foi impressa corretamente, toque em Sim, continuar. O quiosque abre a tela da fila. Caso contrário, toque em Não, tentar novamente. O quiosque remove essa impressora e volta à lista para que você escolha outra vez.

Se nenhuma impressora for encontrada, a tela mostra Nenhuma impressora encontrada. Conecte ou pareie a impressora e, em seguida, toque em Procurar impressoras. Você também pode adicionar uma impressora de rede pelo endereço.

Impressoras de rede

Uma impressora de rede precisa ter um endereço IPv4 privado, como 192.168.x.x, 10.x.x.x ou 172.16–31.x.x, e precisa aceitar conexões na porta 9100. O campo da porta já vem preenchido com 9100 e não aceita outra porta. Nomes de host e endereços públicos não são aceitos. Atribua à impressora um endereço fixo na sua rede para que o quiosque continue a alcançá-la depois que a impressora reiniciar.

Impressoras USB (desktop)

O cliente de quiosque de desktop envia as senhas diretamente para uma impressora USB, e não pelo driver de impressora do sistema operacional. Confira estes requisitos para o seu sistema operacional:

Windows — a impressora precisa usar o driver WinUSB. O Windows normalmente instala o próprio driver de impressão USB ou o driver do fabricante, e o quiosque não consegue abrir uma impressora que use qualquer um deles. Use uma ferramenta de drivers como o Zadig para substituir o driver da impressora pelo WinUSB. Depois da alteração, outros aplicativos do Windows não conseguem imprimir nessa impressora.
Linux — a conta que executa o quiosque precisa ter acesso ao dispositivo USB da impressora. Execute lsusb para encontrar os IDs de fabricante e de produto da impressora. Crie o arquivo /etc/udev/rules.d/70-jonot-printer.rules com a linha abaixo, usando os IDs da sua impressora no lugar de 04b8 e 0202. Em seguida, execute sudo udevadm control --reload-rules e reconecte a impressora.
```
SUBSYSTEM=="usb", ATTR{idVendor}=="04b8", ATTR{idProduct}=="0202", TAG+="uaccess"
```
macOS — não é necessário configurar drivers. A impressão por USB no macOS ainda não foi verificada com impressoras reais.

Se a impressora aparecer na lista, mas a senha de teste não for impressa, confira primeiro estes requisitos.

Se o quiosque informar que a impressora USB está indisponível depois que você conectar uma segunda impressora do mesmo modelo ou copiar as configurações do quiosque para outro computador, abra o menu de gestor e escolha Mudar Impressora.

Impressoras Bluetooth (Android)

Pareie a impressora nas configurações de Bluetooth do Android antes de configurá-la no quiosque. Se a impressora não estiver na lista, toque em Abrir configurações de Bluetooth, pareie a impressora, volte ao quiosque e toque em Procurar impressoras. Por padrão, a lista mostra apenas os dispositivos pareados que se identificam como impressoras. Se a sua impressora estiver pareada, mas não aparecer na lista, selecione Mostrar todos os dispositivos emparelhados. A lista passa a mostrar todos os dispositivos pareados e marca os que não se identificam como impressoras.

No Android 12 e versões mais recentes, o Android pede permissão para se conectar a dispositivos por perto na primeira vez que a configuração da impressora procura impressoras. Se a permissão for negada, a configuração da impressora mostra uma mensagem. Para resolver, abra as Configurações do Android, vá em Apps → Jonot Kiosk → Permissões e conceda a permissão. Em seguida, volte à configuração da impressora.

O quiosque Android só entra no modo de quiosque bloqueado depois que uma impressora é conectada, por isso você pode abrir as Configurações do Android durante a configuração.

Mudar a impressora

Abra o menu de gestor: cinco toques rápidos no canto superior direito (cada um dentro de ~1,5 segundos do anterior), e depois insira o PIN de gestor. Consulte Sair do bloqueio do quiosque para o gesto completo.
Selecione Mudar Impressora para abrir a configuração da impressora de novo. No Android, confirme o aviso que mostra a impressora atual.
A configuração da impressora mostra a impressora atual. O quiosque mantém a impressora atual até que você conecte uma nova. Para mantê-la, toque em Cancelar — manter a impressora atual.
Configure a nova impressora como descrito em Configurar uma impressora.

No Android, o quiosque bloqueado não consegue abrir as Configurações do Android. Para mudar para uma impressora Bluetooth que ainda não está pareada, abra o menu de gestor e escolha Sair. Pareie a impressora nas configurações de Bluetooth do Android, abra o quiosque novamente e, em seguida, escolha Mudar Impressora.

Se você tocar em Não, tentar novamente depois de conectar a nova impressora, o quiosque fica sem impressora até que você configure uma. Se um cliente entrar na fila antes disso, o quiosque muda para o modo de impressora fora de serviço.

Conteúdo da senha impressa

Cada senha impressa contém:

Nome da organização
Nome do local
Nome da fila
Número da senha (grande, em destaque)
Cabeçalho da senha (até 48 caracteres) — configurado no local, no admin
Rodapé da senha (até 48 caracteres) — configurado no local, no admin

Para atualizar o texto do cabeçalho ou rodapé, vá a admin → o seu local → Editar local.

Reimprimir uma senha

Depois de uma impressão bem-sucedida, o cartão de sucesso do quiosque mostra um botão Reimprimir senha durante aproximadamente 30 segundos. Ao tocar nele, os mesmos dados da senha são enviados de novo para a impressora (byte a byte idênticos — mesmo número, cabeçalho, rodapé e registro de data/hora). Isso é útil quando uma senha fica presa ou um cliente precisa de uma segunda cópia.

A reimpressão prolonga a contagem regressiva de fechamento automático, para que o cliente tenha tempo de retirar a nova senha.
Se a reimpressão falhar, o quiosque mostra o cartão de impressora indisponível e pode mudar para o modo de impressora fora de serviço.
Cada reimpressão é um trabalho de impressão separado, com o seu próprio ID de trabalho.

Acompanhar a senha no celular

Depois que o cliente entra na fila, o cartão da senha mostra Acompanhe sua vez pelo celular com um QR code dessa senha. O código aparece quer a senha tenha sido impressa, quer não. O cliente lê o código com a câmera do celular, e o navegador do celular abre a mesma senha para que o cliente acompanhe a sua posição na fila. Ler o código nunca cria uma segunda senha: o cliente mantém o mesmo número.

O código aparece durante 30 segundos. Cada toque em Mais tempo acrescenta 30 segundos, até 10 vezes. Quando faltam 20 segundos, o cartão avisa que o código vai desaparecer em breve. Outros toques na tela não prolongam o código.
No cartão de sucesso, um toque fora do cartão fecha o cartão, o que também faz o código desaparecer.
Quando um celular abre a senha, o código desaparece e o quiosque confirma que a senha foi aberta no celular.
O código também desaparece quando o cliente toca em Concluído, quando o cartão volta à tela inicial, quando o próximo cliente entra na fila e quando o quiosque perde a conexão com o Jonot. Um código que desapareceu não volta a aparecer para essa senha.
Um celular que abre o código depois de ele deixar de funcionar mostra Este código não é mais válido. O celular não oferece entrar na fila de novo, e o cliente mantém a senha que já tem.
Se o quiosque não estiver conectado ao Jonot quando o cliente entra na fila, o cartão mostra o número da senha sem o código.

O código abre a página da senha com o mesmo acesso que o link da senha do próprio cliente, incluindo cancelar a senha. Um celular que abre o código pode ver e cancelar essa senha até a senha terminar. O código continua funcionando por pouco tempo depois de desaparecer, e mais de um celular pode abri-lo. É por isso que o código aparece só por pouco tempo.

Um cliente sem celular fica com a senha impressa. Se a senha não foi impressa, um funcionário anota o número para o cliente.

O QR code da tela inicial é um código diferente. Ele permite que um cliente que ainda não entrou na fila entre pelo celular.

Retorno ao início por inatividade

O quiosque volta automaticamente à tela inicial após um período de inatividade:

Cartão de sucesso — desaparece 30 segundos depois do último toque ou depois de o cliente tocar em Reimprimir senha.
Cartão de falha — desaparece após 45 segundos. Quando uma senha não é impressa, este cartão mostra Senha emitida — impressora indisponível e o número da senha, e pede ao cliente que um funcionário anote o número.

Enquanto o QR code para o celular aparece, nenhum dos cartões desaparece sozinho antes de o código desaparecer.

O aplicativo pausa a contagem quando fica em segundo plano e retoma quando volta para primeiro plano. Assim, um desligamento temporário da tela não reinicia a contagem no meio do processo. Esse comportamento está sempre ativo e não exige configuração.

Idioma do cliente

Quando a sua organização ou local oferece mais do que um idioma, o quiosque mostra um seletor de idioma por sessão, para que cada cliente possa mudar para o seu próprio idioma enquanto o usa. A escolha dura apenas para essa interação — quando o quiosque volta à sua tela inicial de repouso, volta ao idioma padrão do local para a pessoa seguinte. Defina que idiomas são oferecidos e qual o padrão no admin; consulte Idiomas.

Impressora fora de serviço

Uma única falha ao imprimir ou reimprimir uma senha muda o quiosque para o modo de impressora fora de serviço. Isso inclui uma impressora desligada, desconectada ou inacessível, um quiosque com o Bluetooth desativado e um quiosque sem impressora configurada. As falhas que não dizem nada sobre a impressora não contam: um quiosque no navegador que não tem conexão com impressora, um trabalho de impressão que já está em andamento ou uma senha que o quiosque recusa antes que ela chegue à impressora, por exemplo porque contém caracteres que a impressora não consegue imprimir ou porque é grande demais. O quiosque não detecta quando o rolo de papel acaba: a impressora costuma aceitar a senha, então o quiosque a mostra como impressa.

Se a impressora não responder em 8 segundos, o quiosque mostra o cartão de impressora indisponível e espera até mais 30 segundos. Se a senha for impressa nesse tempo, o quiosque continua no modo normal. Uma senha de teste com falha durante a configuração da impressora não muda o modo por si só.

No modo de impressora fora de serviço:

Os clientes continuam podendo entrar na fila. O quiosque não tenta imprimir. Ele mostra o número da senha no cartão Senha emitida — impressora indisponível, junto com o QR code para o celular. Um cliente sem celular pede a um funcionário que anote o número.
A tela inicial mostra um aviso de que a impressora de senhas está fora de serviço, e o texto acima do botão Imprimir senha explica que a senha não é impressa. O botão mantém o seu texto.
O quiosque guarda o modo no dispositivo, por isso o modo continua ativo depois que o aplicativo do quiosque recarrega ou reinicia.
O balcão mostra o seu aviso de impressora off-line para o quiosque, e o admin mostra a impressora como Offline. O quiosque informa a falha de novo sempre que carrega e sempre que um cliente entra na fila. Se nenhuma dessas coisas acontecer durante 24 horas, o balcão deixa de mostrar o aviso, mas o quiosque continua fora de serviço.

Só a equipe pode encerrar o modo de impressora fora de serviço, com uma senha de teste:

Verifique o papel, a alimentação e a conexão da impressora.
Abra o menu de gestor e selecione Mudar Impressora. Consulte Mudar a impressora.
Conecte a impressora. O quiosque imprime uma senha de teste. Uma impressora lenta pode levar até mais 30 segundos, então espere o resultado.
Se a senha de teste foi impressa corretamente, toque em Sim, continuar.

O modo só termina quando o quiosque envia a senha de teste à impressora com sucesso e você confirma que ela foi impressa corretamente. Se o quiosque não conseguir enviar a senha de teste à impressora, o quiosque continua fora de serviço e mostra Imprimir a senha de teste novamente em vez de Sim, continuar. Tocar em Cancelar — manter a impressora atual mantém o quiosque fora de serviço. Um cliente nunca precisa tirar uma senha para testar a impressora.

Estado da impressora no admin

O estado atual da impressora é visível no admin, na aba Dispositivos do local. O estado mostra:

Ligada — a última senha ou senha de teste foi impressa com sucesso.
Offline — a última tentativa de impressão falhou, com um breve motivo.

Se a impressora mostrar um erro, verifique a conexão de rede, USB ou Bluetooth e confirme que a impressora tem papel. O estado volta a Ligada depois da próxima impressão bem-sucedida. No modo de impressora fora de serviço, o quiosque não imprime senhas, então o estado só volta depois que uma senha de teste bem-sucedida encerra o modo.