Como conectar a API de afiliados da Shopee (App ID e App Secret)

A Shopee é um dos poucos marketplaces brasileiros com API oficial de afiliados — o que significa sincronização automática de verdade, sem planilha e sem gambiarra. O passo a passo:

1. Pegue as credenciais

1. Entre no painel de afiliados (affiliate.shopee.com.br).
2. Acesse a área Open API (open-api.affiliate.shopee.com.br).
3. Copie o App ID (um número longo) e o App Secret.

2. Conecte no painel

Em Conexões → Shopee → API de Afiliado, cole o App ID e o App Secret. A primeira sincronização puxa seus últimos 30 dias; depois ela roda todo dia sozinha.

3. O detalhe que ninguém conta: o atraso da Shopee

A Shopee publica as conversões de ontem com atraso — às vezes só no fim da manhã. Por isso o painel tem uma sentinela que fica checando e dispara a sincronização no minuto em que os dados aparecem. Você não faz nada; seus números de ontem chegam assim que existem.

4. Complete com os relatórios de cliques

A API traz conversões, mas não cliques nem canal. Exporte o relatório de cliques (CSV) no painel da Shopee de vez em quando e solte na aba Importar: isso libera cliques por dia, por canal de divulgação, por etiqueta e por hora do dia.

Dica: use Sub_ids consistentes nos seus links (ex.: telegram, grupo-vip) — o painel transforma cada Sub_id em etiqueta e você enxerga qual canal realmente converte.