Este guia mostra como criar, configurar e ativar um agente de IA na CloudWhats. Ao final, você terá um agente respondendo conversas automaticamente no canal desejado.
Pré-requisitos
- Chave de API de pelo menos um provedor configurada em Configurações → Agentes de IA, na seção Chaves de Provedores de IA
- Pelo menos uma credencial WhatsApp conectada e verificada
- Plano com acesso a IA habilitado
Criar o agente
Acesse o gerenciador de agentes
Configurações → Agentes de IA
Na própria página você encontra as chaves dos provedores, o agente de transcrição e o botão Novo Agente para abrir o formulário de criação.
Defina o nome e o provedor
Escolha um nome descritivo e selecione o provedor de IA
Escolha o provedor (Google Gemini, OpenAI ou Anthropic) e o modelo específico. Modelos mais recentes como Gemini 2.5 Pro ou GPT-4o costumam entregar melhor qualidade em prompts complexos.
Para operações de atendimento de alto volume, modelos flash/mini (Gemini 2.5 Flash, GPT-4o Mini) oferecem boa relação custo-qualidade.
Escreva o system prompt
Defina a personalidade, tom e regras do agente
O prompt do sistema é o texto que orienta o comportamento do agente. Inclua o contexto do seu negócio, tom de comunicação, o que o agente deve e não deve fazer, e como lidar com situações que ele não sabe resolver.
Exemplo de estrutura: comece com quem é o agente, depois defina regras de atendimento, encerre com instruções de encaminhamento.
Ajuste os parâmetros de geração
Temperatura, max tokens e top P
Temperatura — valores baixos (0–0.3) geram respostas mais previsíveis; valores altos (1–2) geram respostas mais criativas.
Max tokens — limite de tokens por resposta (100–8.000). O padrão de 2.000 funciona bem para a maioria dos cenários.
Top P — controle de amostragem por núcleo (0–1). O padrão funciona bem na maioria dos casos.
Configure os canais e gatilhos
Escolha onde e quando o agente deve atuar
Ative os canais desejados: WhatsApp, Instagram ou Widget. Em seguida, defina os gatilhos:
- Auto reply — responde automaticamente todas as mensagens recebidas
- Palavras-chave — ativa apenas quando a mensagem contém termos específicos
- Tags — ativa quando o contato possui determinadas tags
- Horário comercial — restringe o funcionamento a horários definidos
- Apenas novos contatos — responde somente conversas que ainda não têm histórico
Configure a transferência para humano
Defina o comportamento de escalação
Ative o handoff e configure: atribuição automática para um usuário ou equipe, tempo de inatividade para escalar, e a mensagem de encaminhamento enviada ao contato.
Sempre configure o handoff. Sem ele, o agente tentará responder tudo sozinho, mesmo quando não souber a resposta.
Salve e teste
Ative o agente e envie uma mensagem de teste
Salve as configurações e envie uma mensagem pelo canal escolhido para verificar se o agente responde conforme esperado. Ajuste o prompt e os parâmetros conforme necessário.
Adicionar base de conhecimento
Na aba Base de Conhecimento do agente, adicione fontes que o agente consultará para responder com mais precisão:
- URLs — o agente extrai o conteúdo de páginas web para usar como contexto
- Arquivos — faça upload de documentos (PDF, TXT, etc.) com informações do seu negócio
Quanto mais específica e bem organizada a base de conhecimento, melhores serão as respostas do agente. Evite conteúdo genérico ou duplicado.
Permissões de dados
Na aba de configurações do agente, defina quais dados da plataforma ele pode acessar:
- Pedidos — consultar e atualizar pedidos do contato
- Tarefas — ler, criar e atualizar tarefas
- CRM — acessar e gerenciar deals no funil de vendas
- Lembretes — ler e criar lembretes
- Calendário — consultar e criar eventos no Google Calendar
- Galeria — buscar e enviar itens da galeria
- Mensagens agendadas — ler e criar mensagens para envio futuro
- Campos personalizados — incluir campos customizados do contato no contexto