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.
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.
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
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