Este projeto gerencia grupos do WhatsApp, gera resumos de mensagens e envia notificações. Ele é composto por vários módulos que interagem com a API Evolution para buscar dados dos grupos, processar mensagens e agendar tarefas.
- Gerenciamento de Grupos 🗂: Busca e armazena informações dos grupos.
- Geração de Resumos 📝: Cria resumos diários das mensagens dos grupos.
- Envio de Mensagens 💬: Envia mensagens de texto, áudio, imagem, vídeo e documentos para os grupos.
- Agendamento de Tarefas ⏰: Agendamento de tarefas para execução automática de scripts.
app.py: Interface principal usando Streamlit para interação com os grupos.group_controller.py: Controlador para gerenciar grupos e interagir com a API Evolution.group.py: Definição da classe Group.groups_util.py: Utilitários para manipulação de dados dos grupos.message_sandeco.py: Processamento de mensagens recebidas.summary.py: Script para gerar e enviar resumos.task_scheduler.py: Agendamento de tarefas no sistema operacional.send_sandeco.py: Envio de mensagens para os grupos.summary_crew.py: Configuração e execução de resumos usando CrewAI.save_groups_to_csv.py: Salva informações dos grupos em um arquivo CSV.
-
Instalar Dependências:
uv venv source .venv/bin/activate uv lock uv sync -
Configurar Variáveis de Ambiente: Crie um arquivo
.envcom as seguintes variáveis:EVO_BASE_URL=<sua_base_url> EVO_API_TOKEN=<seu_api_token> EVO_INSTANCE_NAME=<seu_instance_name> EVO_INSTANCE_TOKEN=<seu_instance_token>
-
Executar a Interface Principal:
uv run streamlit run app.py
-
Agendar Tarefas: Utilize o módulo
task_scheduler.pypara criar, listar e deletar tarefas agendadas.
Se quiser contribuir, faça um fork deste repositório, crie uma nova branch com suas modificações e abra um pull request para análise.
This project manage WhatsApp groups, generate message summaries, and send notifications. It consists of several modules that interact with the Evolution API to fetch group data, process messages, and schedule tasks.
- Group Management 🗂: Fetch and store group information.
- Summary Generation 📝: Create daily summaries of group messages.
- Message Sending 💬: Send text, audio, image, video, and document messages to groups.
- Task Scheduling ⏰: Schedule tasks for automatic script execution.
app.py: Main interface using Streamlit for group interaction.group_controller.py: Controller to manage groups and interact with the Evolution API.group.py: Definition of the Group class.groups_util.py: Utilities for handling group data.message_sandeco.py: Processing of received messages.summary.py: Script to generate and send summaries.task_scheduler.py: Task scheduling on the operating system.send_sandeco.py: Sending messages to groups.summary_crew.py: Configuration and execution of summaries using CrewAI.save_groups_to_csv.py: Save group information to a CSV file.
-
Install Dependencies:
uv venv source .venv/bin/activate uv lock uv sync -
Set Environment Variables: Create a
.envfile with the following variables:EVO_BASE_URL=<your_base_url> EVO_API_TOKEN=<your_api_token> EVO_INSTANCE_NAME=<your_instance_name> EVO_INSTANCE_TOKEN=<your_instance_token>
-
Run the Main Interface:
uv run streamlit run app.py
-
Schedule Tasks: Use the
task_scheduler.pymodule to create, list, and delete scheduled tasks.
If you want to contribute, fork this repository, create a new branch with your changes, and open a pull request for review.
de09f1804cd2cc86595c9cf6ff5c3350b0ad888d