> 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/gerenciamento-de-conversas.md).

# Gerenciamento de conversas

O DeliveryBot oferece comandos para controlar o assistente em cada conversa. Todos os comandos são enviados diretamente na janela de chat do WhatsApp.

{% hint style="info" %}
Todas as notificações e confirmações do bot são enviadas para o **chat do próprio dono** (conversa consigo mesmo no WhatsApp), nunca para o cliente.
{% endhint %}

## Comandos disponíveis

### Pausar o bot

**Comando:** `/bot pausar`\
**Aliases:** `pause`, `parar`, `stop`

Pausa o assistente em uma conversa específica. Aceita duração opcional:

* `/bot pausar` — Pausa indefinida (precisa retomar manualmente)
* `/bot pausar 30m` — Pausa por 30 minutos
* `/bot pausar 2h` — Pausa por 2 horas
* `/bot pausar 1d` — Pausa por 1 dia

Formatos de tempo aceitos: `m` (minutos), `h` (horas), `d` (dias).

{% hint style="info" %}
Pausas com tempo definido expiram automaticamente e o dono recebe uma notificação quando o bot retoma o atendimento.
{% endhint %}

### Retomar o bot

**Comando:** `/bot retomar`\
**Aliases:** `resume`, `start`, `ativar`

Reativa o assistente em uma conversa pausada.

### Retomar todos

**Comando:** `/bot retomar todos`\
**Alias:** `resume all`

Reativa o assistente em **todas** as conversas pausadas de uma vez.

### Ver status

**Comando:** `/bot status`

Mostra se o bot está ativo ou pausado naquela conversa. Se pausado, mostra o motivo e quando expira.

### Listar pausados

**Comando:** `/bot pausados`\
**Aliases:** `lista`, `list`

Lista todos os chats que estão com o bot pausado.

### Estatísticas de uso

**Comando:** `/bot uso`\
**Aliases:** `usage`, `stats`, `estatisticas`

Mostra estatísticas de uso do bot (mensagens recebidas, enviadas, etc.). Aceita período opcional:

* `/bot uso hoje` — Estatísticas do dia
* `/bot uso ontem` — Estatísticas do dia anterior
* `/bot uso semana` — Estatísticas da semana
* `/bot uso mes` — Estatísticas do mês
* `/bot uso 7d` — Últimos 7 dias
* `/bot uso 24h` — Últimas 24 horas

Sem período, mostra as últimas 24 horas.

### Resetar conversa

**Comando:** `/bot resetar`\
**Alias:** `reset`

Recomeça a conversa do zero, apagando o contexto anterior. Útil quando as instruções do assistente são atualizadas.

### Ajuda

**Comando:** `/bot ajuda`\
**Alias:** `help`

Lista todos os comandos disponíveis diretamente no chat.

## Pausa automática

Quando um atendente envia uma mensagem ao cliente, o DeliveryBot é automaticamente pausado por **30 minutos** naquela conversa. Isso permite que o atendente interaja diretamente com o cliente sem interrupções da IA.

**Como funciona:**

* **Pausa automática** — Após o atendente enviar uma mensagem, o bot entra em pausa por 30 minutos
* **Timer fixo** — Se o bot já estiver pausado, enviar outra mensagem **não** reinicia o timer
* **Retorno automático** — Após os 30 minutos, o bot retoma o atendimento automaticamente

{% hint style="info" %}
Quando um chat está pausado e o cliente envia uma mensagem, o dono recebe um lembrete no seu próprio chat. O intervalo mínimo entre lembretes é de 5 minutos.
{% endhint %}

## Transferência automática para atendente

O assistente detecta automaticamente quando não consegue resolver a solicitação do cliente e transfere a conversa para um atendente humano.

**Como funciona:**

* **Detecção automática** — O assistente identifica quando o assunto foge do escopo das informações configuradas
* **Duas tentativas** — Antes de transferir, o assistente tenta fazer até 2 perguntas para entender melhor a necessidade do cliente
* **Transferência imediata** — Em algumas situações a transferência acontece sem tentativas:
  * Cliente pede explicitamente para falar com um humano
  * Cliente está frustrado ou fazendo uma reclamação
  * Problemas com pedidos em andamento
  * Questões de segurança alimentar
* **Pausa de 1 hora** — Após a transferência, o bot fica pausado por 1 hora naquela conversa
* **Notificação ao proprietário** — O dono da loja recebe uma notificação informando que um cliente precisa de atendimento humano

{% hint style="info" %}
Após o período de pausa de 1 hora, o assistente retoma o atendimento automaticamente. Para retomar antes, use `/bot retomar`.
{% 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/gerenciamento-de-conversas.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.
