Integrações de marketplace
Como integrar Amazon, Shopee, Magazine Luiza (Magalu), AliExpress, Natura e a rede Awin ao OrbitSender — cadastrar credenciais da API, ativar a conversão de links de afiliado e a imagem oficial do produto, e resolver disparo sem imagem.
As integrações ligam suas contas de afiliado dos marketplaces ao OrbitSender. Com elas, o sistema converte os links de produto no seu link de afiliado e busca a imagem oficial do produto para os disparos.
Três jeitos de integrar
- Por credenciais de API — Amazon, Shopee, Magalu, AliExpress e Natura (esta página).
- Por extensão de navegador — Mercado Livre e SHEIN, que não têm API oficial de afiliados (a extensão é a mesma para as duas). Veja Integração Mercado Livre e Integração SHEIN.
- Por rede de afiliados — a Awin, onde uma credencial atende dezenas de lojas (Kabum, Dafiti, Renner, O Boticário…). Veja Integração Awin.
Precisa de API?
A integração/API só é necessária para a conversão automática do monitoramento. No disparo manual com o link já convertido, você não precisa de API — veja Disparo manual × Monitoramento.
Onde ficam as integrações
No menu lateral, abra Configurações → aba Integrações. A aba fica disponível em contas de afiliado (fica oculta no "modo simples").
Escolha o marketplace no grid
Clique em Adicionar Integração. Abre um grid com as logos dos marketplaces — cada card mostra a marca e um resumo do que preencher:
Amazon
Shopee
Magalu
Mercado Livre
Natura
AliExpress
Awin
TikTok Shop
Ao clicar num card, abre o formulário de credenciais daquele marketplace. Se escolheu o card errado, use ← Escolher outro para voltar ao grid.
Mercado Livre é diferente
No grid, o card do Mercado Livre traz o botão Instalar extensão no Chrome em vez de campos de credencial — ele integra por extensão de navegador, não por API. Veja Integração Mercado Livre.
Não achou o marketplace?
O grid tem um card "Não achou uma integração? Chame no seu grupo de suporte e sugira" — use-o para pedir novos marketplaces.
Preencha os dados
Para todos os marketplaces (exceto Mercado Livre), há um campo opcional Nome da
Integração / Label (ex.: Conta Lizzi, Backup MELI) — útil para diferenciar
mais de uma conta do mesmo marketplace.
Disparo saiu sem imagem? Ative a API
Esta é a causa nº1 de "disparo sem foto" quando você cola links prontos:
Sem integração ativa, não há imagem
Se você envia um link de marketplace sem a integração/API daquele marketplace ativa, o OrbitSender não consegue buscar a imagem oficial — vai só texto e link. A conversão (e a foto) só funcionam depois que a API está cadastrada.
Duas saídas:
- Cadastre a API do marketplace (abaixo) — aí a conversão liga e a imagem oficial é puxada automaticamente.
- Sem API, crie a promoção dentro do OrbitSender (Multi Sender / Quick Sender com geração por IA) ou dispare manualmente com o link já convertido e a imagem anexada.
No monitoramento, a conversão usa um caminho mais robusto e costuma trazer a imagem mesmo quando o envio manual falha.
Amazon
A Amazon usa a API para Criadores (Creators API). A API antiga foi descontinuada e gera o erro "Falha na extração dos dados do produto".
Acesse o Associates Central
Entre em associados.amazon.com.br e vá em Ferramentas → API para Criadores.
Crie o aplicativo e a credencial
Clique em Criar Aplicativo e adicione uma nova credencial. Copie o Credential ID, o Credential Secret e a Version.
O Credential Secret só aparece na hora da criação — não dá para consultá-lo depois. Se perder, gere uma credencial nova.
Preencha no OrbitSender (marketplace: Amazon)
- Credential ID — ex.:
amzn1.application-oa2-client.... - Credential Secret
- Version — digite só o número (ex.:
3.1). Se a Amazon mostrarV3.1, remova o "V". - Partner Tag — sua tag de afiliado, no formato
suatag-20.
Conta Amazon nova
Contas novas podem precisar de vendas qualificadas para a Amazon liberar a API. Sem isso, a credencial não é gerada — fale com o suporte da Amazon.
Shopee
A Shopee precisa de App ID e App Secret (no portal da Shopee podem aparecer como Partner ID e Partner Key — é o mesmo par).
Crie a aplicação
Acesse open.shopee.com, faça login e crie uma aplicação no portal de afiliados/desenvolvedores. Envie a solicitação e aguarde a aprovação.
Vá para produção ("Go Live")
A Shopee entrega chaves de teste (sandbox) e, após aprovação, as chaves de produção (Live). Use as de produção.
Preencha no OrbitSender (marketplace: Shopee)
- App ID
- App Secret
Erro 10020: Invalid Signature
Quase sempre é App Secret incorreto ou App ID e Secret de aplicativos diferentes. Confirme que os dois são do mesmo app e, se preciso, gere as chaves de novo.
Magazine Luiza (Magalu)
A mais simples — só a sua Tag de afiliado (o nome de influenciador Magalu, no
formato magazine*****, ex.: magazinepernadovento). Não precisa de app nem
secret.
No OrbitSender: Adicionar Integração → card Magalu e informe o Store ID (sua tag). O campo Promoter ID é opcional (usado para abrir a oferta direto no app da Magalu).
AliExpress
Precisa de App Key e App Secret via AliExpress Open Platform.
Cadastre-se no programa de afiliados
Inscreva-se no Programa de Afiliados da AliExpress.
Crie o aplicativo
Em openservice.aliexpress.com, abra o App Console, crie um aplicativo, solicite a API e aguarde a aprovação.
Copie as credenciais
No painel Overview, copie o App Key e o App Secret. No OrbitSender,
informe também o Tracking ID (ex.: default).
Natura
No OrbitSender: Adicionar Integração → card Natura e informe o Slug do Consultor (Minha Loja) — ex.: o identificador da sua loja Natura.
Awin (rede de afiliados)
A Awin não é uma loja: é uma rede. Com Publisher ID e Token de API você converte links de todas as lojas em que sua conta foi aprovada — Kabum, Dafiti, Renner, O Boticário, Samsung e outras — sem cadastrar uma integração por loja.
Por ter passos próprios (verificar as lojas aprovadas e, se quiser, um Publisher por segmento), a Awin tem página própria: Integração Awin.
Depois de integrar: ative a conversão
Ter a credencial cadastrada não basta — ligue Ativar conversão de link e marque o marketplace em Plataformas para conversão de link (seção Conversão de Links de Afiliado) ao configurar o monitoramento do segmento.
Problemas comuns
Continua sem imagem mesmo com a API cadastrada
- Confirme que a integração está ativa e as credenciais corretas.
- Pode ser instabilidade momentânea do marketplace (ex.: Shopee) — costuma normalizar sozinho.
- Promoções que já estavam na fila antes de corrigir continuam sem imagem — limpe a fila e reative o monitoramento.
- No iPhone/iOS, o WhatsApp às vezes some com a imagem do preview — é limitação do próprio WhatsApp, não do OrbitSender.
"Integração inválida" / credencial vencida
Gere credenciais novas no portal do marketplace e substitua na integração. Na Shopee, confirme que App ID e App Secret são do mesmo app.
Precisa de ajuda?
Cada marketplace tem um portal próprio de credenciais. Se travar em algum passo, envie prints e fale com o suporte pelo painel.
Campanhas (gerenciar disparos)
A tela de Campanhas do OrbitSender — abas Andamento, Agendadas e Histórico, status de cada campanha, pausar e retomar, priorizar envio, limpar fila, ver detalhes por grupo, recriar (duplicar), mensagens recorrentes (envio automático em dias e horários fixos) e deletar mensagens já enviadas.
Integração Mercado Livre
Como integrar o Mercado Livre ao OrbitSender pela extensão OrbitSender Connector — instalar pela Chrome Web Store, conectar sua conta de afiliado, preencher Tag e Nickname, sincronizar e converter links do Mercado Livre.