README.md

Bot da Agenda do grupy-sanca

Bot desenvolvido para divulgar os eventos do Meetup no grupo do grupy-sanca no Telegram.

Funcionalidades

Comandos:

• /start: Inicia o bot e mostra os comandos disponíveis
• /agenda: Mostra todos os eventos do Meetup no intervalo de 1 ano
• /proximo: Mostra o próximo evento do Meetup

Cron Jobs

• Segunda-feira às 9h: O bot envia uma mensagem com os eventos da semana
• Todos os dias às 12h: O bot envia uma mensagem caso haja um evento no dia

Instruções de desenvolvimento

1. Instale o uv
2. Instale as dependências do projeto com o comando uv sync
3. Ative o ambiente virtual com o comando source .venv/bin/activate
4. Crie um arquivo .env na pasta grupy_sanca_agenda_bot com as seguintes variáveis de ambiente:

TELEGRAM_BOT_TOKEN=<TOKEN do seu bot gerado pelo BotFather>
MEETUP_GROUP_URL=<URL do grupo no Meetup onde estão os eventos>
GROUP_CHAT_ID=<ID do grupo no Telegram onde o bot mandará as mensagens>
ADMINs=[<lista de IDs opcionais do telegram que podem usar comandos como o /force_update>]

5. Rode o bot com o comando uv run start-bot