Conectar a Shopee (API)

Onde pegar as credenciais

A Shopee tem API oficial de afiliados (Open API). Você precisa de App ID e App Secret:

  1. Entre no painel de afiliados da Shopee (affiliate.shopee.com.br) com sua conta de afiliado.
  2. Acesse a área Open API (open-api.affiliate.shopee.com.br) e solicite/abra suas credenciais de desenvolvedor.
  3. Copie o App ID (número longo, ex.: 18300000000) e o App Secret.
  4. No painel: Conexões → Shopee → API de Afiliado, cole os dois campos e salve.

O que sincronizamos

  • Conversões/pedidos com grão por item (pedido, item e modelo), comissão líquida do afiliado, status e Sub_ids 1–5.
  • A sincronização roda todo dia automaticamente — e como a Shopee publica os dados de ontem com atraso (às vezes só no fim da manhã), uma sentinela fica verificando e dispara a sincronização assim que os dados aparecem.
  • Você também pode sincronizar manualmente em Conexões (escolhendo quantos dias retroativos).

Cliques, canais e horários

A API de conversões não traz cliques nem o canal de divulgação. Para completar:

  • Exporte o relatório de cliques (CSV) do painel da Shopee e importe na aba Importar — isso alimenta cliques por dia, por canal (Telegram/WhatsApp/Instagram…), por etiqueta e por hora do dia.
  • Exporte o relatório de vendas (CSV) para trazer o campo "Canal" dos pedidos.

Rate limit: a Shopee limita chamadas por minuto. O painel já espaça as requisições e tenta de novo sozinho quando o limite aparece — sincronizações grandes só demoram um pouco mais.


Veja também: todos os guias · blog