Como escrever instruções e uma base de conhecimento para o chatbot que funcionem de verdade

Por que a maioria dos chatbots dá respostas vagas

Um chatbot vale só o que valem as duas coisas que você dá a ele: suas instruções e seu conhecimento. Se você acerta, ele responde como seu melhor funcionário no melhor dia dele. Se você erra, ele faz o que os chatbots decepcionantes fazem: enrola, devolve a pergunta ou inventa com segurança uma resposta que não é verdade.

Um bot que decepciona quase sempre vem de uma de duas lacunas. Ou as instruções são pobres demais — "Você é um assistente útil para a Acme" — e o bot não faz ideia de como se comportar, do que deve cuidar ou do que fazer quando empaca. Ou a base de conhecimento está vazia, e o bot não tem informações reais nas quais se apoiar e recorre a frases genéricas.

Este guia resolve as duas. Ele explica a diferença entre elas — as instruções são como o bot se comporta, o conhecimento é o que ele sabe — e depois conduz você a escrever bem cada uma, a definir limites honestos e pelo curto ciclo de teste e ajuste que transforma um bot mediano em um em que os clientes confiam. Não é preciso nenhum conhecimento técnico. Se você sabe escrever um e-mail curto para alguém recém-contratado, sabe fazer isto.

Instruções e base de conhecimento: dois trabalhos diferentes

A ideia mais útil deste guia inteiro: instruções e conhecimento são dois trabalhos separados, e confundi-los é o erro mais comum de quem está começando.

Imagine contratar alguém para a sua recepção. No primeiro dia, você diria dois tipos de coisas. Primeiro, como fazer o trabalho: "Seja cordial, mas direto. Se alguém perguntar sobre preços, explique as opções. Se você não souber algo, não chute — pegue o e-mail da pessoa e diga que vamos retornar." Isso são as instruções. Segundo, as informações de que ele precisa: seu horário, os preços, a política de devolução, onde estacionar. Isso é o conhecimento.

Quando você coloca informações no campo de instruções — "Abrimos às 9h, uma consulta custa $50…" — duas coisas dão errado. As instruções ficam longas e confusas, então as orientações de comportamento se diluem e o bot as segue com menos fidelidade. E as informações mudam: quando seu horário muda, você tem que cavar numa parede de texto de comportamento para corrigir uma linha. Mantenha-as separadas. As instruções ficam curtas e estáveis; as informações vivem na base de conhecimento, onde são atualizadas rapidinho.

Escrever instruções que funcionam

Boas instruções respondem a quatro perguntas para o seu bot, em linguagem simples. Você encontra o campo com o rótulo "Instruções para seu bot" nas configurações do bot.

1. Quem é ele? Dê um papel e diga qual negócio ele representa. "Você é o assistente da Lumière Aesthetic Clinic, uma clínica de pele e estética." Uma frase.
2. Que tom deve ter? Defina-o em poucas palavras, mais uma linha de orientação. "Cordial, tranquilizador e direto. Use frases curtas. Soe como uma pessoa prestativa, não como um folheto."
3. Do que ele cuida? Cite os assuntos para os quais ele está ali, para que não saia do trilho. "Você ajuda com tratamentos, preços, consultas, horário de funcionamento e como agendar."
4. O que ele deve fazer quando empaca? Essa é a que quase todo mundo esquece, e a mais importante. Diga ao bot exatamente o que fazer quando não sabe ou não pode ajudar. "Se você não souber a resposta, diga isso com honestidade e convide o visitante a deixar o e-mail para que uma pessoa possa retornar. Nunca chute um preço nem dê conselhos médicos — para qualquer dúvida clínica, convide o visitante a agendar uma consulta."

Juntas, instruções completas se leem como um briefing curto para alguém recém-contratado:

Você é o assistente da Lumière Aesthetic Clinic, uma clínica de pele e estética.
Seja cordial, tranquilizador e direto — frases curtas, sem jargão.
Você ajuda com tratamentos, preços, consultas, horário de funcionamento e como agendar.
Se alguém quiser agendar, ou perguntar algo sobre o que você não tem certeza, convide a pessoa a deixar nome e e-mail e diga que vamos retornar em breve.
Nunca invente um preço nem dê conselhos médicos ou sobre tratamentos — para qualquer dúvida clínica, convide a agendar uma consulta.

Mantenha-as curtas. Você tem cerca de 2.000 caracteres — mais ou menos quatro parágrafos breves — e mais curto costuma ser melhor. Meia página focada vence duas páginas de regras que o bot só segue pela metade. Encarando um campo em branco? Anote alguns tópicos soltos e passe pelo otimizador integrado (o botão com a varinha ao lado das instruções): ele organiza notas brutas em instruções limpas que você pode editar depois.

