Bot da Agenda do grupy-sanca

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

Funcionalidades

Comandos:

• /start: Inicia o bot e mostra os comandos disponíveis
• /proximo: Mostra o próximo evento
• /agenda: Mostra todos os eventos do ano (permite filtrar por intervalos)

Filtros disponíveis pro agenda: mensal, semanal, hoje e n próximos eventos.

Exemplos de uso:

/agenda@id_do_bot semanal
/agenda@id_do_bot 3

Comandos de administrador:

• /force_update: Força a atualização dos eventos, útil para quando um evento é adicionado ou removido manualmente

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

Em grupos com tópicos ativados, é possível definir o tópico onde o bot enviará as mensagens agendadas.

Configure a variável de ambiente GROUP_CHAT_TOPIC_ID com o ID do tópico desejado.

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:

# TOKEN do seu bot gerado pelo BotFather
TELEGRAM_BOT_TOKEN=
# Sistema de eventos a ser utilizado (Meetup ou Open Event)
EVENT_EXTRACTOR=<meetup ou open_event>
# URL para extrair os eventos (Meetup ou Open Event)
URL=
# ID do grupo no Telegram onde o bot mandará as mensagens agendadas
GROUP_CHAT_ID=
# ID do tópico do grupo no Telegram onde o bot mandará as mensagens agendadas (opcional)
GROUP_CHAT_TOPIC_ID=
# Lista de IDs de usuários do Telegram que podem usar comandos como o `/force_update` (opcional)
ADMINS=[]

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