For the complete documentation index, see llms.txt. This page is also available as Markdown.

Nuvemshop - Configurações Apps


Como usar esta página

Configure a integração com o Nuvemshop para receber pedidos e notificar clientes automaticamente.

Ativando webhooks

  • Após criar a configuração, copie a URL do Webhook exibida no formulário

  • Cole a URL em Nuvemshop → Configurações → Avançado → Webhooks → URL de entrega

  • Os webhooks notificam a plataforma sobre novos pedidos e atualizações em tempo real


Como acessar

Acesse Apps → Nuvemshop no painel administrativo e clique em Novo App.


Conectando sua loja

A integração suporta dois modos de conexão:

Modo OAuth (recomendado)

  1. Informe a URL da loja (ex.: https://minha-loja.com)

  2. Clique em Conectar — uma janela abre o site da Nuvemshop solicitando autorização

  3. Faça login na sua loja e autorize o acesso

  4. Ao retornar, as credenciais são preenchidas automaticamente

Modo manual (BYO)

Para quem prefere inserir as credenciais diretamente, sem o fluxo OAuth:

Campo
O que é

Store ID

ID da loja na Nuvemshop — user_id retornado no OAuth ou encontrado no painel de parceiros

Access Token

Token de acesso da API. Não expira; obtido via OAuth ou painel de parceiros

Client ID

ID do app de parceiro (opcional)

Client Secret

Usado para validar o HMAC dos webhooks no modo manual (opcional)

Após preencher, copie a URL do Webhook exibida e cole em Nuvemshop → Configurações → Avançado → Webhooks → URL de entrega.

O campo Callback do OAuth proxy é fixo e informativo — você não precisa cadastrá-lo manualmente na Nuvemshop.


Configurações do app

Opção
O que faz

Sincronizar produtos

Mantém o cache do seletor de produtos atualizado

Canal vinculado

O seletor de produtos usará automaticamente esta loja quando o ticket vier deste canal

Descrição

Nome amigável para identificar a loja (ex.: Loja principal da empresa)

Fechar ticket ao completar pedido

Fecha automaticamente o ticket quando o pedido for marcado como concluído

Ativo

Liga ou desliga a integração

É possível conectar mais de uma loja. Quando há várias, um seletor de loja aparece nas telas de pedidos e produtos.


Reconexão

A conexão é verificada periodicamente e o status (conectada/desconectada) aparece na tela de configuração. Se a loja desinstalar o app ou a autorização expirar, a integração exibe um aviso de reconexão — clique em Conectar novamente para restaurar.

Atualizado

Isto foi útil?