Usando sua própria chave de API para chatbots de IA

Atualizado em 20 de out. de 20266 min de leitura
Português
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

  1. Crie uma chave de API no Anthropic Console (console.anthropic.com).
  2. Faça login na sua conta Deskwoot, vá em Configurações > Bots e clique em Add Bot.
  3. 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.
  4. 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?
Você pode mudar sua chave de API a qualquer momento nas configurações do bot, e seu bot começa a usar a nova chave na hora. A Anthropic é o único provedor disponível.
Vou ser cobrado pelo Deskwoot e pelo meu provedor de IA ao mesmo tempo?
Não. Quando você usa sua própria chave de API, paga apenas as tarifas padrão da Anthropic. O Deskwoot não acrescenta taxas por mensagem em cima disso.
O que acontece se a minha chave de API ficar sem créditos?
Seu bot não consegue mais responder: ele pede ao cliente que tente de novo e passa a conversa para a sua equipe se a próxima tentativa também falhar, até você adicionar créditos à sua conta da Anthropic. É uma boa ideia configurar alertas de faturamento na Anthropic para evitar interrupções.
Quais providers são suportados?
Só a Anthropic. Um bot com a sua chave roda no Claude Sonnet 4.6; chaves da OpenAI não são suportadas. Gera uma API key no Anthropic Console.
Quanto custa?
Você paga o provider direto às taxas padrão. Confere a tabela de preços atual do Claude Sonnet 4.6 na Anthropic. Deskwoot não adiciona margem em tokens BYOK.
Qual tier de plano é necessário?
Startup e acima. Hacker não tem BYOK, porque o Hacker não tem bots. Startup, Business, Enterprise todos têm BYOK.
Onde coloco a chave?
Settings → Bots → Add Bot → tipo 'AI Bot (Your API Key)'. Escolhe Anthropic, cola a chave, escolhe o modelo e cria o bot. Com 'Test Your Bot' você manda uma mensagem de teste antes de atribuir o bot a uma caixa de entrada.
Minha chave é guardada de forma segura?
Sim, encriptada em repouso com AES-256-GCM. A chave é descriptada só on-demand para bot calls e depois de salvar não aparece mais em texto puro no painel.
BYOK vale também para Copilot?
Não. BYOK vale só para o bot que roda na sua chave. Copilot e tradução sempre rodam na AI gerenciada pelo Deskwoot e contam normalmente para a cota de AI conversations.
E se minha chave tem restrições de cota?
A Anthropic devolve 429 ou erro de budget. O bot pede ao cliente que tente de novo e, se a próxima tentativa também falhar, passa a conversa para a sua equipe. O Deskwoot não usa a própria AI no lugar.
Posso alternar entre BYOK e Deskwoot-managed?
Sim. Na Configuração do bot da caixa de entrada, troca o bot pelo Fynn (o Deskwoot AI Bot) → as conversas voltam a contar pra cota. Troca de volta pro bot com a sua chave → BYOK ativo. Alterna a qualquer hora, sem período de bloqueio.
Posso ter uma chave diferente por inbox?
Sim. Você pode criar vários bots com chaves diferentes e atribuir um bot a cada caixa de entrada.
Como vejo o uso de tokens?
No Anthropic Console. Lá aparecem os custos exatos de token; o Deskwoot não conta essas conversas.
BYOK deixa o bot mais rápido ou lento?
Mais ou menos igual. A latência depende sobretudo do modelo e do tamanho da resposta, não de quem é dono da chave.

Este guia foi útil?

Continue lendo

Perguntar ao Fynn sobre este guia

Receba uma resposta curta deste guia e do resto da Central de Ajuda.

Ainda precisa de ajuda?

Fynn responde no chat a partir destes guias, e você também fala com a equipe por lá.

Enviar e-mail