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

O que compõe um assistente
Cada assistente reúne, num pacote só:
- um fluxo de conversa (o roteiro — veja 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 Canais. O uso de IA e as classificações do NLU continuam nos Painéis, 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

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

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