Bot do Afiliado

Como funcionam os plugins e as rotas de conversão de links

Entenda o motor de conversão do Bot do Afiliado — plugins (conversores), rotas por domínio, prioridade, credenciais e encurtamento de links.

Nesta página

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_v2 para AliExpress, shopee, amazon, awin, rakuten);
  • suas credenciais — 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:

  1. O bot resolve redirecionamentos e encurtadores até a URL real.
  2. Procura a rota que cobre aquele domínio (respeitando a prioridade).
  3. Usa o conversor da rota para gerar o affiliate_url.
  4. 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.

Aba Rotas do painel mostrando os domínios mapeados para conversores com prioridade

Dá para testar uma URL na hora pelo painel: cole o link e veja por qual rota/conversor ele passa e qual link de afiliado sai.

Widget Testar URL no painel: campo para colar uma URL e um telegram_user_id opcional, com o botão Testar

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

Perguntas frequentes

Qual a diferença entre plugin (conversor) e rota no Bot do Afiliado?

O plugin (conversor) sabe gerar o link de afiliado de uma loja/rede e guarda suas credenciais. A rota diz "links deste domínio devem usar este conversor". Ao salvar um plugin, as rotas dos domínios dele costumam ser criadas automaticamente.

O que acontece quando dois conversores de afiliado cobrem o mesmo domínio?

A prioridade decide. A rota com menor número de prioridade é avaliada primeiro. Você ajusta isso na aba Rotas.

E se o link for de uma loja sem plugin ou rota configurada no Bot do Afiliado?

O bot tenta extrair dados via HTML (título/preço/imagem) quando possível, mas não gera link de afiliado sem uma rota/conversor ativo. Esses casos aparecem em "Não mapeados".

O Bot do Afiliado encurta os links de afiliado gerados?

Depende do provider e da sua configuração. Alguns plugins encurtam por padrão (ex.: Amazon via amzn.to); outros usam o encurtador do bot.

Pronto para automatizar suas comissões?

Crie seu bot, conecte suas integrações e comece a converter links em segundos.

Criar meu bot Ver módulos e preços