---
title: "Use sua chave de IA (BYOK) nos agentes da Waply no Kommo"
description: "Conecte sua chave da OpenAI, Grok ou outro provedor de IA aos agentes da Waply no Kommo: planos, passos, provedores para mensagens e chamadas."
lang: pt
canonical: https://waply.online/pt/guides/byok-ai-agent-kommo/
sitemap: https://waply.online/sitemap.md
---


# Use sua própria chave de IA (BYOK) nos agentes de IA da Waply no Kommo

Por [Fernando Castillo](https://waply.online/pt/about/#fernando-castillo), fundador do Waply

Atualizado: 2026-10-23

**O BYOK permite que seus agentes de IA da Waply funcionem com a chave do seu próprio provedor de IA: seis provedores para mensagens e apenas OpenAI e Grok para chamadas e voz.** Está disponível no AI 24/7 (agentes de texto) e no Voice AI (agentes de texto e de voz); o Basic não inclui. Você conecta a chave em Configurações avançadas, na aba Provedores de IA, onde a Waply a valida antes de salvar e a armazena criptografada. Depois, cada agente escolhe Gerenciado pela Waply ou um dos seus provedores e modelos.

Este guia é para equipes que usam o Kommo e querem usar a própria chave de IA com os agentes da Waply. Ele vai além dos passos rápidos da documentação: o que cada plano inclui, quais provedores funcionam para mensagens e quais para chamadas, como conectar uma chave e escolhê-la em cada agente, e o que roda nela.

[Instalar no Kommo](https://api.waply.online/oauth/kommo/website/start?locale=pt) — Teste grátis de 3 dias com todo o Voice AI.

## BYOK na Waply: o que é e para quem serve

BYOK (bring your own key, «traga sua própria chave») significa que seus agentes de IA da Waply funcionam com uma chave de API da sua própria conta de provedor de IA, em vez da IA fornecida pela Waply. Você conecta a chave uma vez na Waply e, depois, cada agente decide se a usa.

- Planos: o BYOK está no AI 24/7 (agentes de texto) e no Voice AI (agentes de texto e de voz). O Basic não tem agentes de IA nem BYOK.
- Mensagens: OpenAI, Grok, Anthropic, Google Gemini, Mistral AI e DeepSeek.
- Chamadas e voz: apenas OpenAI e Grok.
- Cobrança: seu provedor cobra o uso da sua chave, e a Waply não desconta créditos de IA nos agentes configurados com o seu provedor.

É para equipes que já têm conta em um provedor, querem escolher o provedor e o modelo de cada agente ou preferem que esse consumo corra na própria conta. Se preferir não gerenciar uma conta de provedor, os agentes configurados como Gerenciado pela Waply funcionam sem nenhuma chave.

## Qual plano você precisa para o BYOK

O BYOK vem incluído nos dois planos com IA; não é vendido separadamente. O BYOK de voz está apenas no Voice AI.

**BYOK por plano da Waply**

| Plano | Sua própria chave (BYOK) |
| --- | --- |
| Basic (USD 18 por mês) | Não incluído: o Basic não tem agentes de IA |
| AI 24/7 (USD 39 por mês) | Agentes de texto (mensagens) |
| Voice AI (USD 89 por mês) | Agentes de texto e agentes de voz nas chamadas |

## Provedores: quais funcionam para mensagens e quais para chamadas

Para chamadas e agentes de voz, só funcionam OpenAI e Grok. Anthropic, Google Gemini, Mistral AI e DeepSeek estão disponíveis apenas para mensagens.

**Provedores que você pode conectar com sua própria chave**

| Provedor | Mensagens | Chamadas e voz |
| --- | --- | --- |
| OpenAI | Sim | Sim |
| Grok | Sim | Sim |
| Anthropic | Sim | Não |
| Google Gemini | Sim | Não |
| Mistral AI | Sim | Não |
| DeepSeek | Sim | Não |

A aba Provedores de IA mostra uma etiqueta Mensagens e, na OpenAI e na Grok, uma etiqueta Chamadas em cada linha de provedor. No agente, mensagens e voz são escolhidas separadamente, então você pode usar um provedor para os chats e outro para as chamadas. Os modelos disponíveis mudam com o tempo, por isso este guia não os lista: você vê os atuais ao escolher o modelo no agente.

## Passo a passo: conecte sua chave

Estes são os passos completos; a página da documentação tem a versão curta.

1. No Kommo, acesse Configurações > Waply, abra Configurações avançadas e selecione a aba Provedores de IA. Você verá uma linha por provedor com as etiquetas Mensagens e Chamadas e o status, por exemplo Sem conexão.
2. Na linha do seu provedor, selecione Conectar.
3. Cole sua chave no campo Chave de API. É o único campo: não há endpoint, organização nem modelo a preencher.
4. Selecione Testar e salvar. A Waply valida a chave com o provedor antes de salvá-la; se o provedor não a aceitar ou não responder, a Waply avisa e a chave não é salva.
5. Confira se a linha mostra Conectado e os quatro últimos caracteres da sua chave. A chave é armazenada criptografada na sua conta e a Waply nunca a mostra por completo.

A conexão pertence à sua conta, não a um único agente, então todos os agentes podem usá-la. Para trocar uma chave, selecione Trocar chave: a chave atual continua ativa até que a nova seja validada.

> Guarde uma cópia da sua chave no seu próprio gerenciador de senhas: depois de salvar, a Waply só mostra os quatro últimos caracteres.

- [Docs: provedores e chaves próprias](/pt/docs/providers-own-keys/)

## Escolha seu provedor em cada agente

Conectar uma chave não altera seus agentes por si só. No editor do agente, cada canal (mensagens e voz) tem seu próprio seletor de Provedor.

- Provedor: escolha Gerenciado pela Waply ou um dos seus provedores conectados. Na lista só aparecem provedores conectados, com chave válida e compatíveis com aquele canal.
- Modelo: ao escolher um provedor, você também escolhe o modelo. Os agentes configurados como Gerenciado pela Waply escolhem um nível Simples ou Avançado em vez de um modelo.
- Publicação: a Waply bloqueia a publicação de um agente cujo provedor escolhido não tem uma chave válida e pede que você conecte uma antes.
- Agentes de chamadas: com seu próprio provedor (OpenAI ou Grok), o agente de chamadas também precisa de uma voz e de uma voz alternativa da Waply escolhidas antes de poder ser publicado.

Como a escolha é por agente e por canal, um agente que fica em Gerenciado pela Waply continua usando a IA da Waply mesmo que sua conta tenha uma chave conectada.

> Se você excluir uma chave, os agentes que usam esse provedor perdem a conexão e não podem ser publicados até que uma chave válida seja conectada novamente.

## O que roda na sua chave e o que não roda

**Partes de um agente de IA da Waply e a sua chave**

| Parte | Usa sua chave? | Observações |
| --- | --- | --- |
| Respostas de texto do agente | Sim | Com qualquer um dos seis provedores, nos agentes configurados com esse provedor. |
| Voz do agente nas chamadas (Voice AI) | Sim | Apenas com OpenAI ou Grok. |
| Respostas que usam uma base de conhecimento | Sim | A Waply busca na sua base de conhecimento e seu provedor gera a resposta, então ela continua rodando na sua chave. |
| Transcrição de mensagens de áudio | Só com OpenAI | Escolha a OpenAI como provedor de transcrição no agente, com uma chave da OpenAI conectada. Caso contrário, a Waply transcreve. |
| Transcrições e resumos de chamadas (inteligência de chamadas) | Não | É um recurso do plano com franquia própria e não tem configuração de provedor. |

Nas respostas geradas com a sua chave, seu provedor cobra o uso e a Waply não desconta créditos de IA. Os agentes configurados como Gerenciado pela Waply e a inteligência de chamadas continuam seguindo as franquias do seu plano.

- [Guia: base de conhecimento de IA](/pt/guides/kommo-ai-agent-knowledge-base/)

## Quando usar sua própria chave e quando ficar no gerenciado

### Escolha o BYOK se

- Você já tem uma conta na OpenAI, Grok, Anthropic, Google Gemini, Mistral AI ou DeepSeek e quer usá-la.
- Você quer escolher o provedor e o modelo de cada agente.
- Você quer que o uso de IA apareça na sua própria conta de provedor.
- Você usa o Voice AI e quer que suas chamadas rodem na OpenAI ou na Grok com a sua chave.

### Fique em Gerenciado pela Waply se

- Você prefere não criar nem manter contas e chaves de provedores.
- Você se contenta em escolher um nível Simples ou Avançado em vez de um modelo.

- [Guia: escolha um plano Waply](/pt/guides/waply-pricing-plans/)
- [Guia: Voice AI para Kommo](/pt/guides/voice-ai-agent-kommo/)
- [Guia: Waply vs IA do Kommo](/pt/guides/waply-vs-kommo-ai/)
- [Detalhes do produto IA para WhatsApp](/pt/product/ai/)

[Instalar no Kommo](https://api.waply.online/oauth/kommo/website/start?locale=pt) — Teste grátis de 3 dias com todo o Voice AI.

## Perguntas frequentes

### A Waply verifica minha chave antes de salvá-la?

Sim. Quando você seleciona Testar e salvar, a Waply primeiro valida a chave com o provedor. Se o provedor não a aceitar ou não responder, a chave não é salva.

[Docs: provedores e chaves próprias](/pt/docs/providers-own-keys/)

### Posso ver minha chave de API depois de salvá-la?

Não. A chave é armazenada criptografada na sua conta e a Waply só mostra os quatro últimos caracteres.

### Uma mesma chave serve para mensagens, chamadas e transcrição de áudio?

A conexão é por provedor e por conta. Uma chave da OpenAI pode alimentar as respostas de texto, a voz nas chamadas e a transcrição de áudio, desde que você escolha a OpenAI em cada agente e canal. A Grok serve para texto e chamadas; Anthropic, Google Gemini, Mistral AI e DeepSeek servem só para texto.

### Por que não consigo publicar meu agente?

Se o agente usa um dos seus provedores, a Waply bloqueia a publicação até que esse provedor tenha uma chave válida conectada. Um agente de chamadas com o seu próprio provedor também precisa de uma voz e de uma voz alternativa da Waply escolhidas.

### Minha base de conhecimento funciona com minha própria chave?

Sim. A Waply busca na sua base de conhecimento e seu provedor gera a resposta que a usa, então ela roda na sua chave.

### Preciso da minha própria chave para usar os agentes de IA da Waply?

Não. O Gerenciado pela Waply funciona sem nenhuma chave. Sua própria chave é opcional no AI 24/7 e no Voice AI.

## Conecte sua própria chave de IA na Waply

Instale a Waply no Kommo e use o teste grátis de 3 dias com todo o Voice AI: conecte sua chave, escolha o provedor em cada agente e teste na prévia antes de publicar.

[Instalar no Kommo](https://api.waply.online/oauth/kommo/website/start?locale=pt) — Teste grátis de 3 dias com todo o Voice AI.

[Ver planos da Waply](/pt/pricing/)

## Fontes

- [Waply: provedores e chaves próprias](https://waply.online/pt/docs/providers-own-keys/)
- [Waply: preços](https://waply.online/pt/pricing/)