Ativar uma integração é rápido e parecido para todas as lojas. Cada loja tem o seu guia dizendo exatamente o que colar (ex.: AliExpress) — aqui é o passo a passo geral.
Passo a passo
- Abra a aba Plugins no painel do seu bot.
- Escolha a loja ou rede em que você é afiliado.
- Preencha as credenciais (cada loja tem um guia próprio dizendo o que colar — veja a tabela no fim).
- Informe o tracking ID padrão (o seu identificador de afiliado).
- Clique em Validar para testar e depois em Salvar.
Pronto! A partir daí o bot já reconhece e converte os links daquela loja sozinho — você não precisa configurar mais nada.
A validação confere se a sua credencial funciona, buscando os seus programas/produtos na rede — não precisa de link de teste. Se aparecer um aviso de checagem pulada, é normal e não impede o uso.
O que cada loja pede (referência rápida)
| Provider | Campos principais | Obs. |
|---|---|---|
| AliExpress | appKey, appSecret | + tracking ID (PID) |
| Amazon (PA-API) | accessKeyId, secretAccessKey, partnerTag | Seletor “Fonte dos dados” = PA-API. Região/marketplace pré-configurados para BR |
| Amazon (Creators) | credentialId, credentialSecret, partnerTag | Seletor “Fonte dos dados” = Creators API. Versão 2.1 pré-configurada |
| Amazon (Gerenciado) | partnerTag, cookie | Usa cookie de sessão para validar |
| Shopee | appId, secret | |
| Awin | publisherId, accessToken, countryCode | Lojas (advertisers) importadas automaticamente ao salvar |
| Rakuten | SID, App ID, App Secret | Token gerado automático. Lojas importadas automaticamente ao salvar |
| CityAds | clientId, clientSecret, remoteAuth | Sync automático de lojas BR. Gera deeplinks |
| Magalu | promoterId (detectado via link) | Cole um link de afiliado seu — o ID é detectado automaticamente |
| Mercado Livre | tag, cookie | |
| Terabyte | p (ID afiliado), utmMedium, utmCampaign | |
| Pague Menos | consultorCode | Só o código do consultor; o resto é automático |
| Braé | parceiro, cupom (opcional) | |
| Beleza na Web | utmCampaign (código do consultor), cupom (opcional) | utm_source/medium/content fixos |
| Natura | consultoria, cupom (opcional) |
Você nunca precisa configurar rotas na mão — ao salvar qualquer plugin, os links daquela loja já passam a ser reconhecidos sozinhos. Awin, Rakuten e CityAds ainda puxam o catálogo inteiro de lojas da rede automaticamente. Onde pegar cada credencial está no guia de cada loja.
Validar e testar
Alguns providers permitem informar uma URL de amostra (ou ID de produto) para testar a conversão na hora. Se a validação passar, está tudo certo para converter no Telegram e na API.