rodrigonet/CONFIGURACAO.md

Configuração do Bot de Telegram

Passo 1: Obter Token do Bot

1. Abra o Telegram e procure por @BotFather
2. Digite /newbot e siga as instruções
3. Escolha um nome para seu bot (ex: "Bot de Ajuda Rede")
4. Escolha um username (ex: "bot_ajuda_rede_bot")
5. Copie o token fornecido pelo BotFather

Passo 2: Configurar o arquivo .env

1. Abra o arquivo .env na raiz do projeto
2. Cole o token do bot:

TELEGRAM_BOT_TOKEN=1234567890:AABBCCDDEEFFgghhiijjkkllmmnnoopp

Passo 3: Obter seu ID do Telegram (opcional - para restringir acesso)

1. No Telegram, procure por @userinfobot
2. Digite /start
3. Copie seu ID numérico
4. Adicione no arquivo .env:

ALLOWED_USERS=123456789

Passo 4: Instalar dependências e executar

npm install
npm start

Comandos de Teste

Após o bot estar rodando, teste no Telegram:

Comandos básicos:

• /start - Iniciar o bot
• /help - Ver ajuda
• /equipamentos - Listar equipamentos

Desconectar usuários (Juniper):

• "desconectar cliente joao123"
• "kick usuário maria456"
• "expulsar cliente teste"

Listar usuários:

• "listar usuários conectados"
• "mostrar clientes"

SSH:

• "ssh juniper"
• "conectar concentrador"

Status:

• "verificar status concentrador"
• "status juniper"

Equipamentos Configurados

• juniper - Concentrador Juniper (131.0.192.254)
• concentrador - Alias para o Juniper
• router1 - Router exemplo (192.168.1.1)
• switch1 - Switch exemplo (192.168.1.10)

Comandos Juniper Suportados

• clear network-access aaa subscriber USUARIO - Desconectar usuário
• show network-access aaa subscribers - Listar usuários conectados

Troubleshooting

Bot não responde:

1. Verifique se o token está correto no .env
2. Verifique se não há erros no console
3. Teste com /start

Erro de SSH:

1. Verifique se o IP 131.0.192.254 está acessível
2. Teste credenciais manualmente
3. Verifique firewall/portas

Bot responde "sem permissão":

1. Adicione seu ID no ALLOWED_USERS no .env
2. Ou remova a linha para permitir todos os usuários