---
title: Assistentes
slug: aura/assistentes
createdAt: 2026-11-19T14:33:13.671Z
---

O **Assistente** é o seu robô. É ele que conversa com o cliente, entende o pedido, responde com o que você ensinou e transfere para um humano quando precisa. Você pode ter vários — por exemplo, um para vendas e outro para suporte.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/t81F2jW9hLBX4WBX2-cxg_a9b7e2c8c587cb61cf0c00ed6cce1dfe.jpg" alt="Cada card é um assistente" caption size="160" width="1600" height="911"} *Cada card é um assistente*

## O que compõe um assistente

Cada assistente reúne, num pacote só:

- um **fluxo de conversa** (o roteiro — veja [Fluxos de conversa](https://docs.citsmart.com/aura/fluxos-de-conversa));
- as **intenções** e **entidades** que ele entende (a inteligência);
- a **base de conhecimento** que ele consulta;
- os **canais** ligados a ele (por onde o cliente fala com esse robô).

## Criar um assistente

Duas formas:

- **+ Criar assistente** — do zero (sem fluxo). Dê um nome e depois monte o fluxo.
- **Começar com um modelo pronto** — cria o assistente **já com um fluxo de exemplo completo para editar**. **Modelos:** Loja/E-commerce (**status do pedido, troca, rastreio**), Clínica/Agendamento (**marcar, confirmar, lembrar**), Financeiro/Cobrança (**2ª via, boleto, negociação**) e RH/Interno (**benefícios, holerite**).

## O card de cada assistente

Cada assistente é um card com:

- **Nome** (clique para **renomear** na hora) e **status** (Ativo / Pausado).
- **Chips de canal** ligados (Wa, Web, Ig, Teams…) ou "Sem canal".
- **Fluxo de conversa** — botão que abre o construtor de fluxo.
- **Conversas/semana** — o volume recente.
- Ações: **Editar**, **Pausar**/**Ativar** e **Excluir**.

### Pausar, ativar e excluir

- **Pausar** — o assistente para de responder no site/canais até religar.
- **Excluir** — só é possível se o assistente **não tiver canal ligado** nem **atendimento em andamento (conversa na fila ou com atendente)**. **Os canais desligados dele ficam sem assistente, com o histórico, e podem ser religados em&#x20;**[Canais](https://docs.citsmart.com/aura/canais)**. O uso de IA e as classificações do NLU continuam nos&#x20;**[Painéis](https://docs.citsmart.com/aura/paineis), sem assistente.
- **Seleção em lote** — marque vários cards para **Pausar** ou **Excluir** de uma vez. A marcação vale entre páginas. Ao excluir, a confirmação diz quais selecionados ficam por ter canal ligado e pede para digitar o nome do assistente (quando sai um só) ou a quantidade que vai sair. Um resumo no fim mostra quantos saíram e quais ficaram, com o motivo. Se algum não puder ser pausado, o console avisa qual e por quê.

## Dentro do editor (4 abas)

Clicar em **Editar** (ou no nome do card) abre o editor do assistente, com quatro abas:

### 1. Identidade

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/qEccRO7OD6PGsRl5fvGDg_3ee5acd80a99ba879016511fbd251b62.jpg" alt="Nome, tom de voz, idiomas e continuidade omnichannel" caption size="160" width="1600" height="900"} *Nome, tom de voz, idiomas e continuidade omnichannel*

- **Nome do assistente**.
- **Tom de voz** e **Idiomas que ele atende**.
- **Continuidade omnichannel** — quando o cliente volta (mesmo por outro canal), o assistente pode **oferecer continuar** de onde parou. Você define a **mensagem da oferta** (os botões "Sim, continuar" / "Não, do zero" entram automático) e a **mensagem ao retomar**. As duas caixas já vêm com o texto que o cliente recebe: edite para trocar; se apagar tudo, a caixa volta ao texto padrão.

### 2. Configurações

Configuração e **consumo** da IA deste assistente (vale para todos os blocos de IA do fluxo).

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/87GQ12W8EGrfox9nQoTE-_931ac45772fafe78ee123eb02a58413c.jpg" alt="Uso e custo + controles de segurança da IA" caption size="160" width="1600" height="900"} *Uso e custo + controles de segurança da IA*

**Uso e custo** (com filtro 7/30/90 dias) mostra as chamadas reais aos provedores:

- **Números**: chamadas, tokens de entrada/saída, **custo estimado (US$)** e latência.
- **Por status**: Respondidas, Pelo canal reserva, Com erro, Bloqueadas pelo teto.
- **Por modelo/provedor** e **uso do mês vs. teto**.
- **Gráfico "Tokens por dia"** — colunas por dia, com o pico e detalhe ao passar o mouse (aparece quando há chamadas; sem uso, mostra um aviso).
- **Tabela de chamadas de IA** — cada chamada (quando, modelo/provedor, tokens, tempo, resultado), com filtros por **dia**, **modelo** e **status**.

**Controles de segurança** (opcionais; nos números, vazio = padrão da plataforma):

- **Timeout por chamada** — tempo máximo esperando o provedor.
- **Tamanho máximo da resposta** — limita os tokens por resposta (tamanho e custo).
- **Histórico na conversa** — quantas mensagens anteriores vão em cada chamada (0 = desliga).
- **Teto mensal de tokens** — ao atingir, novas chamadas são bloqueadas e o fluxo segue o reserva.
- **Canal de IA reserva** — se o provedor principal falhar, refaz a chamada neste.
- **Mensagem quando a IA não responder** — o que o cliente recebe quando o principal e o reserva falham. A caixa já traz o texto padrão; apagar tudo volta a ele. Com voz, a caixa de **Confirmar o que foi entendido** funciona igual ("Entendi, você disse:").

**Regras de negócio (governança da IA):**

- **Cascata** — toda chamada tenta o **provedor principal**; se ele falhar (erro ou timeout), a plataforma tenta o **canal reserva** antes de desistir. Sem reserva (ou se os dois falharem), a conversa segue pelo **fallback**.
- **Teto mensal** — ao atingir o teto de tokens no mês, **novas chamadas são bloqueadas** e o fluxo segue o fallback (protege o custo). Faixa: 1.000 a 1 bilhão.
- **Faixas** — timeout de 1 a 120 s por chamada; tamanho da resposta de 16 a 32.000 tokens.
- **Custo** — estimado por tabela de preços do provedor. Servidor de IA local = US$ 0.

### 3. Monitor de Processamento

Acompanhamento do que a IA está entendendo (base para a curadoria das intenções).

### 4. Canais

Os canais vinculados a este assistente (atalho para conectar/gerenciar).

## O que ele entende / Quando não entender

Dois painéis (também abertos de dentro do editor de fluxo):

- **O que ele entende** — os **Assuntos** (intenções): cada assunto reúne as frases que a pessoa pode dizer; a resposta é definida no fluxo. Veja [Intenções](https://docs.citsmart.com/aura/intencoes-ia) e [Entidades](https://docs.citsmart.com/aura/entidades). Para carregar vários de uma vez, **Modelo** (CSV ou JSON) dá o arquivo já no formato aceito — colunas `assunto,frases,resposta`, frases separadas por `|`, resposta opcional — e o botão **i** explica cada campo. Ao **Importar**, a tela mostra, antes de gravar, o que acontece com cada linha: **criar**, **atualizar** (assunto que já existe: as frases somam às atuais) ou **não entra** (sem nome, ou sem frase e sem resposta). Nome repetido no arquivo é unido numa linha só. **Baixar** exporta os assuntos atuais no mesmo formato. Para excluir vários de uma vez, marque a caixa de cada assunto ou use **Selecionar todos**, que marca todos os assuntos da lista em todas as páginas (com um filtro ativo, só os que aparecem no filtro; mudar o filtro limpa a seleção). **Excluir selecionados** pede confirmação com a quantidade e avisa quais estão em uso no fluxo publicado, no rascunho em teste ou num esclarecimento. A exclusão não altera o fluxo nem o esclarecimento, e não pode ser desfeita.
- **Quando não entender (fallback)** — **O que ele responde** (pede para reformular, com prévia; a caixa já traz o texto padrão, e apagar tudo volta a ele) e **Quando chamar um atendente**: ligar por "a pessoa pedir por um humano" e/ou "não entender várias vezes seguidas" (escala após N tentativas), escolhendo a fila de destino.

Do editor você também abre o [Fluxo de conversa](https://docs.citsmart.com/aura/fluxos-de-conversa) (o roteiro visual).

## Boas práticas

- **Um assistente por objetivo** (vendas, suporte, cobrança) — fica mais fácil de manter e de medir nos painéis.
- **Sempre deixe um caminho de falar com humano.**
- **Configure o "Quando não entender"** — é o que segura a experiência quando o cliente escreve algo inesperado.
- **Teste no widget do site** antes de divulgar num canal público.
