O Bot do Afiliado usa um motor de conversão único, compartilhado pelo bot do Telegram e pela API. Ele é organizado em duas peças: conversores (plugins) e rotas.
Conversores (plugins)
Um conversor sabe transformar a URL de uma loja ou rede no seu link de afiliado. Cada conversor tem:
- um provider (ex.:
api_v2para AliExpress,shopee,amazon,awin,rakuten); - suas credenciais (
credentials_json) — appKey/secret, publisherId, partnerTag, etc.; - um tracking ID padrão (seu identificador de afiliado);
- uma prioridade (para desempate quando vários cobrem o mesmo domínio).
Há dois tipos de comportamento:
- API / Híbrido: chama uma API externa para gerar o link e/ou buscar dados do produto (ex.: AliExpress, Shopee, Amazon).
- Substituição/Parâmetros: apenas normaliza a URL e injeta parâmetros/deeplink, sem API (ex.: Awin, Rakuten, Terabyte, Pague Menos).
Rotas
Uma rota liga um domínio (ex.: aliexpress.com.br) a um conversor. Quando um link chega:
- O bot resolve redirecionamentos e encurtadores até a URL real.
- Procura a rota que cobre aquele domínio (respeitando a prioridade).
- Usa o conversor da rota para gerar o
affiliate_url. - Aplica a política de encurtamento e devolve o
final_url.
Ao ativar/salvar um plugin, o sistema cria as rotas automaticamente para os domínios padrão daquele provider — você não precisa cadastrar domínio por domínio.
📸 Print sugerido: aba Rotas mostrando domínio → conversor → prioridade.
Dados do produto e histórico de preço
Quando o provider permite, o motor também extrai título, preço e imagem e grava o histórico de preços. Se o plugin não tiver busca própria, há um fallback por HTML (JSON-LD/OpenGraph).
Próximos passos
- Veja como ativar um plugin (passo a passo genérico).
- Configure uma loja específica: AliExpress, Amazon, Shopee.