How bernardo-s-oliveira/bot-telegram works
Este é um bot local de ofertas para Telegram, com coleta automática em Mercado Livre, Shopee e Amazon e conversão manual de links enviados no privado. No ciclo automático, coleta e enriquecimento alimentam filtros, validação de histórico e seleção; as ofertas escolhidas são formatadas, publicadas nos destinos configurados e registradas para evitar repetição e acompanhar preços. O painel local oferece configuração, testes de fontes e controle do bot. As relações refletem o README e os trechos amostrados; ligações de subsistemas não amostrados foram omitidas quando não era possível confirmar o chamador.
Main entry points: pipeline.py Ciclo automático · __init__.py Roteador de fontes · bot_interativo.py Bot interativo · main.py Comandos do bot
Components 22
Interfaces e execução
- Comandos do bot
ofertas/main.py - Painel local
ofertas/painel.py - Interface web
ofertas/painel_html.py - Bot interativo
ofertas/bot_interativo.py - Configuração
ofertas/config.py
Coleta e afiliados
- Ciclo automático
ofertas/pipeline.py - Roteador de fontes
ofertas/sources/__init__.py - Mercado Livre
ofertas/sources/mercadolivre.py - Shopee
ofertas/sources/shopee.py - Amazon
ofertas/sources/amazon.py - Pedidos de clientes
ofertas/pedidos.py
Qualidade e seleção
- Destinos e divisão
ofertas/destinos.py - Filtros e score
ofertas/selecao.py - Mix de categorias
ofertas/mix.py - Tipos e nichos
ofertas/tipos.py
Publicação e estado
- Histórico e posts
ofertas/db.py - Formatador de ofertas
ofertas/formatter.py - Publicador Telegram
ofertas/telegram_poster.py
Other components
- Operador
- Usuário Telegram
- Telegram
- Lojas e APIs
Connections 28
- Operador → Painel local: configura e controla
- Painel local → Interface web: serve interface
- Painel local → Configuração: grava configuração
- Operador → Comandos do bot: executa comandos
- Comandos do bot → Ciclo automático: inicia ciclo
- Comandos do bot → Bot interativo: inicia conversor
- Bot interativo → Roteador de fontes: detecta link
- Roteador de fontes → Mercado Livre: encaminha URL
- Roteador de fontes → Shopee: encaminha URL
- Roteador de fontes → Amazon: encaminha URL
- Ciclo automático → Mercado Livre: coleta ofertas
- Ciclo automático → Shopee: coleta ofertas
- Ciclo automático → Amazon: coleta ofertas
- Mercado Livre → Lojas e APIs: consulta e gera links
- Shopee → Lojas e APIs: consulta API
- Amazon → Lojas e APIs: consulta API e páginas
- Ciclo automático → Pedidos de clientes: avalia pedidos
- Ciclo automático → Histórico e posts: lê e grava histórico
- Ciclo automático → Destinos e divisão: divide ofertas
- Ciclo automático → Filtros e score: filtra e pontua
- Ciclo automático → Mix de categorias: equilibra categorias
- Ciclo automático → Tipos e nichos: classifica produtos
- Ciclo automático → Formatador de ofertas: formata selecionadas
- Ciclo automático → Publicador Telegram: envia publicações
- Publicador Telegram → Telegram: publica mensagens
- Bot interativo → Telegram: recebe e responde
- Usuário Telegram → Bot interativo: envia link
- Configuração → Ciclo automático: fornece opções