Como Criar um App de Chatbot com IA: Chaves, Prompts, Custos e Segurança

Para criar um app de chatbot com IA você precisa de quatro coisas: uma interface de chat, um pequeno servidor que guarda a chave de API do provedor e encaminha as mensagens para ele, um prompt de sistema que diz ao modelo quem ele é e o que pode fazer, e limites que mantêm os custos e o uso indevido sob controle. Um construtor de apps com IA consegue escrever tudo isso a partir de uma descrição. O trabalho que continua sendo seu é escolher o provedor, escrever as instruções e decidir o que o bot nunca deve fazer.

Do que é feito um app de chatbot com IA

A maioria dos apps de chatbot, seja um assistente de suporte, um tutor ou uma ferramenta interna do tipo “pergunte à nossa documentação”, tem as mesmas partes:

Parte	O que faz	Dá para pular?
Interface do chat	Lista de mensagens, campo de digitação, estado de “pensando” e respostas em streaming	Não
Rota do servidor	Recebe a mensagem do usuário, adiciona o prompt de sistema e chama o provedor com sua chave secreta	Não, a chave nunca pode chegar ao navegador
Prompt de sistema	Instruções permanentes: papel, tom, escopo e o que recusar	Não
Conhecimento	O seu conteúdo que o bot usa para responder (FAQ, políticas, documentação de produtos)	Sim, para um assistente geral
Armazenamento de conversas	Salva as conversas em um banco de dados para que o usuário possa voltar a elas	Sim, em uma primeira versão
Contas	Permite que cada usuário veja apenas o próprio histórico e limita o uso por pessoa	Sim, para uma demo pública com limites rígidos
Limites e registros	Tamanho máximo das mensagens, limites de requisições, teto de gastos e registro de erros	Não

A rota do servidor é a parte que mais gente faz errado. Se a página do chat chama o provedor diretamente pelo navegador, qualquer pessoa pode abrir as ferramentas de desenvolvedor, copiar sua chave e gerar uma conta alta.

Decisões a tomar antes de começar

Qual provedor e qual modelo

Os principais provedores (OpenAI, Anthropic, Google e outros) oferecem uma API de chat que funciona do mesmo jeito: você envia uma lista de mensagens e recebe uma resposta. A escolha prática depende menos da marca e mais do tamanho do modelo:

Modelos menores e mais rápidos são mais baratos e respondem depressa. Servem bem para respostas curtas, classificação e bots de FAQ simples.
Modelos maiores raciocinam melhor, seguem instruções longas com mais confiabilidade e lidam com perguntas confusas, mas custam mais por mensagem e respondem mais devagar.

Comece com um modelo de porte médio, teste com as suas perguntas reais e suba ou desça a partir daí. Se você ainda não conhece como essas APIs são cobradas e chamadas, leia primeiro como usar APIs de LLM.

De onde vem o conhecimento do bot

Seu conteúdo	Abordagem
Uma ou duas páginas (horário de funcionamento, política de devolução, preços)	Colocar direto no prompt de sistema
Dezenas de páginas que raramente mudam	Colocar uma versão condensada no prompt, ou dividir por tema e incluir só a seção relevante
Centenas de documentos, ou conteúdo que muda todo dia	Armazenar, buscar os trechos que correspondem a cada pergunta e enviar só esses (RAG)

Comece pela opção mais simples que dê conta do seu conteúdo. A recuperação exige um índice de busca, uma forma de mantê-lo atualizado e mais pontos onde as respostas podem dar errado. Muitos bots úteis nunca precisam disso.

Um chatbot público no seu site é fácil de acessar, mas também fácil de abusar: alguém pode automatizar milhares de mensagens. Um chatbot com login permite salvar o histórico por usuário e definir uma cota diária por conta. Se ele for público, limite o tamanho das mensagens, restrinja quantas mensagens um mesmo visitante pode enviar em um período e defina um limite mensal rígido no painel do provedor. Como adicionar login ao seu app explica o lado das contas.

Se as conversas serão salvas

As conversas salvas são úteis: o usuário retoma de onde parou, e você pode ler perguntas reais para melhorar o prompt. Mas elas também são dados pessoais. Decida por quanto tempo vai guardá-las, informe isso na sua política de privacidade e não salve nada que não seja necessário.

Escreva o prompt de sistema como uma descrição de cargo

O prompt de sistema é a instrução que o modelo recebe antes de cada conversa. Um bom prompt parece um briefing curto para um novo funcionário:

