Conectar Contas
Conecte seus sellers de Amazon e Mercado Livre via OAuth — é o que libera os dados de Analytics e do Repricer.
Para que o Radar leia seus pedidos, ofertas e finanças, você precisa conectar cada seller (a sua conta de vendedor no marketplace) por meio de uma autorização OAuth. Conectar é o passo que desbloqueia os dados de Analytics e do Repricer — sem a conexão, esses aplicativos não têm o que processar.
Não confunda os dois tipos de conta: o User é o seu cadastro no Radar (login Clerk); o SellerAccount é a conta de vendedor conectada no marketplace. Cada conexão é feita uma vez e fica salva no seu User.
Conectar uma conta de seller Amazon (SP-API)
A conexão com a Amazon é feita via SP-API OAuth. O fluxo:
- Em Contas Amazon, inicie a conexão de um novo seller.
- Você é levado ao Amazon Seller Central para autorizar o Radar.
- Ao confirmar, a Amazon devolve as credenciais e o Radar cria um
SellerAccount, identificado pelosellingPartnerId.
Amazon
A autorização é via SP-API OAuth (Selling Partner API). Você concede acesso a partir do Seller Central, e o SellerAccount é chaveado pelo sellingPartnerId. É essa conexão que permite ao Analytics sincronizar pedidos, vendas/tráfego e repasses, e ao Repricer ler ofertas e publicar preços.
Conectar uma conta de Mercado Livre
A conexão com o Mercado Livre também é via OAuth: você autoriza o Radar na tela de login do ML e ele cria um SellerAccount próprio para esse marketplace.
Mercado Livre
A autorização é via OAuth do Mercado Livre, concedendo os escopos (scopes) necessários para o Radar ler seus anúncios e atuar sobre eles. O SellerAccount do Mercado Livre é distinto do da Amazon — são conexões independentes, cada uma com seu próprio OAuth.
Conectar o Amazon Ads
Anúncios têm autorização própria, separada da SP-API: conectar as vendas não conecta os anúncios, e desconectar um não desconecta o outro.
- Na página de contas, cada conta de vendedor exibe um selo com o status da conexão de anúncios.
- Clique em conectar e autorize o Radar na tela da Amazon.
- Na volta, o Radar tenta vincular sozinho o perfil de anúncios correspondente àquela conta de vendedor, pela identidade do vendedor — não pelo país.
- Quando nenhum perfil corresponde, ou quando há mais de um candidato, a tela pede que você escolha em uma lista.
Se a autorização falhar, a página mostra o motivo em português em vez de voltar em silêncio.
Conectar os anúncios libera o app Performance e as ferramentas de Ads do Assistente de IA. A importação de desempenho é diária, por campanha e por dia, com recuperação automática das janelas atrasadas.
Dono × colaborador
Cada conexão entre um User e um SellerAccount é uma conexão de seller (UserSeller), e ela pode ter dois papéis:
| Papel | isOwner | O que significa |
|---|---|---|
| Dono | true | Quem conectou originalmente o seller. Conta para a contagem de uso (limite seller_accounts) e tem controle pleno sobre a conexão. |
| Colaborador | false | Um User que recebeu acesso a um seller conectado por outra pessoa, em regime de colaboração. Trabalha sobre o mesmo SellerAccount sem ser o dono dele. |
Esse modelo permite que uma equipe compartilhe o mesmo seller: um dono conecta a conta e convida colaboradores, sem que cada pessoa precise refazer o OAuth.
Vendendo nos dois marketplaces
Um mesmo User que vende na Amazon e no Mercado Livre mantém dois SellerAccounts distintos — um por marketplace, cada um com sua própria autorização OAuth. Eles não se misturam: a conexão da Amazon usa SP-API e o sellingPartnerId; a do Mercado Livre usa o OAuth do ML. Ambos ficam listados no seu User e podem ser usados em paralelo nos aplicativos.
Limite de contas de vendedor
O número de contas que você pode conectar como dono é controlado pelo limite seller_accounts do seu plano. Se esse teto já tiver sido atingido, o fluxo de autorização OAuth é interrompido logo após o retorno do marketplace e você é redirecionado de volta ao aplicativo (Repricer → Configurações; Analytics → início) com o aviso de limite de conta atingido. Para conectar mais contas, faça upgrade do Tier ou desconecte uma conta existente. Consulte Limites por Plano.
O que conectar desbloqueia
Conectar um seller é o pré-requisito para os dados aparecerem:
- Analytics — passa a sincronizar pedidos, vendas/tráfego e (com assinatura) financeiro e repasses do seller conectado.
- Repricer — passa a ler as ofertas/anúncios do seller e a reprecificá-los conforme suas automações.
Enquanto não houver pelo menos um seller conectado, esses aplicativos ficam sem dados para exibir.