> 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-administrador/configuracoes-painel-admin/apps-configuracoes/nuvemshop-configuracoes-apps.md).

# Nuvemshop - Configurações Apps

{% 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="warning" %}
**Disponível para o perfil: Administrador**
{% endhint %}

***

#### 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**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FvrJqK09YUHuY0CBrA2k9%2Fimage.png?alt=media&amp;token=8bf71130-ff38-4315-904e-11827cafa49e" alt="" width="375"><figcaption></figcaption></figure>

***

#### 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**.

{% hint style="info" %}
O campo **Callback do OAuth proxy** é fixo e informativo — você não precisa cadastrá-lo manualmente na Nuvemshop.
{% endhint %}

***

#### 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                                                           |

{% hint style="info" %}
É possível conectar **mais de uma loja**. Quando há várias, um seletor de loja aparece nas telas de pedidos e produtos.
{% endhint %}

***

#### 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.


---

# 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-administrador/configuracoes-painel-admin/apps-configuracoes/nuvemshop-configuracoes-apps.md?ask=<question>&goal=<user_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.