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, sincronizar o catálogo e confirmar o uso dos dados 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. Os provedores aceitos são Anthropic · Claude, OpenAI, Google · Gemini, OpenRouter, DeepSeek e xAI · Grok.
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, qualquer um dos provedores serve.
Passo a passo
1. Cadastre a chave
- Em Credenciais, clique em Nova credencial.
- Escolha o Provedor.
- 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.
Condições de uso dos dados (quem usa Google Agenda)
Se esta conta já conectou o Google Agenda, cada chave de IA precisa de uma confirmação sua sobre como o provedor trata os dados. Isso vale mesmo depois de desconectar a agenda, porque podem existir históricos e memórias que vieram dela. As chaves pendentes aparecem com Confirmar uso dos dados, e a IA não roda com elas até a confirmação.
- Na chave sinalizada, clique em Editar. (Quem é Operador encontra a mesma confirmação no menu da chave, em Confirmar uso dos dados.)
- Em Privacidade dos dados da Agenda, leia o texto sobre o seu provedor e abra o link das condições dele.
- Em Como você verificou as condições desta conta no provedor?, descreva o que conferiu (sem colar senhas nem chaves).
- Marque a confirmação de que os dados não serão usados para treinar modelos e clique em Registrar confirmação.
O selo passa para Condições confirmadas. Trocar a chave exige nova confirmação. Se as condições mudarem, use Revogar confirmação: as próximas execuções de IA com essa chave param, mas a chave e o histórico ficam guardados.
Atenção: cada provedor tem regras diferentes. No Google, só projetos com faturamento ativo estão cobertos. Na DeepSeek, a política pública prevê uso para treinamento, então só confirme depois de obter a exclusão desse uso com o provedor.
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 informado pelo provedor. Escolha a Credencial e clique em Sincronizar catálogo.
Se o provedor informar o 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 aparece "Confirme as condições de uso dos dados desta credencial". A chave precisa da confirmação de uso dos dados. Siga os passos da seção sobre o Google Agenda acima.
Não consigo excluir a chave. Ela está em uso. O painel Editar mostra os Vínculos; troque a chave em cada um antes.