Usando sua própria chave de API para chatbots de IA
Nesta página
Bring-your-own-key (BYOK) significa: o bot roda na sua chave da Anthropic em vez da AI gerenciada pelo Deskwoot. Disponível no Startup e acima. Conversas do bot na sua chave NÃO contam para sua cota de AI conversations e você paga seu provider direto às taxas padrão. Útil se você já tem descontos de volume do provider ou quer controlar o gasto.
O Deskwoot permite que você traga sua própria chave de API da Anthropic, dando controle direto sobre os custos do seu chatbot de IA. Em vez de pagar taxas por mensagem a um terceiro, você paga as tarifas padrão da Anthropic, o que muitas vezes gera uma economia significativa. Essa abordagem é ideal para empresas que querem transparência e preços previsíveis conforme o volume de atendimento aumenta.
Provedores compatíveis
O Deskwoot é compatível com chaves de API de um provedor de IA:
- Anthropic: Claude Sonnet 4.6
Chaves da OpenAI não são suportadas. Você insere sua chave de API diretamente nas configurações do bot, dentro do seu painel do Deskwoot. Depois de configurado, seu bot vai usar a sua conta da Anthropic para todas as respostas, em todos os canais das caixas de entrada a que você o atribuir.
Como configurar sua chave de API
- Crie uma chave de API no Anthropic Console (console.anthropic.com).
- Faça login na sua conta Deskwoot, vá em Configurações > Bots e clique em Add Bot.
- Escolha o tipo de bot AI Bot (Your API Key), selecione a Anthropic como provedor, cole sua chave de API e escolha o modelo Claude Sonnet 4.6. Clique em Create Bot.
- Vá em Configurações > Caixas de entrada, abra a caixa de entrada que o bot deve atender e selecione o bot em Configuração do bot. Seu bot vai passar a usar sua própria chave de API em todas as conversas dessa caixa de entrada.
Comparação de custos
Quando você usa sua própria chave de API, a Anthropic cobra por tokens às tarifas publicadas do Claude Sonnet 4.6, então o custo depende do tamanho da conversa e de quanto do seu conhecimento entra em cada resposta. Isso costuma ser bem mais barato do que concorrentes que cobram de US$ 0,99 a US$ 2,00 por resolução de IA. Para equipes de atendimento de alto volume, isso pode se traduzir em milhares de dólares de economia por mês.
Boas práticas
- Use Test Your Bot nas configurações do bot para conferir algumas respostas antes de atribuir o bot a uma caixa de entrada.
- Monitore o uso da sua API pelo painel do seu provedor para acompanhar os gastos e definir alertas de orçamento.
- Revise os registros de conversa do seu chatbot com frequência para garantir que a IA esteja dando respostas precisas e úteis.
Solução de problemas comuns
Se uma requisição à Anthropic falhar, o seu bot pede ao cliente que tente de novo e passa a conversa para a sua equipe se a próxima tentativa também falhar. Se isso se repetir, verifique se a sua chave de API ainda é válida e se a sua conta da Anthropic tem créditos suficientes. As chaves de API podem expirar ou ser revogadas se as informações de faturamento estiverem desatualizadas. Confira também se você selecionou um modelo compatível nas configurações do bot.
BYOK e a contagem de conversas de IA
Quando um bot roda na sua própria chave da Anthropic, as conversas que ele atende não contam para as conversas de IA mensais incluídas no seu plano. Você paga a Anthropic diretamente e o Deskwoot não mede essas chamadas.
As ferramentas do Copilot que um agente usa na mesma conversa (sugerir resposta, resumir, traduzir, detectar idioma) sempre rodam na IA gerenciada pelo Deskwoot e contam normalmente. Se o bot BYOK e o Copilot atuarem na mesma conversa no mesmo mês, essa conversa conta uma vez (por causa da ação do Copilot pelo lado do agente), e não duas.
Perguntas frequentes
Posso trocar de provedor depois de configurar minha chave de API?
Vou ser cobrado pelo Deskwoot e pelo meu provedor de IA ao mesmo tempo?
O que acontece se a minha chave de API ficar sem créditos?
Quais providers são suportados?
Quanto custa?
Qual tier de plano é necessário?
Onde coloco a chave?
Minha chave é guardada de forma segura?
BYOK vale também para Copilot?
E se minha chave tem restrições de cota?
Posso alternar entre BYOK e Deskwoot-managed?
Posso ter uma chave diferente por inbox?
Como vejo o uso de tokens?
BYOK deixa o bot mais rápido ou lento?
Este guia foi útil?
Continue lendo
- Como o Fynn é cobrado: conversas de IA incluídas e extrasO Fynn usa as conversas com IA incluídas no seu plano todo mês. As extras são pagas do saldo pré-pago, de US$ 0,03 a US$ 0,07 cada.Ler guia
- Copilot nas conversasO Copilot trabalha na conversa aberta. Faça perguntas, peça que ele sugira ou melhore uma resposta, traduza o seu rascunho ou resuma a conversa, com respostas do seu Training Hub e da sua central de ajuda. Na web e no app para iPhone e Android.Ler guia
- Criar regras de automaçãoAs regras de automação fazem os mesmos passos por você, todas as vezes: quando um evento acontece e as condições são atendidas, o Deskwoot executa as ações. Veja como criar, editar e pausar regras.Ler guia
Perguntar ao Fynn sobre este guia
Receba uma resposta curta deste guia e do resto da Central de Ajuda.