Bot Telegram

O Bot Telegram do RR Flow permite executar comandos operacionais e receber gráficos diretamente no chat.

Ele é útil para:

• validar se o bot está ativo;
• descobrir IDs de usuário, grupo e tópico;
• executar teste de disco;
• solicitar gráficos processados;
• solicitar gráficos em dados crus.

Onde configurar

A configuração fica em /admin/notifications, no card Configuração do Telegram.

Como criar o bot

1. Acesse @BotFather.
2. Envie /newbot.
3. Defina o nome e o @username do bot.
4. Copie o token gerado.
5. Cole o token no campo Bot Token no RR Flow.

Como configurar no RR Flow

Na tela Configuração do Telegram, preencha:

• Bot Token: Token gerado pelo BotFather.
• Usuários autorizados para respostas: Lista de usuários, grupos ou tópicos que podem interagir com o bot.
• Testar bot: Envia uma mensagem de teste para um destino já cadastrado.

Na mesma tela, o card Opções de gráficos controla o visual dos gráficos enviados pelo bot, como tema, estilo da linha, preenchimento e qualidade da imagem.

Como funcionam os IDs

O RR Flow autoriza o bot por destino de chat.

• Chat privado: Use o ID do seu chat com o bot.
• Grupo inteiro: Use apenas o chat_id.
• Grupo com tópico específico: Use chat_id,topic_id.

Exemplos:

• Usuário ou chat privado: 200000000
• Grupo: -1000000000000
• Grupo com tópico: -1009999999999,20

Comportamento prático:

• Se você cadastrar só o chat_id do grupo, o bot pode responder no grupo inteiro.
• Se você cadastrar chat_id,topic_id, o bot responde apenas naquele tópico.

Como descobrir os IDs

Os comandos desta seção podem ser usados na etapa de configuração, para descobrir os IDs antes mesmo de começar a usar os demais comandos operacionais do bot.

Descobrir o ID do seu chat

Abra uma conversa privada com o bot e envie:

/meuid

Aliases aceitos:

• /myid
• /miid

Importante:

• Use esse comando na conversa privada com o bot quando quiser descobrir o seu ID de uso pessoal.
• Se você executar esse comando dentro de um grupo, o retorno será o ID do chat atual, não o seu ID privado.

Descobrir ID do grupo e do tópico

Dentro do grupo, ou dentro do tópico desejado, envie:

/idgrupo

Alias aceito:

• /groupid

Se a mensagem for enviada em um tópico, o bot retorna:

• Chat ID
• Topic ID

Como a lista de comandos aparece no Telegram

O Telegram mostra um conjunto principal de comandos no menu /, de acordo com o idioma atual do sistema.

No RR Flow, o menu principal registrado no Telegram usa:

• Português: /testedisco, /meuid, /idgrupo, /graficosdb, /graficoscru, /oi
• Espanhol: /pruebadisco, /miid, /idgrupo, /graficosdb, /graficoscru, /hola
• Inglês: /testdisk, /myid, /groupid, /dbcharts, /rawgraphics, /hello

Além desses, os aliases continuam funcionando mesmo quando não aparecem no menu do Telegram.

Comandos disponíveis

Validação do bot

• /oi
• /start
• /hello
• /hola

Uso:

• Verifica se o bot está pronto para uso.
• Esse comando só responde em chats autorizados.

Descoberta de ID

• /meuid
• /myid
• /miid

Uso:

• Mostra o ID do chat atual.
• Para descobrir o seu ID pessoal, execute em conversa privada com o bot.

Descoberta de grupo e tópico

• /idgrupo
• /groupid

Uso:

• Mostra o ID do grupo.
• Se a mensagem estiver em um tópico, também mostra o ID do tópico.
• Esse comando funciona apenas em grupos.

Cancelar um fluxo em andamento

• /cancelar
• /cancel

Uso:

• Cancela um fluxo de seleção aberto pelo bot, como escolha de categoria, source, interface, máscara ou tempo.

Teste de disco

• /testedisco
• /disktest
• /testdisk
• /pruebadisco

Uso:

• Executa um teste rápido de leitura e gravação em disco.
• O bot responde quando o teste terminar.

Observações:

• O teste roda um por vez.
• Se já houver um teste em execução, o bot pede para tentar novamente depois.

Gráficos processados

• /graficosdb
• /dbcharts
• /graficosbd

Uso:

• Gera gráficos a partir dos dados já processados e armazenados no banco.

Gráficos em dados crus

• /graficoscru
• /rawgraphics
• /graficosraw