O que colocar na sua base de conhecimento

A base de conhecimento é de onde o bot tira as informações. A regra prática: se um cliente pode perguntar, vai aqui. A maioria dos pequenos negócios cobre 90% das perguntas reais com uma única página de informações bem organizadas.

Comece pelas perguntas que você já responde dez vezes por semana. Abra seu e-mail, suas mensagens, as notas do celular — as perguntas que voltam sempre são exatamente o que o bot deve saber de cor. Depois adicione o essencial:

• Horário de funcionamento, mais feriados e exceções.
• O que você vende ou oferece, com preços ou faixas de preço onde puder informar.
• Localização, estacionamento, como chegar e áreas de entrega ou atendimento.
• Políticas: devoluções, reembolsos, cancelamentos, sinais, garantias.
• Como agendar, pedir ou entrar em contato.
• As cinco a dez perguntas que você está cansado de responder na mão.

Você pode escrever tudo isso direto ou fazer upload. A base de conhecimento aceita texto colado e arquivos PDF, DOCX, XLSX, CSV, TXT e Markdown, de até 5 MB cada — então um documento de FAQ existente, uma tabela de preços ou um folheto de serviços podem entrar do jeito que estão, e o bot lê o texto deles. Você pode combinar fontes: cole seu horário, suba sua tabela de preços, cole suas políticas.

Como estruturar o conhecimento para o bot encontrar

Como você organiza o conhecimento importa quase tanto quanto o que está nele. Uma parede de texto funciona, mas uma levemente estruturada funciona melhor — o bot acha a informação certa mais rápido e confunde menos.

Três hábitos fazem uma diferença real:

