A IA do BotoZap funciona com a chave do seu provedor de IA. Você cria a chave no site do provedor, cadastra aqui, e o provedor cobra o consumo direto na sua conta com ele. O BotoZap não vende créditos de IA e não usa chave própria como reserva: sem uma chave válida, a IA não roda.
Tudo fica em Configurações › Provedores e chaves, numa tela só, com três partes: Finalidades (qual modelo cada função usa), Credenciais (as suas chaves) e Catálogo de modelos.
Antes de começar
- Cadastrar, trocar e excluir chaves é só para Administrador, que é você se criou a conta. Escolher a chave e o modelo de cada finalidade e sincronizar o catálogo qualquer pessoa da equipe faz.
- Escolha o cliente no seletor do topo do painel. Cada cliente tem as próprias chaves.
- Tenha uma conta no provedor, com saldo ou forma de pagamento ativa. O BotoZap trabalha com OpenAI e Anthropic · Claude. Os termos da API dos dois não usam os dados enviados para treinar modelos.
Dica: se você vai usar a base de conhecimento ou quer que o agente entenda áudios, precisa de uma chave da OpenAI. Essas duas funções só funcionam com modelos da OpenAI. Para conversar, OpenAI e Anthropic servem.
Passo a passo
1. Cadastre a chave
- Em Credenciais, clique em Nova credencial.
- Escolha o Provedor: OpenAI ou Anthropic · Claude.
- Dê um Nome da credencial que você reconheça depois, como "Atendimento principal".
- Cole a Chave da API. Se ainda não tem, o link Obter chave no provedor abre a página certa do provedor escolhido.
- Clique em Cadastrar e validar.
O BotoZap testa a chave no provedor e guarda em cofre. A chave completa não aparece mais: a tabela mostra só o final, em "termina em".
- Se o provedor aceitar, a janela fecha com a mensagem "Credencial cadastrada e validada pelo provedor." e a chave aparece como Validada.
- Se o provedor recusar, a janela continua aberta e mostra o motivo, por exemplo "O provedor recusou a chave. Confira suas permissões ou substitua a credencial." A credencial fica salva como Inválida e não é usada. Cole a chave certa no mesmo campo e clique em Validar e substituir chave: a correção vai para a mesma credencial, sem criar outra. Se preferir corrigir depois, clique em Fechar e use Editar na linha da chave.
2. Confira o estado
- Validada: o provedor aceitou a chave e informou os modelos disponíveis. Pronta para uso.
- Não validada: a validação ainda não terminou.
- Inválida: o provedor recusou. O motivo aparece embaixo, por exemplo "O provedor recusou a chave. Confira suas permissões ou substitua a credencial."
- Inativa: você desligou a chave. Nada que depende dela funciona.
A coluna Em uso por mostra quais agentes e funções usam cada chave.
"Validada" quer dizer que o provedor reconheceu a chave, não que há saldo. Para ter certeza de que o agente consegue responder, faça a prova de geração no diagnóstico do agente. Veja Criar seu primeiro agente.
3. Escolha o modelo padrão
Os agentes escolhem a chave e o modelo na própria configuração. As outras funções da IA usam o que você define em Finalidades.
- Na linha Padrão do Cliente, clique em Configurar.
- Em Principal, escolha a Credencial principal e o Modelo principal.
- Se quiser uma reserva para quando o provedor falhar, escolha também a Credencial alternativa e o Modelo alternativo.
- Clique em Salvar configuração.
Pronto: toda função que não tem configuração própria passa a usar esse padrão.
As finalidades em poucas palavras
Cada linha da tabela é uma função da IA. A coluna Origem diz de onde vem o modelo:
- Em cada agente ou Em cada roteador: Atendimento, Operador e Roteamento são escolhidos dentro de cada agente ou roteador. O botão Abrir agentes ou Abrir roteadores leva até lá.
- Padrão do cliente: a função usa o modelo de Padrão do Cliente.
- Configuração própria: você escolheu um modelo só para ela.
- Não configurada: a função ainda não tem modelo definido aqui. Configurar o Padrão do Cliente resolve quase todas de uma vez.
O que cada função faz, sem termos técnicos:
- Atendimento: a resposta do agente ao contato.
- Operador: o revisor que age depois da resposta do agente, quando ligado.
- Roteamento: a escolha de qual agente atende, quando o número usa roteador.
- Acompanhamento e Propostas: follow-ups e sugestões de melhoria para as instruções e a memória.
- Transcrição de áudio: transforma os áudios recebidos em texto. Exige modelo de transcrição da OpenAI e não usa o padrão do cliente.
- Base de conhecimento: prepara e busca nos seus materiais. Só funciona com a OpenAI e não usa o padrão do cliente.
- Proteção contra manipulação e Avaliação antes do envio: conferem a mensagem recebida e a resposta antes de ela sair.
- Classificação de conversas, Compactação de memória, Consulta interna de casos, Aprendizado: avaliação, Aprendizado: síntese, Descrição de imagens e Propostas comerciais: funções de apoio que você só precisa ajustar se quiser um modelo diferente do padrão.
Para mudar uma função específica, clique em Configurar na linha dela. Para voltar ao padrão, abra de novo e clique em Usar padrão do cliente (ou Remover configuração, nas funções que não herdam o padrão).
Importante: sem alternativa configurada, uma falha do provedor fica registrada e a função não troca de chave sozinha.
Trocar ou desligar uma chave
No menu de cada linha de Credenciais:
- Editar abre o painel da chave. Em Nova chave, cole a chave nova e clique em Validar e substituir chave. Os agentes e funções que usavam a chave continuam ligados a ela, agora com o segredo novo. Se o provedor recusar a chave nova, o motivo aparece no painel e a credencial fica Inválida até você informar uma chave aceita. Em Nome, você renomeia e clica em Salvar nome.
- Revalidar pergunta de novo ao provedor e atualiza a lista de modelos. Use depois de liberar novos modelos na sua conta do provedor. Se o provedor recusar, o aviso mostra o motivo e a chave fica Inválida.
- Inativar desliga a chave sem apagar. Ativar religa.
- Excluir apaga de vez. Só funciona para chaves sem uso: enquanto houver vínculo, aparece Excluir (em uso). Troque a chave nos agentes e nas finalidades antes.
Uso dos dados da Agenda pela IA
Mesmo que a conta use o Google Agenda, as chaves da OpenAI e da Anthropic não pedem nenhuma confirmação de uso de dados: pelos termos da API desses provedores, os dados enviados não são usados para treinar modelos. O que fica com você é não ligar, na sua organização no provedor, opções de compartilhamento de dados para treinamento (na OpenAI, por exemplo, o compartilhamento para melhoria dos modelos é opcional e vem desligado).
Chaves de outros provedores
Em 17/10/2026, as chaves de Google · Gemini, OpenRouter, DeepSeek e xAI · Grok foram desativadas e o segredo delas foi apagado do BotoZap. Elas continuam na lista de Credenciais com o estado Desativada, o aviso Desativada: o BotoZap não usa mais este provedor e a chave foi apagada e só os quatro últimos caracteres, para você ver onde eram usadas. A IA não roda com elas: um agente, roteador ou finalidade que dependia de uma delas para de responder e abre o alerta IA parada: credencial de IA indisponível.
- Em Credenciais, clique em Nova credencial e cadastre uma chave da OpenAI ou da Anthropic · Claude.
- Escolha a chave nova onde a antiga era usada: nas Finalidades, nos agentes (Credencial principal e do operador) e nos roteadores. Depois publique o agente de novo.
Não é preciso excluir a chave antiga. Versões antigas dos agentes continuam citando a chave, e por isso o menu costuma mostrar Excluir (em uso). Ela não executa e não guarda mais o segredo. Essas chaves não podem ser ativadas, revalidadas nem receber chave nova. Quando uma delas era a principal de uma finalidade que tinha uma alternativa OpenAI ou Anthropic, a alternativa passou a ser a principal (menos na Base de conhecimento). Quando era só a alternativa, ela foi retirada e a principal continua funcionando.
Catálogo de modelos
No fim da tela, Catálogo de modelos consulta, com a sua chave, a lista de modelos do provedor: tamanho do contexto, se aceita ferramentas e imagens, e o preço por milhão de tokens. Escolha a Credencial e clique em Sincronizar catálogo.
OpenAI e Anthropic não informam preço na lista de modelos. O preço mostrado é o de lista do próprio provedor, lido no catálogo público da OpenRouter, que repassa o preço sem acréscimo. Nenhum dado seu vai para a OpenRouter nessa consulta. A linha indica Referência OpenRouter. O preço só aparece quando é o mesmo modelo nos dois catálogos. Na Anthropic, a versão com data (claude-opus-4-5-20251101) usa o preço da versão correspondente (claude-opus-4.5). Modelos de transcrição, de embedding e modelos antigos costumam ficar como "Não informado".
Quando há preço, Usar preço copia esse valor para as suas tarifas em Uso e orçamento, depois que você confirma em Salvar tarifa. O BotoZap nunca troca suas tarifas sozinho.
O que acontece depois
- Uma chave Validada aparece para escolha na criação e na configuração dos agentes e em Finalidades.
- Cada chamada feita com a chave entra em Uso e orçamento, com o custo estimado pelas tarifas que você cadastrar.
- Trocar o segredo de uma chave vale para as próximas chamadas. Os agentes não precisam ser publicados de novo, mas refaça a prova de geração no diagnóstico.
Problemas comuns
A chave aparece como Inválida. Confira se copiou a chave inteira, se ela não foi apagada no provedor e se tem permissão para listar modelos. Depois use Editar › Validar e substituir chave com a chave certa.
Aparece "O provedor limitou as consultas. Aguarde e revalide." O provedor recusou por excesso de pedidos. Espere alguns minutos e clique em Revalidar.
O modelo que eu quero não aparece. A lista vem do provedor e só mostra modelos que servem para a função. Libere o modelo na sua conta do provedor e clique em Revalidar.
Uma função aparece como Não configurada. Configure o Padrão do Cliente. Transcrição de áudio e Base de conhecimento precisam de configuração própria, com uma chave da OpenAI.
O agente parou e a chave dele aparece como Desativada. A chave é de um provedor que o BotoZap não usa mais. Siga os passos da seção sobre chaves de outros provedores acima.
O provedor que eu quero não aparece em Nova credencial. O BotoZap aceita só chaves da OpenAI e da Anthropic.
Não consigo excluir a chave. Ela está em uso. O painel Editar mostra os Vínculos; troque a chave em cada um antes. Se a chave está Desativada, não precisa excluir: ela já não tem segredo nem executa, e as versões antigas dos agentes continuam citando a chave.
