Hero Ofertas
Construí o Hero Ofertas para reunir ofertas e cupons em um catálogo com curadoria por desconto, histórico de preços e publicação automática no Telegram e no Discord.
Importa ofertas de sete redes e lojas por drivers com contrato comum, e as reúne em um catálogo único com categorias e lojas próprias.
Pisos de desconto geral, por categoria e por loja: vale o mais rígido, na vitrine e na fila de divulgação.
Cada mudança de preço gera uma linha, que alimenta o gráfico da oferta, o selo de menor preço e a página de quedas.
Cupons da Lomadee e 14 datas de campanha calculadas por ano, com banner, página própria e selo nos cards.
Fila que publica no Telegram e no Discord por segmento, horário e intervalo, com padrões de mensagem editáveis.
Dicionário que reconhece termos no nome e na marca e compõe a descrição das ofertas que chegam sem texto.
Cinco guias com ofertas do catálogo, perguntas frequentes, dados estruturados e preços conferidos antes de publicar.
API REST com token e cota diária para produtos, vitrine, categorias, lojas, cupons e conversão de links.
Portal de ofertas sobre o NoName
Desenvolvi o Hero Ofertas, em heroofertas.com.br, como um portal de ofertas e cupons de lojas parceiras. Quem consulta o site encontra preços, histórico por produto, guias de compra e canais públicos. No levantamento de 17/10/2026, as listas públicas reuniam 3.424 ofertas, e a faixa de parceiros da home mostrava 17 lojas.
Construí o portal sobre o NoName, minha plataforma modular multi-organização. Os módulos de afiliados, site, blog, contato e e-mails sustentam a publicação e a administração. As ofertas vêm de redes de afiliados e lojas de jogos, com importações periódicas pelo agendador do NoName. O portal recebe comissão pelas compras feitas pelos links de afiliado, mantendo o mesmo preço para o comprador. Steam e Epic Games usam links diretos das lojas, sem programa de afiliados.
Redes de afiliados e lojas de jogos ↓ Importação pelos drivers ↓ Catálogo único de ofertas ↓ Vitrine pública ↓ Canais e API
Sete redes e lojas em um catálogo
Organizei as integrações do Hero Ofertas em drivers com um contrato comum: testar conexão, importar ofertas e gerar links de afiliado. Cada fonte tem seu formato e sua frequência padrão.
| Rede | Fonte | Frequência de sincronização |
|---|---|---|
| Awin | Datafeed CSV, com leitura em fluxo | 30 minutos |
| Lomadee | API REST | 45 minutos |
| AliExpress | SDK oficial | 240 minutos, uma promoção nova por execução |
| Shopee | API GraphQL | 120 minutos |
| Steam | API pública de destaques | 360 minutos |
| Epic Games | API pública de jogos grátis | 360 minutos |
| GOG | Página de giveaway | Sob demanda |
O catálogo de redes faz uma varredura diária e preserva o identificador e o nome de lojas e categorias na origem. Pelo painel, o administrador escolhe o que importar, inclusive por exclusão.
Criei regras para ligar categorias da rede, ou palavras do nome da oferta, às categorias próprias. A regra da organização tem prioridade sobre a padrão. A instalação inclui 60 categorias com emoji. Na Shopee, cada vendedor entra como loja filha do marketplace.
Piso de desconto geral, por categoria e por loja
Implementei no Hero Ofertas três pisos percentuais de desconto: geral da organização, por categoria e por loja. Para cada oferta, vale o maior percentual exigido entre os três. O cálculo usa os preços recebidos: preço antigo menos preço atual, dividido pelo preço antigo.
Esse piso determina quais ofertas aparecem na vitrine, nas contagens de categorias e lojas e no sitemap. Também controla a entrada na fila de divulgação. Assim, a mesma regra orienta a seleção pública e a publicação nos canais.
Jogos grátis contam como desconto de 100% e passam pelo filtro. Ofertas sem preço original também passam na vitrine. Mantive todas as ofertas disponíveis no painel administrativo e preservei o acesso direto às páginas, inclusive quando o desconto fica abaixo do piso, para conservar os links já publicados.
Histórico de preços e selo de menor preço
Usei a própria tabela de ofertas como histórico de preços do Hero Ofertas. Quando o preço muda, o sistema desativa a linha anterior e grava outra, mantendo uma linha ativa por oferta. Preço igual conserva o registro existente. Se uma oferta sai da rede e retorna pelo mesmo valor, a linha correspondente é reativada.
Preço inicial → primeira linha ativa ↓ Mudança de preço → linha anterior desativada + nova linha ativa ↓ Outra mudança → linha anterior desativada + nova linha ativa
Desenhei o gráfico em SVG no servidor, sem biblioteca de gráficos e sem JavaScript: o valor e a data de cada ponto aparecem ao passar o mouse, focar pelo teclado ou tocar. Ele só aparece com dois preços distintos, e a janela padrão é de 12 meses, configurável de 1 a 36.
O selo aparece quando o preço atual é o menor da janela, que por padrão é de 3 meses (configurável de 1 a 36), e a oferta tem mais de um ponto de preço. Ele diz desde quando o preço é o menor, como em “Menor preço desde 12/10”, ou, quando nunca esteve mais alto, “Menor preço em 3 meses”. Os selos de uma tela saem de uma única consulta ao banco.
A página “Produtos com queda de preço” ordena as ofertas pela redução em relação ao pico dos últimos seis meses.
Cupons e campanhas por calendário
Integrei os cupons do Hero Ofertas à Lomadee, com sincronização a cada 60 minutos e filtro por loja na página pública. A exibição considera a presença do cupom na rede nos últimos dois dias e sua data de término, quando informada. Uma rodada com erro preserva os registros.
Implementei o cálculo anual de 14 datas: Dia do Consumidor, Páscoa, Dia das Mães, Dia dos Namorados, Dia dos Pais, 9.9, 10.10, Dia das Crianças, 11.11, Black Friday, Cyber Monday, 12.12, Natal e Volta às aulas. A criação preserva as edições feitas pelo administrador.
Cada campanha tem paleta de cores, faixa na home, página própria e selo nos cards. As regras combinam desconto mínimo, lojas, categorias e palavras.
O estado da campanha é calculado pelo relógio em America/Sao_Paulo: agendada, em breve, no ar ou encerrada. Ao encerrar, a página recebe aviso e noindex. O painel também permite cadastrar campanhas manualmente e ativar ou desativar cada uma.
Divulgação automática e bot do Telegram
Desenvolvi a fila do Hero Ofertas para enviar ofertas com foto ao Telegram e com embed ao Discord. A tarefa roda a cada minuto. Cada canal tem segmento (nacionais, internacionais, jogos ou todas), janela de horário e intervalo entre publicações.
Usei o relógio do banco para esses controles, pois o fuso do PHP diverge entre a execução web e a linha de comando. A mesma oferta com o mesmo preço, publicada nos últimos sete dias, vai para “Repetida” com o motivo registrado. Três falhas de envio encerram as tentativas daquele item.
Os textos vêm de padrões editáveis com campos entre chaves. Regras selecionam o padrão conforme a oferta e o canal, e há um padrão marcado como seguro.
O bot do Telegram converte links do AliExpress e da Shopee em links de afiliado da organização. Seu token é cifrado, e o webhook valida um segredo por comparação segura. A página de canais e o banner da home também apresentam os canais públicos de Telegram, WhatsApp e Discord.
Descrição gerada por dicionário
Criei um dicionário para compor descrições no Hero Ofertas, porque a maior parte das ofertas chega das redes sem descrição. A instalação inclui 144 definições, e os termos cadastrados pela organização têm prioridade.
O sistema normaliza nome e marca para minúsculas e remove acentos antes da comparação. A correspondência respeita limites de palavra: “4k” não casa com “24kg”. O símbolo % funciona como curinga entre palavras. Quando há termos sobrepostos, prevalece o mais específico.
A composição entra quando a descrição recebida tem menos de 60 caracteres úteis, respeitando a ficha da rede e a edição manual. O texto é montado na consulta à página, portanto uma alteração no dicionário atualiza as descrições correspondentes. Incluí um testador no painel e a divisão das descrições longas da loja em parágrafos.
SEO técnico e dados estruturados
Implementei no Hero Ofertas títulos e descrições de busca a partir dos dados do catálogo. O título usa até 38 caracteres antes do nome do site; a descrição, até 155. Os campos podem incluir quantidade de ofertas, lojas, preço e desconto. Categorias e lojas recebem H1, apresentação e canonical próprios.
| Página | O que sai |
|---|---|
| Home | Organization e WebSite |
| Oferta | Product com oferta, marca, sku e imagem; BreadcrumbList |
| Primeira página de lista, categoria e loja | index,follow; ItemList nas listagens |
| Página 2 em diante, busca e filtros | noindex,follow |
| Oferta expirada | noindex,follow |
Cada página tem canonical. O Product informa preço, moeda, disponibilidade, vendedor e validade do preço. O sitemap inclui a data da última alteração em cada entrada.
Configurei as seis primeiras imagens de cada página para carregar diretamente, com prioridade alta na primeira. As demais usam carregamento adiado e decodificação assíncrona. Em 17/10/2026, acrescentei título, descrição, H1 e imagem de compartilhamento à home e passei a emitir lastmod.
Guias de compra pensados para buscadores e assistentes de IA
Publiquei cinco guias no blog do Hero Ofertas: fone Bluetooth, notebook para trabalho e estudo, microfone para podcast e live, caixa de som Bluetooth e compras no AliExpress. Escolhi os temas pelas categorias com mais ofertas. Cada texto tem entre 1.240 e 1.440 palavras.
Os guias começam com uma resposta curta e usam perguntas de busca nos títulos. Incluem tabela de ofertas, cards com miniatura, nome, preço e loja, perguntas frequentes e uma seção sobre o levantamento. Essa seção informa data, comissão e uso de fotos geradas por IA para ilustrar a categoria.
Leitura dos produtos publicados e das estatísticas do catálogo ↓ Texto pelo ChatGPT com fatos e marcadores numéricos ↓ Substituição dos marcadores pelos valores do dia ↓ Validação de pontuação, links, título e faixa de preços
O gerador recusa travessão, links fora da lista, título de busca acima de 38 caracteres e preços incompatíveis com a faixa declarada. Os valores publicados representam a data do levantamento.
Incluí BlogPosting, BreadcrumbList e FAQPage, com perguntas extraídas do texto visível. A atualização segue para sitemap, API e head. Cada postagem mostra três sugestões de leitura, escolhidas por etiquetas e categoria, com desempate pela data.
Tema e páginas do site
Desenvolvi o tema Hero Ofertas para o módulo Site do NoName, com modos claro e escuro. A versão atual é a 2.8.0.
Organizei a home nesta sequência: banner, faixa de campanhas, ofertas nacionais, convite para o Telegram, jogos em promoção, canais disponíveis, ofertas internacionais, cupons e conteúdos recentes do blog. Os textos do banner do canal podem ser editados pelo painel.
Os cards de oferta mostram o selo de campanha, quando a oferta cumpre a regra, e o de menor preço, quando o histórico permite. Para o blog, criei modelos de guia e listagem. O guia usa uma caixa de 1320 px, texto em medida de leitura de 1040 px, trilha de navegação e data de atualização.
O tema também inclui página 404, Sobre, Contato com formulário, Privacidade, Termos e Planos. No Hero Ofertas, a página Planos está oculta.
Painel e saúde das integrações
Organizei a administração do Hero Ofertas no menu Afiliados, com 16 telas:
- Visão geral, Ofertas, Cupons e Campanhas.
- Fila de divulgação, Integrações, Catálogo de redes e Bot Telegram.
- Canais de envio, Canais públicos, Mensagens e Configurações.
- Status, Lojas, Categorias e Dicionário.
Cada sincronização registra seu resultado. Na terceira falha consecutiva, os administradores recebem uma notificação no sino, com envio opcional por e-mail. Outra notificação informa a recuperação da rede.
A verificação de saúde roda a cada 60 minutos e também identifica integrações que passaram mais de duas vezes seu intervalo sem sincronizar. Na tela Status, o último erro aparece com data. Depois que a rede volta, ele continua na tela, marcado como “Erro anterior, já superado”.
Releases, testes e instalação
Construí a atualização do NoName por pacotes assinados, distribuídos por uma central e recebidos pela tela Atualizações, com conferência de integridade por sha256. Os instaladores dos módulos são idempotentes: criam estruturas ausentes e avançam colunas, índices e tabelas.
Antes de cada versão, executo uma bateria automatizada com 187 suítes. Na versão atual, todas foram aprovadas. Também uso um conferidor de módulos e temas.
As tabelas de conteúdo identificam a organização dona, enquanto lojas e categorias podem ser compartilhadas. As credenciais das redes são cifradas por organização. O Hero Ofertas opera uma organização sobre essa base.
O núcleo cuida de autenticação, usuários, organizações, permissões, módulos, atualização e agendamento. Mantive a regra de negócio nos módulos. Em 17/10/2026, o portal usava NoName 1.50.1, Sistema de Afiliados 3.14.0, Site 1.26.0, Blog 1.10.0, Contato 1.8.0 e E-mails 2.10.0.
Na importação, falhas passageiras recebem nova tentativa após dois segundos, com limite de três repetições por execução.
API REST e planos do módulo
Expus no módulo Sistema de Afiliados uma API REST por organização, autenticada por token e sujeita a cota diária. Os endpoints atendem produtos com filtros e paginação, consulta de produto, vitrine agrupada por segmento, categorias, lojas, cupons e conversão de links.
O endpoint converter-link trabalha com endereços do AliExpress e da Shopee. Método incorreto recebe 405 e preserva a cota. A ausência de plano com API resulta em 403; o esgotamento da cota, em 429.
Estruturei os planos Grátis, Pro e Business com limites de redes, ofertas, canais, bot, postagem automática e API. Esses limites fazem parte do módulo que usei para construir o Hero Ofertas. No portal, a página Planos está oculta, e os recursos públicos apresentados são o catálogo, os cupons, os canais e os guias de compra.
Como foi construído
Desenvolvi o Hero Ofertas com PHP 8 sobre o núcleo próprio do NoName, usando módulos para a regra de negócio e um tema próprio para as páginas públicas.





