Módulo Telegram — Conectando
O bot do Telegram permite que o técnico terceirizado acompanhe e execute as ordens de serviço direto do celular, sem abrir o painel web: aceitar ordens, iniciar, concluir com materiais, solicitar equipamentos e receber avisos na hora.
O que é um Mini App?
Algumas ações no bot abrem um Mini App — uma "janelinha" que roda dentro do próprio Telegram com a mesma cara do sistema. É por ela que o técnico conclui ordens, assina e solicita materiais sem sair do aplicativo.
Quem pode usar
O bot é exclusivo para o perfil de técnico terceirizado (vinculado a uma prestadora). Perfis administrativos (Super Administrador, gestores de prestadora) não têm acesso operacional pelo bot.
Passo 1 — Ter um usuário de acesso
O técnico precisa de um usuário no sistema com o perfil de técnico. Se ainda não existe, o Super Administrador (ou a prestadora) cria o usuário vinculado ao técnico — veja Gerindo a Equipe.
Passo 2 — Vincular a conta do Telegram
- O técnico acessa o painel web com o usuário dele;
- Abre o Meu Perfil (menu do usuário, no canto superior);
- Clica em "Vincular Telegram";
- O sistema gera um link de conexão (válido por 15 minutos);
- O técnico copia o link e abre no celular (ou copia e cola no Telegram);
- No Telegram, toca em INICIAR ou digita
/start; - ✅ Conta vinculada! O bot responde com o menu principal do técnico.
Meu Perfil: botão "Vincular Telegram" gera o link de conexão; depois de vinculado, a área mostra "Conta Vinculada!" com opção de desvincular.
Importante
- O link expira em 15 minutos — se vencer, gere um novo pelo Meu Perfil;
- Cada conta do Telegram pode estar vinculada a apenas um usuário do sistema;
- O vínculo é pessoal: o bot identifica o técnico pela conta vinculada e só mostra o que é dele.
Passo 3 — Primeiro contato com o bot
Depois de vinculado, o técnico pode fechar o painel web e operar pelo celular:
- O menu principal aparece sempre que ele digita
/menuou/start; - O bot mostra o resumo operacional (quantas OS estão com ele, em execução, pendentes, agendadas para hoje e ordens disponíveis no pool da prestadora);
- Cada OS recebida/alterada gera um aviso automático no Telegram (nova OS, OS atribuída, pendência, conclusão, solicitação aprovada/repassada etc.).
O bot do LuariX OS aparece nas conversas; toque em INICIAR (ou digite /start) para começar.
Desvincular a conta
Se o técnico trocar de celular ou a conta precisar ser liberada:
- No painel web → Meu Perfil, a área do Telegram mostra "Conta Vinculada!";
- Clique em "Desvincular Conta";
- A conta do Telegram deixa de receber as ordens daquele técnico.
Para vincular de novo, basta repetir o Passo 2 (novo link).
Próximos passos
Veja o que dá para fazer no bot em Comandos e os fluxos completos (concluir OS com materiais, solicitar equipamentos) em Fluxos Operacionais.