Skip to main content
Para que o módulo de integrações funcione, a equipe de desenvolvimento (Proprietária da Infraestrutura) deve criar os “Aplicativos” oficiais nos painéis de desenvolvedor dos Marketplaces. É isso que fornecerá o CLIENT_ID e o CLIENT_SECRET a serem injetados nas variáveis de ambiente do Backend.

​
1. Mercado Livre Developers

Você precisará de uma conta no Mercado Livre habilitada como Developer.
1

Acessar o Painel

Acesse Mercado Livre Developers e faça login.
2

Criar Nova Aplicação

Clique em Criar Aplicação.
  • Nome: OmniDom Hub (ou outro de sua preferência).
  • Descrição: Hub de integração de Vendas e Estoque.
  • URL da Aplicação (URI de redirecionamento): OBRIGATÓRIO! Deve ser a URL da sua API de produção acrescida do caminho do callback. Exemplo: https://sua-api.up.railway.app/integrations/oauth/meli/callback.
3

Permissões

Solicite todos os Escopos (Scopes) de permissão necessários: Leitura de dados offline, Publicação de produtos, Mensageria, Gestão de Pedidos.
4

Webhooks (Tópicos de Notificação)

O ML envia notificações em tempo real. Você deve configurar a Callback URL para notificações: https://sua-api.up.railway.app/integrations/webhooks/meli Marque os tópicos exigidos (ex: orders, items, questions, payments).
5

Injetar no .env

Após criar, o painel mostrará o App ID e o Client Secret. Copie-os as coloque nas variáveis do railway (MELI_APP_ID, MELI_SECRET).

​
2. Shopee Open Platform

A Shopee possui um processo ligeiramente diferente: exigem verificação da conta do desenvolvedor.
1

Acesse a Open Platform

Vá para a Shopee Open Platform e crie sua conta de Partner/Developer.
2

Crie um App (Console)

No Developer Console, crie um App do Tipo Seller In-house App (se for para uso da sua própria conta) ou Third-Party App (se você for revender como SaaS multi-tenant a terceiros).
3

Configurar URLs

  • App Callback URL: https://sua-api.up.railway.app/integrations/oauth/shopee/callback
  • Push Mechanism URL (Webhooks): https://sua-api.up.railway.app/integrations/webhooks/shopee
4

Permissões

Adicione as permissões (Order Management, Product, Logistics, Returns).
5

Injetar no .env

Copie o Partner ID e a Partner Key. Coloque-os na sua instância Railway correspondente (SHOPEE_PARTNER_ID, SHOPEE_SECRET_KEY).
Segurança dos Tokens: Nunca compartilhe os “Secrets” da Shopee ou do Mercado Livre no código do frontend (Next.js). Eles devem existir exclusivamente em backend seguro (na Vercel não, apenas na Railway!).