Aqui existe e vive um projeto INTERMEDIÁRIO em estágio de desenvolvimento de um bot do Telegram! - EBA!!!
Tecnologias/libs usadas e requiridas:
- Python 3.8 ou superior
- asyncio (nativo)
- hashlib (nativo)
- sqlite3 (nativo)
- os (nativo)
- python-telegram-bot (lib)
- python-dotenv (lib)
- Docker (uso da tecnologia de container, para deploy em VPS)
Para executar esse projeto em ambiente local, você deve seguir os seguintes passos:
Copie o arquivo .env.example e renomeie a cópia para .env e substitua os valores necessários para rodar a aplicação
OU
Crie um arquivo .env e preencha as variáveis vazias no arquivo:
BOT_CLIENT_ID=
BOT_SECRET_KEY=
PROPOSALS_CHAT_ID=
OWNER_USER_ID=
OBS 1: É necessário obter o id do telegram de um grupo para usar na variável de PROPOSALS_CHAT_ID. Existem bots no próprio telegram que conseguem obter essa informação para você.
OBS 2: É necessário obter o id da conta do telegram para usar na variável de OWNER_USER_ID. Existem bots no próprio telegram que conseguem obter essa informação para você.
OBS 3: Não é necessário executar o bot em um ambiente Docker localmente. Serve mais para realizar o deploy em uma VPS privada / servidor remoto.
VOALÁ! - O projeto já está sendo executado na sua máquina!
Abaixo segue uma lista dos comandos disponíveis do bot até o exato momento:
| Comando | Público? | Descrição |
|---|---|---|
| start | Sim | Inicializa o bot e mostra as opções disponíveis. |
| subscribenewsletter | Sim | Assina a newsletter de novidades do criador do bot. |
| unsubscribenewsletter | Sim | Remove a assinatura da newsletter de novidades do criador do bot. |
| listsubscribers | Não | Mostra uma lista (se tiver) de usuários inscritos na newsletter do ADM do bot. |
| sendNewsletterToSubscribers | Não | Permite enviar um anúncio através do bot, para todos os assinantes do bot. |
| portfolio | Sim | Mostra uma mensagem a respeito de onde você pode encontrar informações sobre o portfolio do criador do bot como dev. |
| help | Sim | Mostra a lista de comandos disponíveis para você utilizar ;) |
O bot principal do projeto já está funcional e você pode interagir com ele através do link abaixo:
OBS: Nesse projeto, vem incluso uma Action para realizar o deploy diretamente no servidor.
Se você desejar realizar o FORK desse projeto, lembre-se de criar as variáveis SECRETS (para Actions) para que tudo funcione bem.
A variáveis de SECRETS são necessárias para realizar o deploy de sua aplicação diretamente em um servidor de sua posse (ou que você tenha acesso).
As variáveis necessárias são:
BOT_CLIENT_ID (correspondente ao ID do seu bot do telegram - é a parte antes dos dois pontos ":")
BOT_SECRET_KEY (correspondente ao token/secret_key do seu bot do telegram - é a parte depois dos dois pontos ":")
PROPOSALS_CHAT_ID (correspondente ao ID do grupo onde você receberá as propostas enviadas por outros usuários)
OWNER_USER_ID (correspondente ao ID do usuário que será o ADM do bot, em questão)
REMOTE_DOCKER_HOST (correspondente ao endereço/ip do host remoto para acesso via SSH)
REMOTE_DOCKER_USER (correspondente ao usuário do host remoto para acesso via SSH)
S_PASSPHRASE (correspondente a passphrase/senha da sua chave SSH para acesso ao host remoto)
S_PRIVATE (correspondente a chave privada para acesso ao host remoto via SSH)