> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-superadmin/redes-sociais-e-marketplaces/nuvemshop-superadmin.md).
# Nuvemshop - Superadmin
{% hint style="danger" %}
**Funcionalidade em beta:** este recurso foi lançado recentemente e ainda está em fase de testes. Alguns comportamentos podem apresentar instabilidade ou não funcionar como esperado em todos os cenários. Estamos coletando feedback e aplicando melhorias e correções ao longo das próximas versões. Se encontrar algum problema, entre em contato com o suporte.
{% endhint %}
{% hint style="info" %}
**Disponível para o perfil:** Super Administrador
{% endhint %}
Configure a integração com o Nuvemshop para receber pedidos como atendimentos e notificar clientes automaticamente. Um único app pode cobrir todos os tenants (Global) ou ser configurado por tenant específico.
{% hint style="warning" %}
**Beta:** esta integração está em fase beta. A disponibilidade pode variar conforme o plano contratado.
{% endhint %}
{% hint style="warning" %}
**Configuração global vs. por tenant:** os apps cadastrados aqui ficam disponíveis para todos os tenants. A conexão e o gerenciamento do número WABA de cada tenant é feito individualmente pelo Administrador em Configurações → Integrações
{% endhint %}
***
#### Como acessar
No painel Super Admin, acesse **Redes Sociais e Marketplaces → Nuvemshop**.
***
#### Conectando uma loja
Clique em **+ Novo App Nuvemshop**. A integração suporta dois modos de conexão:
**Modo OAuth (recomendado)**
1. Informe a **URL da loja** (ex.: )
2. Clique em **Conectar** — uma janela abre o site da Nuvemshop para autorização
3. Após autorizar, as credenciais são preenchidas automaticamente
**Modo manual (BYO)**
Cole as credenciais obtidas no painel de parceiros da Nuvemshop:
| Campo | O que é |
| ----------------- | ------------------------------------------------------------------------------- |
| **Store ID** | ID da loja na Nuvemshop — user\_id retornado no OAuth ou 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) |
**Ativando os webhooks**
Após preencher as credenciais, copie a **URL do Webhook** exibida no formulário e cole em: **Nuvemshop → Configurações → Avançado → Webhooks → URL de entrega**
Os webhooks notificam a plataforma sobre novos pedidos e atualizações em tempo real.
{% hint style="info" %}
O campo **Callback do OAuth proxy** é fixo e informativo — o cliente não precisa cadastrá-lo manualmente. Para usar um domínio próprio no OAuth (whitelabel), configure em `/auth-dominio`.
{% endhint %}
***
#### Configurações do app
| Opção | O que faz |
| ------------------------------------- | ----------------------------------------------------------------------------- |
| **Tenant** | Global = todos os tenants usam esta config. Ou selecione um tenant específico |
| **Sincronizar produtos** | Mantém o cache do seletor de produtos atualizado |
| **Canal vinculado** | O picker de produtos usará esta loja quando o ticket vier deste canal |
| **Descrição** | Identificação opcional — ex: "Loja principal da empresa" |
| **Fechar ticket ao completar pedido** | Fecha o ticket automaticamente quando o pedido for marcado como concluído |
| **Ativo** | Liga ou desliga a integração |
***
#### Páginas relacionadas
* [Nuvemshop — Gestão Comercial](/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/nuvemshop.md) — gerenciar pedidos e produtos no dia a dia
* [Nuvemshop — Configurações Apps ](/configuracao-administrador/configuracoes-painel-admin/apps-configuracoes/nuvemshop-configuracoes-apps.md)— configuração por tenant no painel admin
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://ajuda.zdg.com.br/configuracao-superadmin/redes-sociais-e-marketplaces/nuvemshop-superadmin.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
