Pular para conteúdo

MentoroBot — Assistente do MentoraOS no Telegram

O MentoroBot é o assistente virtual do ecossistema MentoraOS integrado ao Telegram. Através dele, alunos e professores consultam suas próximas aulas com links diretos para a sala virtual, recebem lembretes automáticos com 1 hora de antecedência e acompanham avisos de reagendamento diretamente no smartphone. Administradores escolares contam ainda com consultas rápidas de saúde, métricas e auditoria.

Conversar com o @MentoraOSBot no Telegram

1. O que o MentoroBot Faz?

Perfil de Usuário Recursos Disponíveis
Alunos Consulta de próximas aulas (/aulas), link de acesso à videoconferência, lembrete automático ~1 hora antes do encontro e avisos em tempo real de remarcação ou cancelamento.
Professores Consulta rápida da grade de aulas (/aulas), links de entrada na sala virtual e lembretes de início de aula.
Administradores Monitoramento de saúde do sistema (/status), métricas operacionais (/metricas) e consulta aos últimos registros de auditoria (/auditoria).

Privacidade e Atendimento Exclusivo 1:1

O MentoroBot opera com o Privacy Mode ativado no Telegram e funciona exclusivamente em conversas privadas diretas. Ele não participa de grupos, garantindo que suas informações escolares e horários de aula fiquem 100% protegidos.

2. Como Conectar sua Conta (Passo a Passo)

Para associar seu usuário do Telegram à sua conta no MentoraOS:

  1. Abra o MentoraOS: No portal da sua escola, clique no seu perfil no canto superior direito e acesse Perfil → Configurações → MentoroBot.
  2. Gere o Código de Vínculo: Clique no botão Gerar Código. O sistema gerará um código seguro de 10 caracteres válido por 10 minutos.
  3. Abra o Telegram: Acesse diretamente o bot oficial @MentoraOSBot e clique em Começar (ou envie o comando canônico /start).
  4. Envie o Código: No chat do Telegram, digite: 
    /vincular SEU_CODIGO
    (Substitua SEU_CODIGO pelo código alfanumérico exibido na sua tela).
  5. Pronto! O bot responderá confirmando seu nome e exibirá o teclado com atalhos interativos adaptados ao seu perfil.

Importante sobre o Código de Vínculo

Cada código é descartável, temporário e só pode ser utilizado uma única vez. Se o código expirar após 10 minutos, basta clicar novamente em Gerar Código no portal.

3. Comandos Oficiais e Interações

O MentoroBot adota a Diretriz de Comando Canônico Único: os comandos seguem os padrões nativos do Telegram e são padronizados em português, eliminando sinônimos concorrentes para a mesma finalidade.

Comando O que ele faz? Quem pode usar?
/start Inicia o atendimento, saúda o usuário identificado e apresenta o menu principal. Todos (comando nativo de início)
/ajuda Exibe as instruções de uso e atalhos disponíveis para seu perfil. Todos
/vincular CODIGO Associa seu perfil do Telegram à sua conta acadêmica no MentoraOS. Usuário com código ativo
/aulas Exibe as próximas 10 aulas agendadas com data, horário, status e link para a sala. Alunos, Professores e Gestores
/sair Desvincula imediatamente sua conta do Telegram e cancela o envio de notificações. Usuários vinculados
/status Exibe o tempo de atividade (uptime) e integridade dos serviços da aplicação. Apenas Administradores
/metricas Apresenta o número de alunos ativos, faturamento confirmado e total de aulas de hoje. Apenas Administradores
/auditoria Exibe os últimos registros da trilha imutável de auditoria institucional. Apenas Administradores

Teclado Interativo Adaptativo por Perfil

Ao interagir com o bot, os botões interativos exibidos na tela são adaptados ao seu papel. Alunos contam com botões rápidos para Minhas aulas e Ajuda, sem qualquer risco de acesso a painéis de status ou métricas administrativas.

4. Lembretes e Notificações de Aula em Tempo Real

Ao vincular sua conta, as notificações começam desativadas por padrão para garantir total controle sobre seus alertas:

  1. Acesse Perfil → Configurações → MentoroBot no portal web do MentoraOS.
  2. Ative o interruptor Receber Notificações no Telegram.
  3. A partir desse momento, você receberá mensagens automáticas nas seguintes situações:
  4. Nova Aula Agendada: Notificação instantânea com título, horário e link da sala assim que o professor ou a coordenação marca o encontro.
  5. Lembrete de Início: Enviado com aproximadamente 1 hora de antecedência do início da aula confirmada, trazendo o link direto da sala virtual.
  6. Remarcação de Horário: Aviso imediato caso a data ou horário da aula sejam modificados, reprogramando automaticamente o lembrete de 1 hora.
  7. Cancelamento de Encontro: Aviso formal caso a aula seja cancelada, com exclusão automática de lembretes pendentes.

5. Como Desvincular sua Conta e Autodesativação Preventiva

Desvinculação Voluntária

Você pode interromper o recebimento de notificações ou trocar de aparelho a qualquer momento de duas maneiras:

  • Pelo Telegram: Envie simplesmente o comando canônico /sair na conversa com o bot @MentoraOSBot.
  • Pelo Portal Web: Acesse Perfil → Configurações → MentoroBot e clique no botão Desvincular conta.

O vínculo será removido de forma definitiva e o bot deixará de enviar alertas até que um novo pareamento seja realizado.

Autodesativação Preventiva por Bloqueio do Bot

O que acontece se você bloquear o bot ou excluir a conversa?

Caso você bloqueie o @MentoraOSBot no Telegram ou desative seu chat privado, a API do Telegram recusa as mensagens com erro de autorização (HTTP 403 Forbidden).

Para evitar tentativas repetidas e proteger sua conta, o MentoraOS desvincula o Telegram preventivamente e envia um e-mail transacional de aviso para o seu endereço cadastrado com o assunto "Sua conta do Telegram foi desvinculada do MentoraOS", contendo instruções e um link direto para reconfigurar o acesso quando desejar.

6. Proteção contra Sobrecarga (Rate Limiting)

Para assegurar estabilidade e prevenir disparos acidentais ou repetitivos no chat, o MentoroBot possui um limite defensivo de velocidade:

Aviso de Temporização

Se você enviar mensagens repetidas ou clicar excessivamente em botões em uma janela de 10 segundos, o bot responderá amigavelmente:
⏳ Muitas mensagens enviadas em pouco tempo. Por favor, aguarde um instante.
Basta aguardar alguns segundos para continuar utilizando o assistente normalmente.

7. Disponibilidade por Plano

O MentoroBot está disponível para instituições contratantes dos seguintes planos:

  • Plano Starter: Não inclui o assistente no Telegram.
  • Plano Pro: Inclui o MentoroBot completo para professores e até 30 alunos (lembretes automáticos e consulta de horários).
  • Plano Institucional: Suporta cotas ampliadas e integrações avançadas de alerta que estão em desenvolvimento constante.

7. Termos de Uso e Privacidade

O uso do assistente no Telegram está sujeito aos nossos termos específicos de segurança e privacidade de dados. Consulte o documento oficial em:

Termos de Uso e Privacidade do MentoroBot