> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# E-commerce

> Clientes, pedidos e produtos da sua loja no painel, vindos da integração, de planilha ou de cadastro manual

O menu **E-commerce** reúne os **clientes**, **pedidos** e **produtos** da sua operação de venda. Esses dados chegam de três formas: pela sincronização com uma loja ou sistema conectado (por exemplo, Nuvem Shop, Wake, Yampi, Shopify, Tray, Olist Ecommerce, Linx Commerce, Bling ou Conta Azul), por importação de planilha ou por cadastro manual no painel. A partir deles, a OctaSend dispara automações de pedido, monta as métricas de venda do Dashboard e liga produtos a conteúdo e avaliações.

No menu lateral, **E-commerce** abre os itens:

* **Clientes**
* **Pedidos**
* **Produtos**
* **Avaliações de produtos**, que só aparece quando o módulo está ativo na sua conta (módulo opcional; fale com a OctaSend para ativar). Veja [Avaliações de produtos](https://docs.octasend.com.br/plataforma/avaliacoes-de-produtos.md).
* **Dúvidas de produtos**, no mesmo módulo: as perguntas dos clientes na página do produto, que você responde pelo painel. Veja [Dúvidas de produtos](https://docs.octasend.com.br/plataforma/duvidas-de-produto.md).

> [!NOTE]
>
> As telas de Clientes, Pedidos e Produtos abrem mesmo sem loja conectada. Sem loja, você preenche a base cadastrando à mão ou importando planilhas.

## De onde vêm os dados

| Origem | Clientes | Pedidos | Produtos |
| - | - | - | - |
| Nuvem Shop | Sim | Sim | Sim |
| Wake | Sim, a partir dos pedidos | Sim | Sim |
| Yampi, Shopify, Tray, Olist Ecommerce e Linx Commerce | Sim | Sim | Sim |
| Bling | Sim (contatos) | Sim | Sim |
| Conta Azul | Sim | Sim (vendas) | Sim |
| Planilha | Sim (**Importar planilha**) | Sim (**Importar pedidos**) | Não |
| Cadastro manual | Sim (**Adicionar cliente**) | Não | Sim (**Adicionar produto**) |

A coluna **Origem** de cada lista mostra de onde veio o registro:

* **Nuvem Shop**, **Wake**, **Yampi**, **Shopify**, **Tray**, **Olist Ecommerce**, **Linx Commerce**, **Bling** ou **Conta Azul**: veio da integração conectada.
* **Planilha**: pedido importado por planilha (só na lista de Pedidos).
* **Cadastro manual**: cliente ou produto criado no painel. Clientes importados por planilha, e os clientes criados a partir de uma planilha de pedidos, também aparecem como **Cadastro manual**.

Cada origem mantém o próprio cadastro. Um cliente que existe na loja conectada e que você também importou por planilha aparece duas vezes, uma em cada origem: a importação não altera o registro que veio da loja.

## Sincronização com a loja

Para conectar uma loja, vá em **Configurações → Integrações**. O passo a passo de cada plataforma está em [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md), [Wake](https://docs.octasend.com.br/integracoes/wake.md), [Yampi](https://docs.octasend.com.br/integracoes/yampi.md), [Shopify](https://docs.octasend.com.br/integracoes/shopify.md), [Tray](https://docs.octasend.com.br/integracoes/tray.md), [Olist Ecommerce](https://docs.octasend.com.br/integracoes/olist.md), [Linx Commerce](https://docs.octasend.com.br/integracoes/linx.md), [Bling](https://docs.octasend.com.br/integracoes/bling.md) e [Conta Azul](https://docs.octasend.com.br/integracoes/conta-azul.md).

### Ao conectar

Logo depois da conexão, a OctaSend traz o histórico da loja em segundo plano. Os registros aparecem nas listas aos poucos, sem que você precise esperar na tela.

* **Nuvem Shop:** clientes, produtos e pedidos da loja.
* **Wake:** pedidos dos últimos 12 meses, junto com os clientes e os produtos desses pedidos. A Wake não tem cadastro de clientes próprio: os clientes sempre chegam pelos pedidos.

A carga do histórico só grava os dados e não dispara as automações de pedido. Mas um pedido antigo que for alterado na loja depois da conexão (por exemplo, com mudança de situação) é tratado como visto pela primeira vez e pode disparar **Chegou um pedido** nessa alteração.

### Depois de conectada

A base continua sendo atualizada de três jeitos:

1. **Eventos em tempo real.** Quando a loja avisa a OctaSend sobre um evento, o pedido, cliente ou produto daquele evento é atualizado na hora, mesmo que o evento não tenha comunicação escolhida. Na Nuvem Shop, só chegam os eventos ativos no mapeamento de eventos da integração. Na Wake, os avisos de pedido (pedido novo, mudança de situação e rastreamento) chegam sempre.
2. **Rotinas de sincronização.** Em intervalos regulares, a OctaSend consulta a loja e atualiza o que mudou. As rotinas ficam em **Configurações → Integrações → Configurar eventos** da loja, aba **Rotinas**:
   * Nuvem Shop tem as rotinas **Clientes**, **Produtos** e **Pedidos**. Wake tem **Produtos** e **Pedidos**.
   * Ao conectar a loja, as rotinas já vêm ativas, a cada **5 minutos**.
   * Para cada rotina você define o **Intervalo (minutos)**, que precisa ser maior que zero, e liga ou desliga a chave **Ativa**. Clique em **Salvar** em cada rotina alterada.
   * **Executar agora** roda a rotina na hora, sem esperar o intervalo. A sincronização acontece em segundo plano: atualize a página em instantes para ver o resultado.
   * Cada rotina mostra a **Última execução**. O histórico de execuções, com sucesso ou erro, fica na aba **Logs**.
   * Enquanto a integração precisar ser reconectada, as rotinas não podem ser salvas nem executadas.
3. **Revisão automática de pedidos.** A OctaSend revisa periodicamente os pedidos alterados recentemente nas lojas conectadas. Um pedido cujo aviso se perdeu entra na base e ainda dispara as automações de **Chegou um pedido**. Um pedido que já disparou não dispara de novo.

> [!NOTE]
>
> Na Nuvem Shop, cada leitura traz até 10.000 registros de cada tipo (clientes, produtos ou pedidos).

Na lista de Clientes, a coluna **Sincronizado em** mostra quando o cliente foi gravado ou atualizado pela última vez.

### Ao desconectar

Os clientes, pedidos e produtos que já vieram da loja continuam nas telas. Eles só deixam de ser atualizados: as rotinas e os eventos daquela loja param até você reconectar.

## Clientes

**E-commerce → Clientes** lista todos os clientes, de todas as origens, do **mais recente para o mais antigo** (pela data em que entraram na base da OctaSend), 20 por página.

* **Busca:** por nome, e-mail ou telefone.
* **Colunas:** Nome, E-mail, Telefone, Origem, Pedidos (quantos pedidos do cliente existem na base) e Sincronizado em.
* **Detalhe:** clique numa linha para ver e-mail, telefone, CPF, endereço, origem e a lista de pedidos do cliente, com número, situação e valor.

Não é possível editar nem excluir clientes pelo painel.

### Adicionar cliente

**1. Abra o formulário**

Em **E-commerce → Clientes**, clique em **Adicionar cliente**.

**2. Preencha os dados**

Campos: **Nome**, **E-mail**, **Telefone** (com seletor de país), **CPF** e o bloco **Endereço** (CEP, País, Logradouro, Número, Complemento, Bairro, Cidade e Estado). Todos são opcionais, com uma exceção: informe pelo menos um **e-mail** ou um **telefone**.

**3. Salve**

Clique em **Salvar cliente**. O cliente aparece na lista com a origem **Cadastro manual**.

Regras do cadastro:

* Sem e-mail e sem telefone o cadastro é recusado com a mensagem "Informe ao menos um e-mail ou telefone — sem isso o cliente não seria alcançável."
* O cliente é identificado pelo **e-mail** ou, sem e-mail, pelo **telefone**. Cadastrar de novo com o mesmo e-mail (ou o mesmo telefone, quando não há e-mail) **substitui** o cadastro manual existente pelos dados novos, em vez de criar outro cliente. Campos deixados em branco nesse novo cadastro ficam vazios.
* O cliente também é criado ou atualizado em [Contatos](https://docs.octasend.com.br/plataforma/contatos.md).

### Importar clientes por planilha

Em **E-commerce → Clientes**, clique em **Importar planilha**. A tela **Importar clientes por planilha** tem o botão **Baixar modelo**, com um arquivo de exemplo.

**Colunas aceitas**

| Coluna | Nomes aceitos no cabeçalho | Obrigatória |
| - | - | - |
| Nome | nome, name, cliente, cliente\_nome, nome do cliente | Não |
| E-mail | email, e-mail, e mail, mail, cliente\_email | Pelo menos uma das duas |
| Telefone | telefone, phone, celular, whatsapp, fone, cliente\_telefone | Pelo menos uma das duas |

O cabeçalho é reconhecido sem diferenciar maiúsculas e acentos. CPF e endereço não entram pela planilha: só pelo formulário **Adicionar cliente**. Por isso, reimportar um cliente pela planilha **não apaga** o CPF e o endereço cadastrados no formulário.

**Como funciona**

**1. Envie o arquivo**

Clique na área indicada ou arraste um arquivo **.csv**. Vírgula ou ponto e vírgula como separador, e arquivos salvos pelo Excel em português, são reconhecidos automaticamente.

**2. Confira a prévia**

O **Resumo da importação** mostra os **Clientes reconhecidos**, quantos são **Novos** e quantos **Já existem e serão atualizados**. Em **Linhas descartadas** aparece cada linha recusada, com o número da linha no arquivo e o motivo.

**3. Confirme**

Clique em **Confirmar importação**. Ao final, a tela mostra quantos **Clientes criados** e **Clientes atualizados** houve, com os botões **Importar outra planilha** e **Ver clientes**.

Regras da planilha de clientes:

* Até **2.000 clientes** por arquivo. Acima disso a importação é recusada: divida o arquivo em partes menores.
* Um arquivo sem as colunas de e-mail e de telefone é recusado inteiro.
* Cada linha precisa de um e-mail ou de um telefone válido. O e-mail é guardado em minúsculas e precisa ter `@` com texto dos dois lados, sem espaços. O telefone é guardado só com os dígitos e precisa ter pelo menos 8 dígitos. Linha sem nenhum dos dois válidos é descartada.
* O cliente é identificado pelo e-mail ou, sem e-mail, pelo telefone. Se o mesmo cliente aparece em mais de uma linha, vale a **última** linha, e a anterior aparece em **Linhas descartadas**.
* Reenviar a planilha atualiza os clientes que já existem em vez de duplicar.
* Na atualização, só mudam os campos que a planilha traz. O CPF e o endereço do cadastro manual ficam. Uma planilha sem a coluna de nome ou de telefone também não apaga esses dados do cliente.
* Uma célula **vazia** numa coluna que existe na planilha limpa o campo correspondente do cliente.
* Cada cliente importado também é criado ou atualizado em [Contatos](https://docs.octasend.com.br/plataforma/contatos.md).

## Pedidos

**E-commerce → Pedidos** abre com um panorama da base inteira, que não muda com a busca:

* **Total de pedidos**, **Valor total** e **Ticket médio** (valor total dividido pela quantidade de pedidos). Esses números somam todos os pedidos, em qualquer situação, inclusive cancelados.
* **Pedidos por dia:** quantidade de pedidos em cada um dos últimos 90 dias, contados no fuso horário da conta. Ao passar o mouse, aparecem a quantidade e o valor do dia.

> [!NOTE]
>
> O faturamento do [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md) segue outra regra: ali só contam os pedidos pagos e os sem situação. Por isso o **Valor total** desta tela pode ser maior que o faturamento do Dashboard.

Abaixo fica a lista de pedidos, 20 por página:

* **Busca:** por número ou situação do pedido.
* **Colunas:** Número, Cliente, Status, Total, Origem e Data. Clique no cabeçalho de Número, Status, Total, Origem ou Data para ordenar. A ordem padrão é do pedido mais recente para o mais antigo.
* **Status** mostra a situação exatamente como a origem informa: na Nuvem Shop, a situação do pagamento (por exemplo, `paid` ou `pending`); na Wake, o nome da situação do pedido na loja; na planilha, o texto da coluna `situacao`.
* **Detalhe:** clique num pedido para abrir a tela do pedido, com status, origem, data, total, os dados do cliente e os itens (produto, SKU, quantidade e preço).

O pedido guarda também o **cupom** usado na compra, quando a plataforma o informa (Nuvem Shop, Yampi e Shopify). O cupom não é uma coluna da lista: ele alimenta os resultados de [Popups personalizadas](https://docs.octasend.com.br/plataforma/popups.md), que contam as vendas feitas com o código da popup.

Pedidos não são criados um a um nem editados pelo painel: eles chegam da loja conectada ou por planilha.

### Importar pedidos por planilha

Em **E-commerce → Pedidos**, clique em **Importar pedidos**. A tela **Importar pedidos por planilha** segue três passos: **Enviar planilha**, **Conferir** e **Concluído**. Use **Baixar modelo de planilha** para começar de um arquivo de exemplo.

Cada linha da planilha é **um item** de pedido. Um pedido com três produtos ocupa três linhas com o mesmo número na coluna `pedido`.

**Colunas**

| Coluna | Obrigatória | O que contém |
| - | - | - |
| `pedido` | Sim | Número do pedido. Linhas com o mesmo número formam um só pedido |
| `sku` | Sim | Código do produto do item |
| `quantidade` | Sim | Quantidade do item, número inteiro maior que zero |
| `cliente_email` | Pelo menos uma das duas | E-mail do cliente |
| `cliente_telefone` | Pelo menos uma das duas | Telefone do cliente |
| `cliente_nome` | Não | Nome do cliente |
| `data` | Não | Data do pedido: `DD/MM/AAAA` ou `AAAA-MM-DD`, com horário `HH:MM` opcional |
| `situacao` | Não | Situação do pedido (ex.: `pago`) |
| `total` | Não | Valor total do pedido |
| `preco` | Não | Preço unitário do item |

> [!WARNING]
>
> Escreva os nomes das colunas exatamente como na tabela, sem acento: `situacao` e `preco`. Maiúsculas e minúsculas não fazem diferença, mas "situação" com acento não é reconhecida.

**Regras de leitura**

* O arquivo precisa ser **.csv**. Vírgula ou ponto e vírgula como separador, e arquivos salvos pelo Excel em português, são reconhecidos automaticamente.
* Até **500 pedidos** por arquivo. Acima disso a importação é recusada: divida o arquivo em partes menores.
* Falta de coluna obrigatória, ou de ambas as colunas de contato, recusa o arquivo inteiro.
* Linha com `pedido` em branco, `sku` em branco ou `quantidade` que não seja um inteiro maior que zero é descartada.
* Valores aceitam o formato brasileiro (`1.234,56`) e o formato com ponto decimal (`1234.56`).
* Os dados do pedido (situação, total, data e cliente) vêm da **primeira linha** dele. Se outra linha do mesmo pedido trouxer situação, total ou nome do cliente diferente, vale o da primeira e a divergência aparece na prévia.
* Sem a coluna `total`, ou com ela vazia, o total do pedido é a soma de `preco × quantidade` dos itens. Se nenhum item tiver preço, o total fica vazio.
* Sem a coluna `data`, o pedido recebe a data e a hora da importação. Uma data em formato não reconhecido é apontada na prévia, e o pedido também fica com a data da importação.
* A moeda dos pedidos importados é sempre real (BRL).
* O SKU de cada item é procurado nos seus produtos, de qualquer origem. Encontrado, o item leva o nome do produto, que é o que aparece nas mensagens. Não encontrado, o item é importado mesmo assim, sem vínculo com o catálogo e com o próprio SKU no lugar do nome.

**Prévia (passo Conferir)**

* **Resumo da importação:** Pedidos reconhecidos, Itens, **Já existem e serão ignorados** e **Sem e-mail e sem telefone**.
* **SKUs não encontrados:** cada SKU que não está no catálogo, com as linhas em que aparece.
* **Linhas descartadas:** cada linha com problema, com o número da linha no arquivo e o motivo. Avisos de data não reconhecida ou de dado divergente da primeira linha do pedido também aparecem aqui, mas essas linhas são importadas.
* Um aviso lista pelo nome as automações de segmento ativas da conta, quando houver alguma (veja abaixo).

**Pedidos repetidos**

Um pedido com o mesmo número de uma importação anterior é **ignorado por completo**: não atualiza nenhum dado e não dispara automação. Reenviar a mesma planilha, portanto, não duplica pedidos nem mensagens. Para corrigir um pedido já importado, não adianta reimportá-lo.

**Clientes e contatos**

Cada pedido novo com e-mail ou telefone cria ou atualiza o cliente dele (identificado pelo e-mail ou, sem e-mail, pelo telefone) e o contato correspondente em [Contatos](https://docs.octasend.com.br/plataforma/contatos.md). Isso acontece mesmo sem disparar automações. Pedido sem e-mail e sem telefone é importado, mas fica sem cliente.

* O e-mail e o telefone seguem a mesma regra da importação de clientes: o e-mail vira minúsculas e o telefone fica só com os dígitos. Assim, `Ana@X.com` e `ana@x.com` são o mesmo cliente.
* Um e-mail sem `@` ou um telefone com menos de 8 dígitos é tratado como ausente. Se nenhum dos dois for válido, o pedido conta como **Sem e-mail e sem telefone**.
* Células vazias de nome e de telefone não apagam os dados de um cliente que já existe. O CPF e o endereço dele também ficam como estão.

**Disparar automações**

Se a conta tem pelo menos uma automação ativa com o gatilho **Chegou um pedido**, a prévia mostra a opção **Disparar automações com gatilho "Chegou um pedido"**:

* A opção vem sempre **desmarcada**. Isso protege cargas de histórico: sem marcar, nenhum cliente recebe mensagem.
* Marcada, só os pedidos **novos** da planilha disparam essas automações, na hora. Pedidos sem e-mail e sem telefone não disparam.
* Sem nenhuma automação desse tipo ativa, a opção não aparece e a tela avisa que os pedidos importados não vão disparar mensagem.

> [!WARNING]
>
> A opção não controla as **automações de segmento**. Elas avaliam a base inteira no horário agendado de cada uma (de hora em hora, a cada 6 horas ou uma vez por dia) e podem alcançar os clientes destes pedidos na próxima execução, mesmo com a opção desmarcada. Se alguma delas não deve enxergar a carga, pause-a em [Automações](https://docs.octasend.com.br/plataforma/automacoes.md) antes de confirmar.

**Resultado e histórico**

Depois de clicar em **Confirmar importação**, o resultado mostra: Pedidos criados, Já importados antes (ignorados), Itens, Automações disparadas, Já disparadas antes (duplicadas) e Sem contato (não disparadas).

Na tela inicial da importação, o quadro **Importações realizadas** lista as 20 importações mais recentes, com o nome do arquivo, a data, quem importou, quantos pedidos foram criados, quantos foram ignorados por já terem sido importados e, quando houver, quantas linhas tiveram erro. O ícone de download baixa o arquivo original daquela importação.

> [!TIP]
>
> Para o pedido entrar no faturamento do Dashboard, use na coluna `situacao` um texto reconhecido como pago, por exemplo `pago`, `aprovado`, `faturado` ou `entregue`. Pedidos sem situação também contam como pagos. A lista completa está em [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md).

## Produtos

**E-commerce → Produtos** abre com os totais da base inteira, que não mudam com a busca:

* **Total de produtos**, com a quantidade de **variações** logo abaixo quando houver.
* **Estoque total:** soma do estoque dos produtos sem variação e de cada variação.
* **Valor em estoque:** soma de preço × estoque dos mesmos itens.

A lista mostra 20 produtos por página, com um contador do tipo "1–20 de 350 produtos". Variações não aparecem como linhas separadas: ficam dentro do produto.

* **Busca:** por nome ou SKU.
* **Visualização:** **Tabela**, **Lista** ou **Grade**. A escolha fica salva no navegador.
* **Tabela:** colunas Nome, SKU, Preço, Estoque, Origem, Vendidos, **Última atualização** e Conteúdo. Clique no cabeçalho de Nome, SKU, Preço, Estoque, Origem ou Última atualização para ordenar. A ordem padrão é alfabética.
* **Última atualização:** quando o produto foi gravado ou atualizado pela última vez na OctaSend (data e hora).
* **Lista** e **Grade:** mostram a foto do produto, o nome, o preço e o estoque (a Lista também traz SKU, categorias, origem e vendidos). Para ordenar, use **Ordenar por**: nome (A–Z ou Z–A), menor ou maior preço, maior ou menor estoque, **atualizados recentemente**, SKU ou origem. Com o módulo **Avaliações de produtos** ativo, aparece também a nota média do produto.
* **Preço:** num produto em promoção, o preço cheio aparece riscado antes do preço de venda, com o selo de desconto (ex.: "−20%"). A promoção vem da loja conectada (Nuvem Shop ou Wake) ou do campo **Preço promocional** do cadastro manual. Num produto com variações de preços diferentes, aparece "A partir de" o menor preço, e o selo mostra o maior desconto entre as variações (ex.: "até −30%").
* **Estoque:** num produto com variações, é a soma do estoque delas.
* **Vendidos:** soma das quantidades desse produto nos pedidos, em qualquer situação, inclusive cancelados. Contam os pedidos da mesma origem do produto: pedidos da loja para os produtos da loja, e pedidos de planilha para os produtos cadastrados à mão com o mesmo SKU.
* **Conteúdo:** quando o produto tem [conteúdo rico](https://docs.octasend.com.br/plataforma/conteudo-rico.md), o ícone **Ver conteúdo** abre a prévia numa nova aba.

### Detalhe do produto

Clique num produto para abrir a tela dele, com duas abas.

**Detalhes**

* Fotos (clique numa miniatura para trocar a foto em destaque), **Preço**, **Estoque** e **Vendidos**. Em promoção, o preço cheio aparece riscado, com o selo de desconto.
* SKU, Peso, Origem, **Link na loja** (botão **Ver na loja**), **Última atualização** (data e hora) e Categorias.
* Quando a plataforma informa: **Marca**, **EAN-13**, **Preço de custo**, MPN, Faixa etária, Sexo, Dimensões (cm), **Descrição**, **Especificações técnicas** e **Medidas**. Nem toda plataforma preenche todos esses campos (a Yampi, por exemplo, entrega marca, EAN, custo, especificações e medidas).
* **Variações:** tabela com SKU, os valores de cada propriedade (ex.: Tamanho, Cor), preço (com o preço cheio riscado, quando a variação está em promoção) e estoque de cada variação. Clique numa variação para abrir o painel lateral com os dados dela. Aparece quando o produto tem mais de uma variação.
* **Pedidos:** os pedidos que trazem o produto, com número, quantidade e valor do pedido. A linha inteira abre o pedido.

**Avaliações**

Resumo das avaliações aprovadas do produto: média, total de avaliações e a distribuição por nota, de 5 a 1 estrela. O botão **Nova avaliação** registra uma avaliação que chegou por outro canal (telefone, e-mail, pessoalmente); ela já entra aprovada. A aba depende do módulo **Avaliações de produtos** (módulo opcional; fale com a OctaSend para ativar). Sem o módulo, ela mostra "Módulo não liberado". Veja [Avaliações de produtos](https://docs.octasend.com.br/plataforma/avaliacoes-de-produtos.md).

### Adicionar ou editar produto

Clique em **Adicionar produto** na lista, ou no ícone de lápis na tela do produto para editar.

| Campo | Observação |
| - | - |
| **Nome** | Obrigatório |
| **SKU** | Código do produto. Some quando o produto tem variações, porque cada variação tem o seu |
| **Preço** | O preço cheio, no formato brasileiro, ex.: `2.279,30`. Some quando o produto tem variações |
| **Preço promocional** | Opcional. O preço de venda durante uma promoção, ex.: `1.990,00`. Com ele, o preço cheio aparece riscado nas telas. Some quando o produto tem variações |
| **Estoque** | Número inteiro. Some quando o produto tem variações |
| **Link na loja** | Endereço da página do produto |
| **Categorias** | Separe por vírgula. As categorias já usadas nos seus produtos aparecem como sugestão: clique para marcar ou desmarcar |
| **Peso (g)** | Em gramas |
| **Enviar fotos** | Uma ou mais imagens. Clique no X de uma foto para removê-la |

**Variações**

1. Em **Propriedades (ex.: Tamanho, Cor)**, escreva o nome das propriedades separadas por vírgula.
2. Clique em **Adicionar variante** para cada combinação. Em cada variante, preencha o valor de cada propriedade, o **SKU**, o preço, o preço promocional (opcional), o estoque, o peso, as dimensões (altura, largura e comprimento, em cm), o MPN, a **Faixa etária** (Recém-nascido, Bebê, Criança pequena, Criança ou Adulto) e o **Sexo** (Feminino, Masculino ou Unissex).
3. Para tirar uma variante, clique no ícone de lixeira dela. Ao salvar, a variante removida deixa de existir.

Regras do cadastro de produto:

* Sem nome, o produto não é salvo ("Informe o nome do produto.").
* Um preço que não pode ser lido como número é recusado ("Preço inválido. Use um número, ex.: 2.152,33.").
* O preço promocional precisa vir junto com o preço ("Informe o preço junto com o preço promocional.") e ser menor que ele ("O preço promocional precisa ser menor que o preço."). A mesma regra vale para cada variante.
* O produto é identificado pelo **SKU** ou, sem SKU, pelo **nome**. **Adicionar produto** com o SKU (ou o nome, sem SKU) de um produto já cadastrado à mão atualiza esse produto em vez de criar outro.
* Cada variante precisa de um SKU próprio, diferente dos SKUs das outras variantes e do SKU do produto. Variante sem SKU ou com SKU repetido impede o salvamento.
* Na edição, você pode trocar o SKU. Se o SKU novo já pertencer a outro produto, a tela avisa "já existe outro produto com este SKU".
* Não é possível excluir produtos pelo painel.

#### Editar um produto que veio da loja

O ícone de lápis também aparece nos produtos que vieram da Nuvem Shop ou da Wake. Nesses produtos:

* Só os campos que você alterou são gravados: o que você não tocou (por exemplo, categorias, fotos e a descrição vinda da loja) fica exatamente como está. O produto continua com a origem da loja, sem virar um segundo registro, e mantém o vínculo com vendas, avaliações e conteúdo rico.
* As variações podem ser editadas (preço, estoque, SKU), mas não adicionadas nem removidas: a tela avisa "As variações vêm da sua loja. Para adicionar ou remover uma, altere o produto por lá."

> [!WARNING]
>
> A loja continua sendo a origem dos dados. Quando o produto for sincronizado de novo, os valores da loja substituem o que você editou no painel. Para uma mudança definitiva de preço, estoque, fotos ou descrição, altere na própria loja.

## Carrinho abandonado (Wake)

Para lojas **Wake**, a OctaSend envia uma comunicação a quem deixou produtos no carrinho sem finalizar a compra. Os carrinhos não aparecem nas telas de E-commerce: eles só alimentam esse envio.

* Ao conectar a Wake, preencha o **Token da Storefront API**. Ele só é usado pelo carrinho abandonado, mas sem ele a OctaSend não consegue conferir o carrinho na Wake e nenhuma mensagem de carrinho abandonado sai.
* Ao conectar a Wake, você também define **Minutos até considerar o carrinho abandonado** (padrão: 60).
* Depois de conectada, a tela de conexão da Wake (aberta pelo botão **Editar conexão** do card) mostra o **Script de carrinho abandonado**, com o botão **Copiar**, para você colar no template da loja. Se você já instalou a tag da OctaSend no site, ela cuida do carrinho e o script não é necessário. Veja [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md).
* O carrinho só é acompanhado quando a página informa o contato do comprador. Na sua loja, preencha `window.OCTASEND_EMAIL` e `window.OCTASEND_PHONE` (e, se quiser, `window.OCTASEND_NOME`) sempre que a loja já conhecer esses dados, por exemplo com o cliente logado ou depois que ele digita o e-mail no checkout.
* No mapeamento de eventos da Wake, escolha a comunicação do evento **Carrinho abandonado**.

Quando passa o tempo configurado desde a última vez que o carrinho foi visto na loja, a OctaSend confere na Wake a situação dele antes de enviar:

* Se o carrinho virou pedido, nada é enviado.
* Se o carrinho não existe mais ou está vazio, ele é descartado.
* Sem e-mail e sem telefone do comprador, ou sem comunicação escolhida para o evento, nada é enviado.

O carrinho abandonado é uma mensagem de marketing: um comprador descadastrado de um canal não recebe a mensagem nesse canal, e o e-mail leva o link de descadastro no rodapé. Veja [Descadastro por canal](https://docs.octasend.com.br/plataforma/contatos.md#descadastro-por-canal).

A comunicação de carrinho abandonado tem as variáveis `{{cliente_nome}}`, `{{carrinho_itens}}`, `{{carrinho_total}}`, `{{carrinho_subtotal}}`, `{{carrinho_cupom}}`, `{{link_retomada}}` (link para o cliente retomar a compra), `{{primeiro_item_nome}}`, `{{primeiro_item_imagem}}`, `{{primeiro_item_sku}}` e `{{loja_nome}}`.

## Onde esses dados são usados

> [card] [Automações](https://docs.octasend.com.br/plataforma/automacoes.md)
>
> O gatilho **Chegou um pedido** dispara para pedidos das lojas e, se você marcar a opção, de planilha. Os critérios de segmento por pedido usam o histórico de compras.

> [card] [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md)
>
> A seção E-commerce mostra faturamento, ticket médio, produtos mais vendidos e melhores clientes do período.

> [card] [Conteúdo rico](https://docs.octasend.com.br/plataforma/conteudo-rico.md)
>
> O conteúdo de cada produto é ligado pelo SKU e pode entrar nas mensagens dos pedidos.

> [card] [Avaliações de produtos](https://docs.octasend.com.br/plataforma/avaliacoes-de-produtos.md)
>
> Pedidos geram o link de avaliação, e o resumo das notas aparece na tela do produto.

Detalhes que valem para esses usos:

* Nas automações de **Chegou um pedido**, as mensagens podem usar os dados do pedido e do cliente, como `{{pedido_numero}}`, `{{pedido_itens}}`, `{{pedido_total}}` e `{{cliente_nome}}`. A lista completa está em [Automações](https://docs.octasend.com.br/plataforma/automacoes.md).
* As mensagens sobre pedidos e cadastros da loja são transacionais: chegam mesmo a quem se descadastrou, sem o link de descadastro. Já as automações de segmento e o carrinho abandonado respeitam o descadastro.
* Os critérios de segmento por pedido ligam o contato ao cliente da loja pelo **e-mail**. Um cliente cadastrado só com telefone não é alcançado por esses critérios.
* A seção **E-commerce** do Dashboard só aparece depois que a conta conecta uma loja ou cadastra ou importa o primeiro cliente, pedido ou produto. O mesmo vale para o Conteúdo rico, que além disso é um módulo opcional (fale com a OctaSend para ativar).
* O [chatbot do site](https://docs.octasend.com.br/plataforma/chatbot-do-site.md) pode consultar o catálogo de produtos ao responder visitantes.

## Quem pode usar

Todos os usuários da sua conta veem os mesmos clientes, pedidos e produtos, e todos podem cadastrar clientes e produtos, editar produtos e importar planilhas. Cada conta só enxerga os próprios dados.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.