Como Criar um Agente de Atendimento com Botpress Usando os Documentos da Empresa

O Agente Só é Tão Bom Quanto o que Ele Lê

No Botpress, a base de conhecimento é o conjunto de documentos que o agente consulta antes de responder: páginas do site, PDFs, tabelas de preço, políticas, FAQs. O modelo de linguagem faz a conversa soar natural; a base define se a resposta é verdade. Confundir os dois é o erro de quem sobe um agente no site em uma tarde e passa o mês seguinte apagando incêndio.

Três regras de organização que fazem diferença prática:

• Um assunto por documento. Um PDF de 40 páginas misturando política de troca, frete e garantia gera resposta que mistura os três. Documentos curtos e temáticos produzem respostas precisas.
• Linguagem do cliente, não do jurídico. O agente responde com o que lê. Se a política de troca está escrita em juridiquês, o cliente recebe juridiquês. Reescreva os trechos-chave em linguagem clara antes de subir.
• Versão e dono. Cada documento da base precisa de uma pessoa responsável por atualizá-lo quando a regra muda. Base desatualizada é agente que mente com confiança.

Comece pelo que Responde 80% das Perguntas

Entram primeiro: perguntas frequentes reais do atendimento (peça ao time as 30 mais comuns), política de troca e devolução, prazos e condições de entrega, formas de pagamento, horários e canais, escopo do que a empresa faz e não faz. Esse conjunto costuma cobrir a grande maioria das interações.

Entram depois: catálogo detalhado, comparativos técnicos, casos específicos por segmento.

Ficam de fora: qualquer coisa sujeita a negociação caso a caso (descontos, condições especiais), dados internos, e regras que mudam toda semana — informação volátil na base é resposta errada garantida. Estratégia de preço negociável é território do humano.

A Resposta mais Importante é "Não Sei"

Um agente bem configurado tem comportamento explícito para o vazio: quando a consulta à base não retorna informação suficiente, ele diz que não tem essa informação e oferece o caminho humano. No Botpress isso se configura com instruções do agente e com um fluxo de fallback — a pior configuração possível é deixar o modelo "ser criativo" quando não acha nada.

A frase de fallback merece o mesmo cuidado de um roteiro de vendas. "Não encontrei essa informação, mas vou te conectar com alguém do time — pode me dizer o melhor horário?" resolve três coisas: não inventa, não abandona o cliente e já captura o dado para o atendimento humano.

E registre tudo: cada pergunta sem resposta na base é uma lacuna de conteúdo. Revise semanalmente o log de fallbacks no início — é o mapa do que falta escrever.

O Agente Sabe Quando Sair da Frente

Quatro gatilhos de transferência que configuramos como padrão: o cliente pede explicitamente ("quero falar com alguém" não se discute, se executa); a conversa envolve dinheiro fora do padrão (negociação, reembolso, contestação); duas falhas seguidas de compreensão ou de resposta; e sinal de forte insatisfação — reclamação pública, ameaça de cancelamento, tom alterado.

A transferência precisa levar contexto: o humano recebe o histórico da conversa, não um lead frio. Cliente que repete pela terceira vez o que já escreveu é cliente que desiste. No Botpress, o handoff pode ir para o inbox da própria plataforma, para o WhatsApp via integração ou para o CRM como tarefa — o destino importa menos que o contexto viajar junto.

Defina a Cerca Antes de Soltar o Animal

Escreva por extenso o que o agente nunca faz: não confirma desconto, não promete prazo fora da tabela, não opina sobre concorrente, não trata dados sensíveis além do necessário. Essas instruções entram no prompt do agente e nos testes antes da publicação.

Na Arquitetura de Receita, o agente de atendimento é capacidade de resposta: atende em segundos o que antes esperava horas, e filtra o que chega ao humano. O ganho real não é cortar atendente — é o time humano gastar o tempo em conversas que geram receita ou salvam clientes, enquanto a máquina responde "qual o horário de funcionamento" às 23h de um domingo.