• Um assunto por título. Agrupe as informações sob títulos curtos — Horário, Tratamentos, Preços, Consultas, Agendamento. O editor de conhecimento tem uma barra que adiciona os títulos para você, ou você pode digitar dois sinais de cerquilha (##) na frente de uma linha. Os títulos dão ao bot pontos de referência.
• Uma informação por linha. "Uma consulta custa $50 e é abatida de qualquer tratamento agendado em até 30 dias" na própria linha é mais fácil de o bot citar com exatidão do que a mesma informação enterrada num parágrafo longo.
• Escreva do jeito que o cliente pergunta. Se os clientes perguntam "vocês fazem depilação a laser?", tenha uma linha que diz "Depilação a laser a partir de $90 por sessão." Espelhe a pergunta, e o bot responde limpo.

Uma base de conhecimento bem estruturada fica assim:

## Horário de funcionamento
Seg–Sex: 9h–19h
Sábado: 9h–14h
Domingo e feriados: fechado

## Consultas e preços
Consulta: $50, abatida de qualquer tratamento agendado em até 30 dias.
Tratamentos antirrugas: a partir de $250.
Preenchimentos dérmicos: a partir de $400.

Mantenha atualizada. A base de conhecimento guarda um histórico de versões, então você pode editar à vontade e voltar atrás se mudar de ideia. Quando seus preços, horários ou políticas mudarem, atualize a base de conhecimento no mesmo dia. Um bot que informa os preços do ano passado é pior do que não ter bot.

Lidar com perguntas que ele não deveria responder

Um bot confiável conhece seus limites. Dois tipos de pergunta precisam de um plano: as que ele não deveria responder e as que ele simplesmente não pode.

Não deveria responder. Algumas coisas são delicadas demais para deixar a um bot — um sintoma médico, uma questão jurídica, uma reclamação sobre uma fatura. Cite essas nas instruções e diga ao bot para passar adiante em vez de improvisar. "Para qualquer coisa relacionada a uma preocupação médica, não dê conselhos — convide o paciente a ligar para a clínica no número que está no seu conhecimento." A honestidade aqui protege a sua reputação.

Não pode responder. Para tudo o que o bot simplesmente não sabe, o pior resultado é uma resposta errada dada com segurança. A solução é uma linha nas suas instruções: "Se você não sabe, diga com clareza e ofereça-se para passar a pergunta a uma pessoa." Depois dê ao visitante uma saída de verdade — é para isso que serve a opção "Falar com uma pessoa". Ela vem ativada por padrão: o visitante abre o menu do chat, clica e deixa nome e e-mail, e a mensagem cai na sua caixa de entrada.

Dito isso, não sobrecarregue o bot correndo atrás de contatos. O trabalho principal dele é responder perguntas; o repasse a uma pessoa é a saída de emergência para quando ele não consegue. Deixe a porta aberta, mas deixe o bot fazer primeiro o trabalho de verdade.

Teste, leia as conversas, ajuste

Ninguém escreve instruções perfeitas na primeira tentativa, e tudo bem. O bot fica bom graças a um ciclo curto, não a uma única sentada.

Teste antes de publicar. Todo bot tem um testador em sandbox onde você pode conversar com ele em particular, antes que ele chegue perto de um cliente (as mensagens no sandbox custam cerca de metade dos créditos normais, então uma sessão de testes caprichada sai barato). Faça as perguntas incômodas: os casos extremos, as coisas que ele não deveria tocar, a mesma pergunta formulada de três jeitos diferentes. Você vê as lacunas em poucos minutos.

Leia as conversas reais. Quando estiver no ar, cada conversa aparece no seu painel. Isso é ouro. Cada pergunta que o bot atrapalhou é uma linha que você pode adicionar à base de conhecimento; cada vez que ele saiu do tom é um pequeno ajuste nas instruções. Passe os olhos nas conversas toda semana no primeiro mês.

Corrija e repita. Viu ele chutar um preço? Adicione o preço à base de conhecimento. Viu ele enrolar? Aperte a linha do tom. Viu uma pergunta que ele deveria encaminhar? Adicione uma regra. Cada correção é pequena, e depois de duas ou três rodadas o bot dá conta sozinho da grande maioria das perguntas reais.

Um exemplo na prática: antes e depois

Veja a diferença na prática, para uma imobiliária.

Antes — uma configuração pobre

Instruções: "Você é um assistente útil para uma imobiliária." Base de conhecimento: vazia.

Um visitante pergunta: "Qual é a comissão de vocês, e alguém pode me mostrar o apartamento da rua do Moinho neste sábado?" O bot responde com algo vago e genérico — "Nossas comissões variam, entre em contato para detalhes, e a disponibilidade de visitas muda" — que é exatamente a não-resposta que manda um contato de alto valor direto para uma imobiliária concorrente.

Depois — uma boa configuração

Instruções: um papel (assistente da Apex Realty), um tom (profissional, ágil, prestativo), um escopo (imóveis, visitas, avaliações, comissões e as áreas atendidas) e um recurso (para uma avaliação ou proposta específica, pegue os dados do visitante e repasse a um corretor; nunca prometa um preço nem garanta um horário de visita). Base de conhecimento: as áreas atendidas, a estrutura de comissões, como funcionam visitas e avaliações, o horário do escritório e as dez perguntas que a equipe responde todo dia.

Mesma pergunta, nova resposta: "Nossa comissão de venda é de 1,5% mais impostos, e atendemos toda a zona norte da cidade. Posso pegar seu nome e telefone e fazer um corretor confirmar uma visita para sábado — faço isso?" Essa é uma resposta que captura um contato que vale milhares.

Nada na segunda imobiliária é mais técnico do que na primeira. O dono só fez bem os dois trabalhos: disse ao bot como se comportar e deu a ele as informações. Para mais uma dúzia de exemplos na prática em setores diferentes, veja 12 exemplos de chatbot por setor.

Erros comuns a evitar

• Fatos nas instruções. Preços e horários vão na base de conhecimento, não no texto de comportamento. Mantenha-os separados para que os dois continuem fáceis de gerenciar.
• A não-instrução do "assistente útil". "Você é um assistente útil" não diz nada ao bot. Dê a ele um papel, um tom, um escopo e um recurso.
• Sem recurso. Se você escrever uma única regra, que seja a honesta: "Não sei — vou passar você para uma pessoa".
• Despejar o site inteiro. Uma página focada de informações vence cinquenta páginas de texto de marketing.
• Conhecimento desatualizado. Atualize preços e horários no dia em que mudam. Uma resposta errada é pior do que nenhuma resposta.
• Instruções longas demais. Passando de meia página mais ou menos, o bot começa a perder o fio. Vence o mais curto e nítido.

Resumo e próximo passo

Dois trabalhos, mantidos separados, e um ciclo curto para ajustá-los — é nisso que consiste todo o ofício.

• As instruções dizem ao bot como se comportar: papel, tom, escopo e um recurso honesto. Mantenha-as em meia página.
• A base de conhecimento guarda o que o bot sabe: horários, preços, políticas, FAQ. Estruture com títulos, uma informação por linha, e mantenha atualizada.
• Teste, leia, ajuste. Faça as perguntas incômodas no sandbox, leia as conversas reais toda semana e corrija as lacunas.

Faça essas três coisas e o seu bot responde como alguém que realmente trabalha ali. O jeito mais rápido de começar é partir de um template que já tem as duas escritas para o seu setor — veja os planos e os créditos, ou siga o guia de configuração em cinco minutos do início ao fim.