> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/admin/configuracao-e-administracao/nuvemshop-configuracoes-apps.md).

# Nuvemshop - Configurações Apps

## Nuvemshop - Configurações Apps

{% 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**.

***

**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 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.norux.chat/admin/configuracao-e-administracao/nuvemshop-configuracoes-apps.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.