89 lines
2.1 KiB
Markdown
89 lines
2.1 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|