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

Exemplo de resposta:

```
📊 Estatísticas de Uso (últimas 24h)

Atendimentos:
👥 Conversas: 12
📣 Via anúncio (Meta): 4
💬 Mensagens recebidas: 50
📤 Mensagens enviadas: 48
```

A linha **Via anúncio (Meta)** conta os clientes cujo primeiro contato no período veio de um anúncio Click-to-WhatsApp do Facebook ou Instagram. Ela só aparece quando houve pelo menos uma conversa vinda de anúncio no período.

### 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 %}