> For the complete documentation index, see [llms.txt](https://delivery.ajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://delivery.ajuda.cc/geral/deliverybot/assistente-de-atendimento/otimizar-catalogo-para-o-assistente.md).

# Otimizar catálogo para o assistente

O assistente de atendimento busca informações diretamente do seu catálogo para responder aos clientes. Quanto melhor organizado e preenchido estiver o seu catálogo, mais precisas e convincentes serão as respostas do assistente — e mais vendas você vai converter.

Este guia mostra as boas práticas para preparar seu catálogo e tirar o máximo do atendimento automatizado.

## Por que o catálogo importa tanto?

Quando um cliente pergunta "tem pizza?", o assistente busca no seu catálogo por produtos que contenham essa palavra. Se o nome do produto for apenas "Margherita" sem mencionar "pizza", o assistente pode não encontrar.

O assistente **nunca inventa informações**. Ele responde apenas com o que encontra no catálogo. Se um produto não tem descrição, ele não tem como explicar o que é. Se não tem foto, ele não tem como mostrar.

{% hint style="warning" %}
Um catálogo bem preenchido é a diferença entre um assistente que vende e um que apenas responde "não encontrei".
{% endhint %}

## 1. Nomes de produtos claros e descritivos

O nome do produto é o principal campo usado na busca. Ele deve ser claro o suficiente para que o cliente encontre o que procura.

### O que fazer

* Use nomes que descrevam o produto de forma natural
* Inclua o tipo/categoria no nome quando fizer sentido
* Pense em como o cliente pediria o produto no WhatsApp

### Exemplos

| Ruim             | Bom                               | Por quê                                        |
| ---------------- | --------------------------------- | ---------------------------------------------- |
| Margherita       | Pizza Margherita                  | Cliente busca por "pizza" e encontra           |
| Nº 12            | Hambúrguer Artesanal Nº 12        | Cliente busca por "hambúrguer" e encontra      |
| Combo 1          | Combo Hambúrguer + Batata + Refri | Cliente entende o que vem no combo             |
| Especial da casa | Açaí Especial da Casa 500ml       | Cliente busca por "açaí" e encontra            |
| Promoção         | Pizza Grande 2 Sabores - Promoção | Cliente sabe exatamente o que está em promoção |

{% hint style="info" %}
Pense nas palavras que seu cliente digitaria no WhatsApp para pedir o produto. Essas palavras devem estar no nome.
{% endhint %}

## 2. Descrições completas e atrativas

A descrição é o que o assistente usa para explicar o produto ao cliente. Sem descrição, ele só consegue dizer o nome e o preço.

### O que incluir na descrição

* **Ingredientes principais** — o que vem no produto
* **Tamanho/quantidade** — peso, volume, quantidade de itens
* **Diferenciais** — o que torna o produto especial
* **Informações para restrições** — se é vegetariano, sem glúten, sem lactose, etc.

### Exemplos

| Produto             | Descrição ruim                | Descrição boa                                                                                                                                |
| ------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Pizza Margherita    | *(sem descrição)*             | Massa artesanal fina, molho de tomate italiano, mozzarella de búfala, manjericão fresco e azeite extra virgem. Serve 2 pessoas.              |
| Hambúrguer Especial | Hambúrguer com queijo e bacon | Pão brioche, blend bovino 180g, queijo cheddar, bacon crocante, alface americana, tomate e molho especial da casa. Acompanha batata rústica. |
| Açaí da Casa 500ml  | Açaí com acompanhamentos      | Açaí puro 500ml com granola, banana, morango e leite condensado. Opção vegana disponível sem leite condensado.                               |

{% hint style="info" %}
Um cliente perguntou "tem opção vegetariana?". Se a descrição mencionar "vegetariano", o assistente vai encontrar e sugerir. Se não mencionar, ele não tem como saber.
{% endhint %}

## 3. Fotos de qualidade

O assistente envia fotos dos produtos no WhatsApp em momentos estratégicos — quando sugere um produto, quando há promoção ou quando o cliente pede para ver. Uma boa foto pode ser decisiva para a venda.

### Boas práticas para fotos

* **Use fotos reais** dos seus produtos, não imagens genéricas da internet
* **Boa iluminação** — fotos escuras ou amareladas afastam o cliente
* **Fundo limpo** — destaque o produto, evite cenários poluídos
* **Proporção quadrada** — funciona melhor no WhatsApp
* **Todos os produtos com foto** — produtos sem foto perdem a oportunidade de venda visual

{% hint style="warning" %}
O assistente só consegue enviar a foto se ela estiver cadastrada no produto. Sem foto, ele responde apenas com texto.
{% endhint %}

## 4. Categorias bem organizadas

As categorias ajudam o assistente a entender o contexto dos produtos e fazer sugestões mais inteligentes. Cada produto pertence a uma categoria, e o nome dessa categoria é usado pelo assistente para agrupar e buscar produtos.

### Como organizar

* **Nomes de categoria claros** — "Pizzas", "Hambúrgueres", "Bebidas", "Sobremesas" em vez de abreviações ou códigos internos
* **Produtos na categoria certa** — uma Coca-Cola deve estar em "Bebidas", não misturada em "Combos"
* **Separe combos e promoções** — facilita quando o cliente pergunta "o que tem de promoção?"

### Exemplos

| Ruim     | Bom                 | Por quê                                                       |
| -------- | ------------------- | ------------------------------------------------------------- |
| Cat. 01  | Pizzas Salgadas     | Cliente busca por "pizza" e o assistente encontra a categoria |
| Diversos | Bebidas             | O assistente sabe sugerir uma bebida para acompanhar o pedido |
| Promos   | Promoções da Semana | Cliente pergunta "tem promoção?" e o assistente localiza      |

### Por que isso importa para o assistente

Quando o cliente pede uma pizza, o assistente pode sugerir uma bebida como complemento. Ele faz isso buscando produtos na categoria de bebidas. Se seus produtos estiverem todos em categorias genéricas como "Diversos", ele perde essa capacidade de sugestão.

| O cliente pediu... | O assistente sugere da categoria... | Exemplo                                                                       |
| ------------------ | ----------------------------------- | ----------------------------------------------------------------------------- |
| Uma pizza          | Bebidas                             | "E pra acompanhar, que tal um refrigerante? Temos Coca-Cola 2L por R$ 12,90!" |
| Um hambúrguer      | Bebidas                             | "Quer adicionar uma bebida? Temos suco natural por R$ 9,90!"                  |
| Um prato executivo | Sobremesas                          | "De sobremesa, nosso Petit Gateau tá em promoção hoje!"                       |

## 5. Preços sempre atualizados

O assistente informa o preço exatamente como está no catálogo. Preço desatualizado gera frustração e perda de confiança.

### Checklist de preços

* Verifique se todos os produtos têm preço cadastrado
* Atualize os preços sempre que houver mudança
* Confira os preços dos modificadores (adicionais, tamanhos, sabores)
* Se o produto tem promoção, cadastre o preço original e o preço promocional

{% hint style="success" %}
Quando um produto tem preço promocional, o assistente destaca automaticamente o desconto: "De ~~R$ 55,00~~ por R$ 45,00!". Isso aumenta a conversão.
{% endhint %}

## 6. Promoções e destaques

O assistente busca ativamente por promoções e destaques para sugerir aos clientes. Use esses recursos para impulsionar vendas.

### Promoções

* Cadastre o **preço original** e o **preço promocional** no produto
* O assistente identifica automaticamente e destaca o desconto
* Na primeira mensagem do cliente, o assistente já mostra as promoções disponíveis

### Destaques

* Marque como destaque os produtos que você quer promover
* O assistente sugere destaques quando o cliente está indeciso
* Use destaques para novidades, mais vendidos ou produtos sazonais

{% hint style="info" %}
Na primeira conversa, o assistente já envia o link da loja e menciona uma promoção ou destaque. É a sua vitrine automática no WhatsApp.
{% endhint %}

## 7. Modificadores bem configurados

Modificadores são as opções de personalização dentro de um produto (tamanhos, sabores, adicionais). O assistente entende que modificadores fazem parte do produto e não são itens separados.

### Boas práticas

* **Nomes claros** para os grupos de modificadores: "Escolha o tamanho", "Adicionais", "Sabor da borda"
* **Todas as opções com preço** — inclusive quando o adicional é gratuito (preço R$ 0,00)
* **Mínimo e máximo definidos** — quantas opções o cliente pode/deve escolher

### Exemplo

```
Produto: Pizza Margherita
├── Modificador: Escolha o tamanho (mín: 1, máx: 1)
│   ├── Pequena (4 fatias) — R$ 29,90
│   ├── Média (6 fatias) — R$ 39,90
│   └── Grande (8 fatias) — R$ 49,90
└── Modificador: Adicionais (mín: 0, máx: 5)
    ├── Borda recheada — R$ 8,00
    ├── Extra mozzarella — R$ 5,00
    └── Molho especial — R$ 3,00
```

{% hint style="info" %}
O assistente não vende modificadores separadamente. Se o cliente pedir "quero borda recheada", o assistente vai explicar que a borda é um adicional da pizza e enviar o link do produto para o cliente montar o pedido.
{% endhint %}

## Checklist rápido

Use esta lista para revisar seu catálogo:

* [ ] Todos os produtos têm nomes descritivos e buscáveis
* [ ] Todos os produtos têm descrição com ingredientes e detalhes
* [ ] Todos os produtos têm foto cadastrada
* [ ] Os produtos estão organizados em categorias claras
* [ ] Os preços estão atualizados
* [ ] Promoções têm preço original e preço promocional definidos
* [ ] Destaques estão marcados nos produtos que você quer promover
* [ ] Modificadores têm nomes claros e preços definidos
* [ ] Informações de restrições alimentares estão nas descrições (vegetariano, sem glúten, etc.)

## Resultado na prática

Um catálogo otimizado transforma a experiência do cliente:

**Antes (catálogo incompleto):**

> Cliente: "Tem algo vegetariano?"
>
> Assistente: "Não encontrei produtos com essa informação. Você pode conferir nosso cardápio completo aqui: \[link da loja]"

**Depois (catálogo otimizado):**

> Cliente: "Tem algo vegetariano?"
>
> Assistente: "Temos sim! A Pizza Margherita (massa artesanal, mozzarella de búfala e manjericão) é vegetariana — R$ 45,90. E o Hambúrguer de Grão de Bico também, por R$ 32,90! Quer ver a foto de algum deles?"

{% hint style="success" %}
A qualidade do seu catálogo é a qualidade do seu atendimento automatizado. Invista alguns minutos revisando e o retorno será em vendas.
{% endhint %}


---

# 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://delivery.ajuda.cc/geral/deliverybot/assistente-de-atendimento/otimizar-catalogo-para-o-assistente.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.
