> 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="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**.

<figure><img src="/files/1yq4rRSURQxPtuBaAXma" alt=""><figcaption></figcaption></figure>

***

#### 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.: <https://minha-loja.com>)
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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/redes-sociais-e-marketplaces/nuvemshop-superadmin.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.