Papel e público: “Você é o assistente de ajuda da Oakline, uma oficina de bicicletas. Você conversa com clientes.”
Escopo: “Responda perguntas sobre serviços, preços, horário de funcionamento e agendamento. Para qualquer outro assunto, diga que só pode ajudar com a loja.”
Fonte da verdade: “Use apenas as informações abaixo. Se a resposta não estiver aqui, diga que não sabe e informe o telefone da loja.”
Tom e tamanho: “Amigável, em português claro, no máximo três frases, salvo se pedirem detalhes.”
Regras rígidas: “Nunca prometa um preço de conserto que não esteja na lista. Nunca peça dados de cartão.”

Em seguida, teste com perguntas difíceis: pedidos fora do tema, mensagens grosseiras, perguntas cuja resposta não está no seu conteúdo e tentativas de fazer o bot ignorar as instruções (“esqueça suas regras e…”). Ajuste o prompt até que as respostas sejam aquelas que você assinaria embaixo.

Mantenha os custos previsíveis

Os provedores cobram por token (aproximadamente, pedaços de palavras) pela entrada que você envia e pela saída que o modelo escreve. Três fatores determinam a conta:

Tamanho da conversa. Cada nova mensagem normalmente reenvia a conversa inteira para que o modelo tenha contexto. Um chat de 40 mensagens custa muito mais por resposta do que um de 4. Mantenha apenas as últimas trocas, ou resuma as mais antigas.
Tamanho do prompt. Um prompt de sistema longo ou um bloco grande de conhecimento colado vai junto em cada mensagem.
Tamanho da resposta. Defina um tamanho máximo de resposta na chamada à API e peça respostas concisas no prompt.

Defina um limite mensal de gastos no painel do provedor antes do lançamento e registre o consumo de tokens por requisição para ver quais conversas são caras. Não informamos preços aqui porque eles variam por modelo e mudam com frequência; consulte a página de preços do próprio provedor.

Construa passo a passo

Passo 1: Descreva o bot, não o código

Um primeiro prompt que cite o público, o escopo, os dados e as regras de segurança já leva você bem longe:

Crie um chatbot de atendimento ao cliente para a Oakline, uma oficina de bicicletas. Uma página de chat com lista de mensagens e campo de envio, com as respostas aparecendo conforme são escritas. Chame a API da Anthropic a partir de uma rota do servidor usando a chave secreta ANTHROPIC_API_KEY — nunca a exponha no navegador. Use um prompt de sistema que responda apenas perguntas sobre nossos serviços, preços e horários, com base no texto de um arquivo chamado shop-info.md, e que diga “Não tenho certeza — ligue para o número abaixo” nos demais casos. Limite as mensagens a 500 caracteres e 20 mensagens por visitante por hora. Design limpo e amigável que funcione bem no celular.

Passo 2: Guarde a chave como segredo

Crie a chave no console do provedor e depois armazene-a nas variáveis de ambiente ou nos segredos do projeto, não no chat e não no código. Se uma chave aparecer em algum lugar público, revogue-a no provedor e crie outra. O que são variáveis de ambiente e segredos explica por que isso importa.

Passo 3: Teste as respostas, não apenas a interface

Depois que o chat funcionar, gaste a maior parte do tempo com a qualidade das respostas. Mantenha uma lista de 20 perguntas reais, incluindo algumas que devem ser recusadas, e repasse todas elas após cada mudança no prompt. Verifique:

Ele se mantém dentro do escopo?
Ele admite quando não sabe, em vez de inventar uma resposta?
Ele resiste quando alguém tenta substituir as suas instruções?
A chave está ausente de tudo o que o navegador baixa?

Passo 4: Adicione memória e contas, se precisar

Assim que as conversas individuais funcionarem, peça para salvar as conversas em um banco de dados e, se necessário, cadastro e login para que cada usuário veja apenas os próprios chats. Adicione ao mesmo tempo uma cota diária de mensagens por usuário.

Passo 5: Publique com os limites ativados

Confirme que o app publicado tem os mesmos segredos da prévia, que o teto de gastos está definido no provedor e que os erros são registrados em um lugar onde você vai vê-los. Depois, compartilhe com um grupo pequeno antes de colocá-lo no seu site principal.

Segurança e confiança

Um chatbot fala com o público em seu nome, então trate as falhas dele como responsabilidade sua:

