A funcionalidade de Aplicativos sob medida permite gerar chaves de acesso (access tokens) diretamente pelo painel da sua loja Nuvemshop, sem precisar de soluções intermediárias ou de se tornar um parceiro.
Com essas chaves, você pode conectar ferramentas próprias aos dados da sua loja via API, mantendo total controle de segurança.
Helpjuice Warning Callout Title
Essa funcionalidade está disponível para os planos Escala e Next.
Neste tutorial, explicamos quando usar e como criar os aplicativos sob medida na sua loja.
O que são aplicativos sob medida e quando usar?
Diferente dos aplicativos tradicionais da nossa Loja de Aplicativos, um Aplicativo sob medida é uma chave privada e que não fica visível para outras lojas. Ele funciona na seguinte forma:
- O aplicativo é criado pelo lojista dentro do painel da loja Nuvemshop;
- É gerado um token de acesso exclusivo para a loja que é usado para autenticar suas integrações;
- Permite ao lojista escolher quais permissões de leitura e escrita (escopos) o token terá.
Quando usar?
Essa funcionalidade deve ser usada quando você precisar que uma ferramenta externa leia ou escreva dados da sua loja (produtos, pedidos, clientes, estoque, etc) sem precisar publicar um app na Loja de Aplicativos.
Exemplos de casos de uso:
A seguir, veja alguns exemplos de casos de uso em que você pode optar pelos aplicativos sob medida:
- Integração com ERP próprio: para sincronizar produtos, pedidos e estoque de forma automática.
- Conexão com BI: para enviar dados de vendas diretamente ao Power BI, Looker, Metabase ou planilhas.
- Automações internas: para rodar scripts que atualizam preços em massa ou exportam pedidos.
- Acesso seguro para desenvolvedores: para dar à sua equipe técnica acesso à API sem precisar compartilhar a senha do seu painel administrador.
Como criar o aplicativo sob medida e acessar o token?
1. Criar o aplicativo sob medida
1. Acessar o painel administrador Nuvemshop.
2. No menu lateral, na seção Aplicativos, clicar em “Aplicativos sob medida”.
3. Em seguida, clicar no botão “Criar aplicativo sob medida”.
4. Na seção de Identificação, preencher o campo Nome do aplicativo com um nome claro (ex: "Integração ERP" ou "Script de relatórios") para facilitar a organização.
5. Na seção de Perfis de acesso, escolher as permissões necessárias para a ferramenta. Você pode dar acesso total ou selecionar permissões específicas para cada recurso.
Helpjuice Info Callout Title
Evitar marcar a permissão de “Acesso total” para uma maior segurança, conceda à chave apenas as permissões realmente necessárias para o funcionamento dela.
6. Clicar em “Salvar”.
Pronto!
Você já poderá visualizar dentro do painel administrador o aplicativo criado. O próximo passo é acessar o token (chaves de acesso) do seu aplicativo e salvar.
2. Revelar o token de acesso
Helpjuice Success Callout Title
Por motivos de segurança, o sistema vai exibir o seu token de acesso completo na tela apenas uma única vez. Você deve copiar e guardar essa chave imediatamente em um local seguro.
1. Logo após criar o aplicativo, clicar no nome dele para acessar os detalhes.
2. Nesta tela, você poderá visualizar, copiar e criar um link compartilhável do seu token. Lembre-se que o token completo aparecerá na tela uma única vez.
3. Clicar em “Revelar”, para visualizar o token completo.
4. Na tela seguinte, clicar em “Copiar token”. Feito isso, colar e guardar o token imediatamente em um local seguro (gerenciador de senhas, variável de ambiente do seu sistema, etc.).
5. Para compartilhar o token com outras pessoas da sua equipe, clicar em “Compartilhar token” e depois em “Compartilhar" novamente para gerar um link público.
Pronto!
Após fechar a tela, o token completo não irá aparecer novamente. Ele ficará permanentemente ocultado, mostrando apenas os 4 últimos dígitos (ex.: ••••••1A2B).
Helpjuice Success Callout Title
Se você perder a chave de acesso (token), não será possível recuperar. Será necessário revogar o token (desativar), criar um novo e reconfigurar.
3. Usar o token de acesso
Não é necessário ser desenvolvedor para criar o aplicativo, mas conectar o token a uma integração externa requer conhecimento técnico.
Para conferir como utilizar o token, consultar a Documentação da API da Nuvemshop para detalhes sobre endpoints e exemplos.
Helpjuice Info Callout Title
Se preferir, você pode dar a permissão de "Aplicativos sob medida" diretamente para o desenvolvedor da sua equipe. Para ver como, acessar: Como gerenciar os tokens e permissões de aplicativos sob medida na Nuvemshop?
Para saber como como editar o aplicativo e gerenciar os tokens e permissões, acessar o tutorial abaixo:
📝 Como gerenciar os tokens e permissões de aplicativos sob medida na Nuvemshop?
Boas Práticas
- Múltiplos tokens: Não há limite de criação de Aplicativos sob medida. A recomendação é criar um app diferente para cada integração (um para o ERP, outro para o BI). Isso facilita a revogação de acessos individuais;
- Limites da API: As chamadas feitas pelo seu Aplicativo sob medida respeitam a mesma infraestrutura pública da Nuvemshop, com um limite de 2 requisições por segundo e um buffer de 40 requisições;
- Rotacione periodicamente: Troque o token a cada 90 ou 180 dias e nunca suba em repositórios públicos (GitHub, etc.);
- Revise os aplicativos regularmente: desinstale apps que não estão mais em uso.
Helpjuice Info Callout Title
Mantenha as chaves de acesso (tokens) confidenciais. Não compartilhe para garantir a segurança da sua loja.