> 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.md).

# Nuvemshop

## Nuvemshop

{% hint style="warning" %}
**Disponível para o perfil: Administrador** (configuração) — atendentes e supervisores acessam os pedidos e atendimentos conforme suas permissões
{% endhint %}

{% hint style="info" %}
**Somente recebimento:** a Nuvemshop é um canal de entrada. A plataforma recebe pedidos e exibe as informações, mas **não envia mensagens de volta para a Nuvemshop**. Respostas ao cliente saem por outro canal vinculado ao contato (WhatsApp, e-mail etc.).
{% endhint %}

***

**Como usar esta página**

Acompanhe o ciclo completo da sua loja Nuvemshop em um só lugar: pedidos, produtos e atalhos para conversar com clientes.

**Pedidos**

* Filtre por status, data e cliente para encontrar pedidos rapidamente
* Mude o status do pedido sem sair da plataforma
* Abra a conversa do cliente direto pelo botão **Abrir conversa**

**Produtos**

* Crie, edite e remova produtos com sincronização automática
* Use a galeria interna ou faça upload direto pelo formulário
* Defina estoque, peso e categorias na mesma tela

**Notas e histórico**

* Adicione notas privadas ao pedido ou envie mensagem ao cliente
* Status e mudanças geram mensagens no ticket vinculado em tempo real

***

**Como acessar**

Acesse **Gestão Comercial → Nuvemshop** no menu lateral.

***

**Pedidos**

Na aba **Pedidos**, a lista exibe: #, cliente, data, status, pagamento, itens e total.

**Buscar e filtrar:**

* Busque por número do pedido (#), nome ou e-mail do cliente
* Filtre por **Status**, **Pagamento** e intervalo de datas (**De** / **Até**)
* Use **Atualizar** para recarregar a lista sem reabrir a página

**O que você pode fazer em cada pedido:**

| Ação                            | O que faz                                                                            |
| ------------------------------- | ------------------------------------------------------------------------------------ |
| **Ver detalhes**                | Abre o pedido completo: itens com foto, dados do cliente, pagamento e endereço       |
| **Enviar mensagem**             | Abre uma nova conversa já preenchida com os dados do cliente                         |
| **Fechar / Reabrir / Cancelar** | Atualiza o status do pedido diretamente na loja (cancelar permite informar o motivo) |
| **Nota interna**                | Registra uma observação interna no pedido — visível apenas para a equipe             |
| **Abrir conversa**              | Abre o atendimento vinculado ao pedido, se existir                                   |

**Status exibidos:**

* **Pedido:** aberto, fechado, cancelado
* **Pagamento:** pendente, autorizado, pago, estornado, reembolsado

***

**Produtos**

Na aba **Produtos** você lista, busca, cria, edita e exclui os produtos da loja Nuvemshop. A lista exibe imagem, nome, SKU, preço, estoque e status.

Clique em **Novo Produto** para cadastrar:

| Campo                  | Descrição                                               |
| ---------------------- | ------------------------------------------------------- |
| **Nome do produto**\*  | Nome exibido na loja                                    |
| **Tipo**               | Simples (padrão)                                        |
| **Status**             | Publicado ou rascunho                                   |
| **Preço regular**      | Preço cheio                                             |
| **Preço promocional**  | Preço com desconto                                      |
| **SKU**                | Código único do produto                                 |
| **Descrição curta**    | Resumo exibido na listagem da loja                      |
| **Descrição completa** | Descrição detalhada do produto                          |
| **Controlar estoque**  | Habilita o controle de quantidade em estoque            |
| **Status do estoque**  | Em estoque, esgotado etc.                               |
| **Peso (kg)**          | Peso para cálculo de frete                              |
| **Imagem do produto**  | Escolha da galeria interna, upload do PC ou URL externa |

**Enviando um produto no atendimento**

Durante uma conversa, abra o seletor de produtos (menu **⋮ → Inserir produto**) e selecione a aba **Nuvemshop**. O seletor reúne no mesmo lugar as fontes Nuvemshop, WooCommerce e Catálogo (interno) quando disponíveis.

***

**Como os pedidos chegam como atendimento**

Quando um pedido é criado ou atualizado na loja, a plataforma:

1. Cria ou atualiza o **contato** do cliente
2. Abre (ou atualiza) um **atendimento** com as informações do pedido
3. Posta um **resumo** — número, cliente, status, pagamento, total, itens e contato — com um aviso de que as respostas ao cliente saem por outro canal
4. Aplica o fluxo normal: fila, etiquetas, chatbot, horário de atendimento e demais automações

Atualizações de status do pedido **acrescentam mensagens** ao mesmo atendimento. Se **Fechar ticket ao completar pedido** estiver ativo, o atendimento é encerrado automaticamente.

***

**Boas práticas**

* Configure o **Canal vinculado** (nas configurações do app) para garantir que os pedidos caiam na fila certa
* Ative **Fechar ticket ao completar pedido** para evitar atendimentos em aberto sem necessidade de ação
* Use **Nota interna** para registrar tratativas sobre o pedido diretamente no ticket, sem expor ao cliente
* Ao usar **Enviar mensagem** a partir de um pedido, a conversa abre em outro canal — confirme qual canal está vinculado ao cliente antes de enviar

→ Ver como configurar a integração Nuvemshop


---

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