Guias Básico 5 min de leitura

Guias - Portal do Guia (onde o guia escaneia o QR Code)

O Portal do Guia é um endereço separado do painel da agência. O guia entra pelo celular em /guia, com o próprio e-mail e senha, e usa o Scanner para ler o QR Code do cartão de embarque do passageiro e fazer o check-in. É a resposta para "o cliente recebe o QR Code, mas onde eu escaneio?".

Atualizado em 26/09/2026

Portal do Guia: a tela de início

Tutorial em vídeo · 3:16 · gravado em 22/09/2026

Abrir na biblioteca de vídeos

O que é

O Portal do Guia é um endereço separado do painel da agência. Quem usa é o guia, pelo celular, durante a viagem. Ele não entra no /admin: entra em /guia, com o próprio e-mail e senha.

É aqui que fica o leitor de QR Code. Se a dúvida é "o passageiro recebeu o cartão de embarque com QR Code, mas onde eu escaneio isso?", a resposta é o Scanner do Portal do Guia, no celular de quem está embarcando o ônibus.

O endereço

O portal fica no mesmo domínio do site da agência, com /guia no final:

  • /guia ou /guia/login. Tela de entrada
  • /guia/dashboard. A tela inicial depois de entrar
  • /guia/scanner. O leitor de QR Code

Exemplo: se o site da agência é minhaagencia.com.br, o portal é minhaagencia.com.br/guia.

Vale salvar o endereço na tela inicial do celular do guia. O portal foi feito para o celular, não para o computador.

Como o guia ganha acesso

  1. Cadastre o guia em Cadastros → Guias → Novo Guia, com o e-mail dele;
  2. deixe ligado o "Enviar e-mail para definir senha" no bloco Dados Pessoais. O guia recebe um e-mail e cria a própria senha;
  3. vincule o guia à excursão, na aba de Logística da viagem. Sem esse vínculo ele entra no portal mas não enxerga a viagem.

Se o guia perdeu a senha, ele mesmo resolve em /guia/esqueci-senha.

O que o guia vê

A barra inferior do portal tem quatro itens:

Item Para que serve
Dashboard as próximas viagens dele e os números do dia
Eventos a lista das excursões em que ele é o guia
Scanner o leitor de QR Code, para check-in e check-out
Admin atalho para o painel, só se ele também for usuário do sistema

Dentro de cada excursão ele tem a lista de passageiros, o relatório de embarque, as paradas do roteiro e o lançamento de despesas da viagem.

Fazendo o check-in pelo QR Code

  1. No celular, abra /guia/scanner ou toque em Scanner na barra inferior;
  2. escolha a excursão na lista. O scanner só mostra viagens da data de hoje ou em andamento. Uma viagem de semana que vem não aparece ali;
  3. libere o acesso à câmera quando o navegador pedir. Sem essa permissão o leitor não abre;
  4. aponte para o QR Code do cartão de embarque do passageiro. O check-in é registrado na hora, e aparece no painel da agência;
  5. na volta, o mesmo QR Code faz o check-out.

Se a câmera não abrir, o portal mostra o motivo na própria tela: câmera em uso por outro aplicativo, permissão bloqueada no navegador, ou nenhuma câmera disponível. Em iPhone, o acesso à câmera só funciona em conexão segura (https).

O passageiro não achou o QR Code? Ele está no cartão de embarque, enviado por WhatsApp ou e-mail. Dá para reenviar pelo painel, na ficha do passageiro. Se mesmo assim faltar, o guia consegue fazer o check-in manual pela lista de passageiros da excursão.

Quando a câmera não abre

Quase sempre é permissão do aparelho ou do navegador, não um defeito do sistema. O leitor usa a câmera do próprio celular, e o navegador só a libera com sua autorização e em conexão segura (https). Confira, nesta ordem:

  1. Abriu por https? No iPhone (Safari) a câmera só funciona em https. Se o endereço do portal estiver abrindo em http://, troque para https://. O portal da agência já roda em https; o problema costuma ser um link antigo salvo na tela inicial.
  2. A permissão foi concedida? Ao tocar em Iniciar Scanner, o navegador pergunta se pode usar a câmera - toque em Permitir. Se você bloqueou antes sem querer, dá para reverter:
    • Android (Chrome): toque no cadeado ao lado do endereço → Permissões → ligue Câmera → recarregue a página.
    • iPhone (Safari): Ajustes do celular → Safari → Câmera → deixe em Perguntar ou Permitir; ou toque em aA na barra de endereço → Configurações do Site → Câmera.
  3. A câmera está em uso? Se outro aplicativo estiver com a câmera aberta (WhatsApp, Zoom, a própria câmera do celular), o scanner mostra "câmera em uso por outro app". Feche o outro aplicativo e tente de novo.
  4. Navegador muito antigo? Atualize o navegador (ou o sistema do celular). O leitor precisa de um navegador recente.

Se, mesmo assim, não abrir no momento do embarque, não trave a fila: o guia faz o check-in manual pela lista de passageiros da excursão, e também dá para digitar o código do cartão no próprio scanner, no campo de código manual.

Perguntas que aparecem sempre

O guia precisa de login do sistema? Não. Ele usa o e-mail e a senha dele no /guia, e não ocupa uma licença de usuário do painel.

Funciona sem internet? O scanner precisa de conexão para registrar o check-in. Em ponto de embarque sem sinal, use o check-in manual e confira depois.

Dá para escanear pelo computador? Dá, se ele tiver câmera, mas o portal foi desenhado para o celular.

Quem mais pode escanear? Um usuário do painel com acesso ao portal enxerga todas as viagens próximas, não só as dele. O guia comum vê apenas as suas.

Este artigo foi útil?

Obrigado pelo seu feedback!

Neste artigo

Comece a usar agora

Crie sua conta e teste grátis por 7 dias, com acesso a todas as funcionalidades.

Testar Grátis