Este é o fluxo genérico para ativar qualquer integração. Os campos específicos de cada loja/rede estão nos guias individuais (ex.: AliExpress).
Passo a passo
- Abra a aba Plugins no painel do seu bot.
- Escolha o provider (a loja/rede em que você é afiliado).
- Cole as credenciais no campo JSON de credenciais (
credentials_json). Os campos variam por provider — veja a matriz abaixo. - Informe o tracking ID padrão (seu identificador de afiliado).
- Ajuste a prioridade se necessário (padrão costuma servir).
- Clique em Validar para testar e depois em Salvar.
Ao salvar, as rotas dos domínios padrão do provider são criadas automaticamente.
📸 Print sugerido: aba Plugins com um card de provider aberto, o campo “JSON de credenciais” preenchido (com valores fictícios) e o botão Validar.
Matriz rápida de credenciais
| Provider | site / provider | Campos principais |
|---|---|---|
| AliExpress | aliexpress / api_v2 | appKey, appSecret + tracking ID (PID) |
| Amazon (PA-API) | amazon / amazon | accessKeyId, secretAccessKey, region, partnerTag |
| Amazon (Creators) | amazon / creators | credentialId, credentialSecret, version, partnerTag |
| Shopee | shopee / shopee | appId, secret |
| Awin | awin / awin | publisherId, accessToken (+ advertiserId por rota) |
| Rakuten | rakuten / rakuten | accessToken ou clientId+clientSecret+scopeId, publisherId (+ advertiserId por rota) |
| Magalu | magalu / magalu | promoterId, identifier |
| Mercado Livre | mercadolivre / mercadolivre | tag, cookie |
Detalhes e onde solicitar as chaves estão no guia de cada provider. Awin e Rakuten exigem ainda o
advertiserIdda loja específica, configurado na rota.
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.