Criando um Agente de IA
Acesse Menu lateral → Agentes IA (ícone de lâmpada). A tela é chamada internamente de IA Studio.
Duas formas de criar
1. Studio Wizard (recomendado para iniciantes)
Quando você ainda não tem agentes, a tela exibe uma galeria de templates por nicho. Clique no template mais próximo do seu negócio e o Wizard vai guiar você passo a passo.
Se já tiver agentes cadastrados, clique no botão "Novo agente" (com ícone de raio) no canto superior direito para abrir o Wizard.
O Wizard tem etapas numeradas (Stepper). Avance com "Próximo" e volte com "Anterior". Na última etapa, clique em "Criar agente" para salvar.
2. Criação do zero
Clique em "Do zero" (ícone de +) para abrir diretamente o formulário completo sem sugestões de template.
Formulário de edição — abas
Ao criar ou editar um agente (clique no lápis de qualquer card), um painel com 8 abas é exibido.
Aba 1 — Identidade
Campos desta aba:
| Campo | O que preencher |
|---|---|
| Nome do agente | Nome interno para identificação (ex: "Dani Vendas", "Suporte Técnico") |
| Função | Finalidade principal do agente (veja tabela abaixo) |
| Tom de voz | Como o agente se comunica (veja tabela abaixo) |
| Modelo de IA | Qual modelo processa as mensagens (veja Limites por plano) |
| Idiomas de resposta | Clique nos chips de idioma para ativar/desativar. O agente responde nos idiomas marcados. "Auto" detecta o idioma do cliente automaticamente |
| Personalidade / Instrução | O prompt principal — a "alma" do agente. Veja Boas práticas de prompt |
| Agente ativo | Toggle liga/desliga. Desativado, o agente não responde mesmo que esteja vinculado a uma fila |
Opções de Função:
| Valor | Quando usar |
|---|---|
| Geral | Atendimento genérico, sem foco específico |
| Vendas | Prospecção, apresentação de produtos, qualificação de leads |
| Suporte | Dúvidas técnicas, resolução de problemas |
| Agendamento | Marcar consultas, reuniões, serviços |
| Financeiro | 2ª via de boleto, cobranças, faturas |
Opções de Tom de voz:
| Valor | Perfil |
|---|---|
| Amigável | Descontraído, próximo |
| Profissional | Sério mas acessível |
| Formal | Corporativo, protocolar |
| Casual | Informal, jovem |
| Empático | Acolhedor, focado em escuta |
| Técnico | Direto, preciso, termos técnicos |
Dica
O campo Personalidade é o mais importante de todo o agente. Dedique tempo nele. Quanto mais contexto você der (quem é a empresa, o que não deve falar, como agir em situações difíceis), melhor será a Dani. Veja exemplos em Boas práticas de prompt.
Aba 2 — Comportamento
| Campo | Descrição |
|---|---|
| Mensagem de saudação | Texto enviado automaticamente quando a Dani inicia o atendimento. Se vazio, a Dani começa respondendo a primeira mensagem do cliente |
| Regras de resposta | Restrições adicionais em formato livre (ex: "Nunca mencione concorrentes", "Sempre pergunte o nome antes de continuar") |
| Permitir transferência | Toggle. Quando ativado, a Dani pode passar o cliente para um humano |
| Palavras-chave de transferência | Lista de palavras que, quando o cliente digitar, acionam a transferência (ex: "humano,atendente,pessoa,falar com alguém"). Separe por vírgula |
| Mensagem de transferência | Texto enviado ao cliente ao transferir ("Vou te conectar com um de nossos atendentes...") |
| Fila de destino | Qual fila receberá o ticket após a transferência |
Atenção
Se "Permitir transferência" estiver ativo, o campo Fila é obrigatório. Sem uma fila configurada, o sistema bloqueia o salvamento.
Aba 3 — Avançado (Modelo e limites)
| Campo | Valores | O que controla |
|---|---|---|
| Delay de resposta | 0 a 10 segundos (passo 0,5s) | Quanto tempo a Dani "aguarda" antes de responder. Simula digitação humana |
| Limite de caracteres | 100 a 5.000 | Tamanho máximo de cada resposta |
| Humanizar conversa | Toggle | Quebra respostas longas em partes menores, como uma pessoa digitaria |
| Temperatura | 0 a 2 | Criatividade da resposta. 0 = muito previsível, 1 = balanceado, 2 = muito criativo. Padrão: 1 |
| Max tokens | Número | Limite de tokens por resposta. Padrão: 2.000 |
| Max mensagens | Número | Quantas mensagens do histórico o agente considera para responder. Padrão: 10 |
Recursos de áudio (aparecem ao ativar o toggle):
| Campo | O que faz |
|---|---|
| Transcrever áudio | A Dani converte áudios enviados pelo cliente em texto antes de processar |
| Modo de resposta | Texto (só texto), Áudio (só voz), Ambos (texto + áudio) |
| Voz do agente (OpenAI) | Voz usada para gerar áudios: Alloy, Ash, Ballad, Coral, Echo, Fable, Nova, Onyx, Sage, Shimmer. Use o botão play para ouvir prévia |
| Voz ElevenLabs | Voz alternativa de alta qualidade via ElevenLabs (requer chave configurada no painel de integrações). Selecione uma voz da lista ou insira um ID customizado |
| Enviar como PTT | Toggle. Quando ativo, o áudio é enviado como mensagem de voz (microfone) ao invés de arquivo de áudio |
Aba 4 — Qualificação SDR
Esta aba transforma o agente em um qualificador automático de leads. Use para campanhas de prospecção onde a Dani conversa, classifica o lead (HOT/WARM/COLD) e age conforme o resultado.
| Campo | Descrição |
|---|---|
| Buffer de mensagens | 0 a 30 segundos. A Dani aguarda esse tempo para acumular várias mensagens rápidas do cliente antes de responder. Útil para quem envia mensagens em partes |
| Max. turnos de conversa | 1 a 20. Após esse número de trocas, a Dani força a qualificação do lead |
| Tag de qualificação | Prefixo das tags criadas no contato (ex: "SDR" gera tags "Lead HOT", "Lead WARM") |
| Notificar grupo WhatsApp | Toggle. Ao qualificar um lead HOT, envia uma mensagem para um grupo de WhatsApp da equipe |
| JID do grupo | ID do grupo de WhatsApp para notificação (formato: 120363425614826211) |
| Template da notificação | Texto enviado ao grupo. Variáveis disponíveis: {contactName}, {contactNumber}, {score}, {classification}, {product} |
| Fila para leads HOT | Lead qualificado como HOT é transferido automaticamente para esta fila |
| Fechar ticket se COLD | Toggle. Encerra o ticket automaticamente quando o lead é classificado como frio |
| Mensagem de fechamento | Texto enviado antes de fechar o ticket de um lead COLD |
| Gerar documentação automática | Toggle. Após tickets resolvidos, o sistema gera automaticamente um item na base de conhecimento |
| Requerer aprovação | Toggle. A documentação gerada aguarda aprovação antes de ser publicada na base |
Aba 5 — Agendamento
Permite que a Dani consulte horários disponíveis e faça agendamentos reais na Agenda nativa do ChatDigi.
| Campo | Descrição |
|---|---|
| Ativar agendamento | Toggle principal. Sem isso ativo, o agente não marca compromissos |
| Serviço padrão | Tipo de serviço usado quando o cliente não especifica outro |
| Serviços que este agente pode marcar | Seleção múltipla dos tipos de serviço autorizados para este agente |
| Atendentes elegíveis | Seleção múltipla. Só horários destes atendentes são considerados. Vazio = todos |
| Mensagem de fallback | Texto enviado quando não há horários disponíveis para marcar automaticamente |
TIP
Os tipos de serviço são cadastrados no módulo Agenda → Serviços. Cadastre-os antes de configurar o agendamento aqui.
Aba 6 — Base de conhecimento
Adicione documentos, textos e URLs que a Dani consultará para responder. Veja a página completa em Base de conhecimento.
Aba 7 — Ferramentas
Integre o agente com APIs externas. Veja a página completa em Ferramentas.
Aba 8 — Testar
Teste o agente diretamente no painel, sem precisar enviar mensagem pelo WhatsApp.
- Selecione o modelo de IA no seletor no topo do chat
- Digite uma mensagem no campo de texto e pressione Enter ou clique no ícone de envio
- O agente responde usando o prompt configurado nas abas anteriores
- Clique em "Limpar" para resetar o histórico do chat de teste
WARNING
O chat de teste usa o prompt salvo. Se você fez alterações nas outras abas mas ainda não salvou, o teste vai usar a versão anterior. Salve antes de testar.
Ações nos cards de agente
Na tela principal do IA Studio, cada agente aparece como um card com:
- Badge colorido: verde "Ativo" ou cinza "Inativo"
- Chip de fila: nome da fila vinculada (ou "Sem fila")
- Chip de tokens: total de tokens consumidos por esse agente
- Botão play (triângulo): abre o Sandbox de teste
- Botão lápis: abre o formulário de edição
- Botão lixeira: exclui o agente (pede confirmação)
Problemas comuns nesta tela
Botão salvar bloqueado com mensagem de "setor obrigatório" A aba Comportamento tem "Permitir transferência" ativado mas nenhuma fila foi selecionada. Vá na aba 2 e escolha uma fila ou desative a transferência.
Não vejo o menu "Agentes IA" na barra lateral Seu plano não tem IA habilitada ou seu usuário não é admin. Verifique com o administrador da conta.
Video — Criando seu primeiro agente de IA
Vídeo de demonstração em produção. Em breve disponível nesta página.