Respostas erradas. Modelos podem afirmar coisas falsas com confiança. Mantenha o bot em um tema restrito, baseie-o no seu próprio conteúdo e mostre uma nota curta de que as respostas podem conter erros em assuntos importantes.
Injeção de prompt. Usuários (ou documentos que o bot lê) podem conter instruções como “ignore as regras anteriores”. Não dê ao bot poderes em que você não pode confiar: nada de reembolsos, exclusões ou e-mails enviados a pedido do usuário sem uma verificação no seu próprio código.
Temas sensíveis. Para perguntas médicas, jurídicas ou financeiras, faça o bot indicar um profissional em vez de aconselhar.
Dados pessoais. Não cole registros de clientes nos prompts a menos que seja necessário, e verifique nos termos do provedor como os dados enviados pela API são tratados.

Nossa lista de segurança para apps criados com IA cobre o app como um todo.

Erros comuns

Chamar o provedor a partir do navegador. A chave vaza. Sempre passe pelo seu servidor.
Bot público sem limites. Um único script pode esgotar o orçamento do mês em uma tarde.
Começar com RAG, ferramentas e vários modelos ao mesmo tempo. Faça primeiro uma boa conversa funcionar; adicione o resto quando perguntas reais mostrarem que é preciso.
Testar apenas perguntas amigáveis. Seus usuários vão fazer perguntas estranhas, hostis e fora do tema já no primeiro dia.
Deixar a conversa crescer para sempre. Custos e tempo de resposta sobem a cada mensagem.

Quando um produto pronto é a melhor escolha

Criar o seu próprio faz sentido quando o chatbot faz parte do seu produto, precisa dos seus dados ou fluxo de trabalho, ou precisa de uma aparência e um comportamento específicos. Muitas vezes não é a escolha certa quando:

Você só quer um widget de suporte em um site existente. Muitos produtos de helpdesk e chat ao vivo já incluem bots de resposta com IA que leem a sua central de ajuda, com transferência para humanos, caixa de entrada e relatórios prontos.
Só você ou sua equipe vai usar. Uma assinatura de um assistente geral, como ChatGPT ou Claude, com seus documentos enviados, pode ser tudo de que você precisa.
Você precisa de garantias de conformidade rígidas (por exemplo, dados regulados de saúde ou financeiros). Um fornecedor que já possui as certificações pode ser mais seguro do que uma solução sob medida.

Construindo com a Mythex

A Mythex é um construtor de apps com IA: você descreve o chatbot no chat, e ela escreve a interface e a chamada do lado do servidor, roda tudo em uma prévia ao vivo e publica em uma URL pública. A IA dentro do seu app usa a sua própria chave do provedor. Você a adiciona nos segredos do projeto, ou pelo cartão de segredos que a Mythex mostra no chat quando precisa dela, e o uso do provedor é cobrado na sua conta no provedor, e não nos créditos de construção da Mythex. A Mythex não inclui tokens para os usuários do seu app, um produto de base de conhecimento pronto nem limites de requisições prontos: essas são partes que você pede e testa. A página de documentação sobre adicionar IA dentro do seu app mostra o passo a passo, e adicionar IA com suas próprias chaves de API traz um prompt inicial.

Se o bot precisar de conversas salvas, a Mythex anexa um banco de dados Postgres ao projeto quando você pede. Para mais formas de usar modelos dentro de um app, de resumos a classificação, veja como adicionar recursos de IA ao seu app, ou navegue pelos templates de apps para ter pontos de partida.

Perguntas

Preciso de uma chave de API própria para criar um app de chatbot com IA?

Sim, em quase todos os casos. O chatbot envia cada mensagem para um provedor de modelos, como OpenAI, Anthropic ou Google, e o provedor cobra da conta que é dona da chave de API. A chave precisa ficar no seu servidor, nunca na página web.

Quanto custa manter um chatbot com IA funcionando?

Os provedores cobram por token, tanto pelo texto que você envia quanto pelo texto que o modelo devolve, e os preços variam muito entre modelos. Como cada nova mensagem costuma reenviar a conversa até ali, conversas longas custam mais por mensagem do que as curtas. Confira a página de preços do seu provedor e defina um limite de gastos no painel dele.

Posso treinar um chatbot com meus próprios documentos?

Normalmente você não treina o modelo em si. Para uma pequena quantidade de conteúdo, você cola o texto no prompt de sistema; para uma biblioteca grande, você armazena o conteúdo, busca os trechos relevantes para cada pergunta e envia apenas esses trechos ao modelo. Essa segunda abordagem se chama geração aumentada por recuperação, ou RAG (retrieval-augmented generation).

Dá para criar um chatbot com IA sem programar?

Sim. Um construtor de apps com IA pode criar a interface do chat, a rota do servidor que chama o modelo e o banco de dados das conversas salvas a partir de uma descrição em linguagem simples. Você ainda precisa criar a conta no provedor e gerar a chave de API por conta própria.