Uso:

• Gera gráficos a partir dos dados crus, usando Meus Prefixos e seleção de interfaces.

Como funciona o comando /graficosdb

Quando você executa o comando, o bot monta um fluxo por etapas.

As categorias disponíveis dependem do que está ativo no sistema. As categorias suportadas hoje são:

• Análise de Tráfego
• CDNs
• AS Favoritos
• Prefixos Favoritos
• Serviços
• Protocolo
• Flags TCP
• Interfaces
• Países

Fluxo por categoria

• Análise de Tráfego: Escolha o filtro ativo, depois a source e depois o tempo.
• CDNs / AS Favoritos / Prefixos Favoritos / Serviços / Protocolo / Flags TCP: Escolha a source, depois Todos, Top 10 ou um item específico, depois o fluxo e por fim o tempo.
• Países: Escolha a source, depois Top 10 ou Top 20, depois o fluxo e por fim o tempo.
• Interfaces: Escolha a source, depois o escopo das interfaces, depois o fluxo e por fim o tempo.

Escolhas possíveis em interfaces

Na categoria Interfaces, o bot pode pedir:

• Todas
• Todas Upstream
• Todas Downstream
• Informar manual

Se você escolher Informar manual, o bot lista as interfaces numeradas e você responde com os números separados por espaço.

Exemplo:

2 5 6

Escolha do fluxo

Nos gráficos processados, quando aplicável, o bot permite:

• RX (Recebe)
• TX (Transmite)
• RX+TX (Recebe e Transmite)

Janela de tempo

O comando aceita os botões de tempo e também entrada textual.

Exemplos aceitos:

• 30m
• 2h
• 1d

Faixa aceita:

• mínimo de 1m
• máximo de 14d

Quando a categoria não aparece

O bot só oferece categorias que realmente têm base ativa no sistema.

Exemplos:

• Análise de Tráfego só aparece se houver filtros ativos e habilitados.
• As demais categorias dependem de fontes ativas e da configuração de gráficos processados.

Como funciona o comando /graficoscru

Hoje esse comando gera gráfico do tipo Meus Prefixos.

O fluxo é:

1. Escolher a source.
2. Escolher as interfaces.
3. Escolher o tipo do gráfico.
4. Escolher IPv4 ou IPv6.
5. Escolher a máscara.
6. Escolher o fluxo.
7. Escolher o tempo.

Escolha das interfaces

O bot oferece:

• Todas Upstream
• Todas Downstream
• Informar manual

Se você escolher Informar manual, o bot lista as interfaces numeradas e você responde com os números separados por espaço.

Tipo do gráfico

Atualmente o comando segue para:

• Meus Prefixos

Esse modo usa os prefixos cadastrados em /admin/my-isp.

Família e máscara

Depois de escolher Meus Prefixos, o bot pede:

• IPv4 ou IPv6
• a máscara desejada

Atalhos oferecidos pelo bot:

• IPv4: /22, /23, /24, /25
• IPv6: /32, /33, /34, /35

Também existe a opção Informar manual.

Na entrada manual, o sistema aceita uma máscara válida para a família escolhida.

Fluxo do gráfico

O bot permite:

• RX (Recebe)
• TX (Transmite)
• RX+TX (Recebe e Transmite)

Janela de tempo

Exemplos aceitos:

• 30m
• 2h
• 1d

Faixa aceita:

• mínimo de 1m
• máximo de 1d

Pré-requisitos para os gráficos

Para o bot conseguir gerar gráficos corretamente, verifique:

• /graficosdb: a categoria precisa estar disponível para alguma fonte ativa.
• /graficoscru: a source precisa ter interfaces carregadas.
• /graficoscru com Meus Prefixos: os prefixos precisam estar cadastrados em /admin/my-isp.

Problemas comuns

• O bot não responde a /oi ou /start: confira o Bot Token e se o chat está cadastrado em Usuários autorizados para respostas.
• /graficosdb não mostra categorias: valide se existem filtros ativos de análise de tráfego ou gráficos processados configurados para fontes ativas.
• /graficoscru não mostra interfaces: revise a source em /admin/sources e confirme se as interfaces já foram carregadas.
• /graficoscru retorna erro em Meus Prefixos: confira se existem prefixos cadastrados em /admin/my-isp para a família escolhida.
• O teclado parou de funcionar: envie /cancelar e inicie o comando novamente.
• Um botão antigo retorna opção expirada: refaça o comando; o fluxo do bot expira após alguns minutos sem interação.