Agentes IA
Configure agentes de inteligência artificial para automatizar atendimentos na Interflow.
Visão Geral
Os Agentes IA da Interflow são assistentes virtuais inteligentes que podem atender clientes de forma autônoma, responder perguntas, agendar compromissos, transferir para equipes e muito mais.
🔄 Fluxo Automático
Ao criar um Agente IA, o sistema gera automaticamente um fluxo vinculado a ele. No atendimento automático, o agente opera nesse fluxo. Também dá para executar o mesmo agente em uma mensagem, sem iniciar fluxo.
Modelos Disponíveis
No Agente de IA você escolhe a integração e o modelo:
| Integração | Quem paga | Modelos |
|---|---|---|
| Interflow | Créditos do plano | OpenAI (lista abaixo) |
| OpenAI (chave própria) | Sua conta OpenAI | Mesma família OpenAI |
| DeepSeek (chave própria) | Sua conta DeepSeek | DeepSeek V4 Flash e V4 Pro |
OpenAI — Com Raciocínio
Modelos com raciocínio avançado (nível de esforço e verbosidade configuráveis).
| Modelo | Descrição | Custo |
|---|---|---|
| GPT-5.5 | Raciocínio premium | 💲💲💲💲 |
| GPT-5.4 | Raciocínio mais recente | 💲💲💲 |
| GPT-5.4 Mini | Raciocínio econômico | 💲 |
| GPT-5.4 Nano | Raciocínio super econômico | 💲 |
| GPT-5.2 | Raciocínio avançado | 💲💲💲 |
| GPT-5.1 | Raciocínio avançado | 💲💲💲 |
| GPT-5 | Raciocínio | 💲💲💲 |
| GPT-5 Mini | Raciocínio econômico | 💲 |
| GPT-5 Nano | Raciocínio super econômico | 💲 |
OpenAI — Conversação (Chat)
Especializados em conversação; os modelos gpt-5.X-chat-latest também suportam raciocínio (exceto o legado GPT-5 Chat Latest).
| Modelo | Descrição | Custo |
|---|---|---|
| GPT-5.3 Chat Latest | Conversação | 💲💲💲 |
| GPT-5.2 Chat Latest | Conversação | 💲💲💲 |
| GPT-5.1 Chat Latest | Conversação | 💲💲💲 |
| GPT-5 Chat Latest | Conversação (legado) | 💲💲💲 |
OpenAI — Sem Raciocínio
Modelos mais simples e rápidos, com temperatura e máximo de tokens.
| Modelo | Descrição | Custo |
|---|---|---|
| GPT-4.1 | Inteligente e versátil | 💲💲💲 |
| GPT-4.1 Mini | Baixo custo com bom desempenho | 💲 |
| GPT-4.1 Nano | Mais econômico, tarefas leves | 💲 |
DeepSeek (chave própria)
Disponíveis ao cadastrar a integração DeepSeek. Não consomem créditos Interflow.
| Modelo | Descrição | Custo (referência) |
|---|---|---|
| DeepSeek V4 Flash | Rápido e econômico | 💲 |
| DeepSeek V4 Pro | Mais capaz, tarefas complexas | 💲💲 |
Ambos suportam Thinking Mode (raciocínio em cadeia) com esforço Alto ou Máximo. Com Thinking Mode ativo, a temperatura é ignorada pela API da DeepSeek.
💡 Dica
Para a maioria dos atendimentos com créditos Interflow, GPT-5 Nano ou GPT-5 Mini (ou GPT-5.4 Nano / Mini) oferecem bom custo-benefício. Com chave própria, veja também OpenAI e DeepSeek.
🚀 Em Breve
Outros provedores poderão ser adicionados no futuro (ex.: Claude, Gemini).
Acessando Agentes IA
- No menu principal, clique em Agentes IA (🤖)
- Você verá a lista de todos os agentes configurados
- Use a busca para encontrar agentes por nome
- Clique no botão A → Z para ordenar alfabeticamente
Criando um Agente IA
Ao criar um novo agente, você terá duas opções:
Opção 1: Gerar com IA
Use nossa ferramenta de geração assistida por IA para criar o contexto do agente automaticamente. Basta descrever o que você deseja e a IA criará o prompt completo.
Opção 2: Criar Manualmente
Crie o agente do zero, configurando cada detalhe manualmente.
Abas do Editor
O editor de Agentes IA possui 6 abas principais:
1. Contexto
Esta é a aba principal onde você define o prompt/instruções do agente.
Recursos disponíveis:
- Editor de Texto: Escreva as instruções, personalidade e regras do agente
- Condições no texto: botão de ramificação para blocos se / senão por canal, funil e tags — Canal e condições
- Gerar com IA: Cria o contexto automaticamente baseado em uma descrição
- Melhorar: Melhora o texto existente usando IA
- Fora de contexto: perguntas de clientes que não estavam no contexto do agente (apenas em edição)
- Mensagens e dados do cliente: limite de histórico e quais dados do cadastro entram no modelo, com máscara opcional
- Skills: contextos adicionais concatenados ao prompt (listas, FAQs, regras), com filtro Exibir quando
- Uso de Tokens: Acompanhe o consumo de tokens em tempo real (para Interflow)
Exemplo de Prompt:
Você é a Interflow, assistente virtual de atendimento da Empresa XYZ.
**Personalidade:**
- Amigável e prestativa
- Profissional mas não robótica
- Usa emojis com moderação
**Regras:**
- Sempre cumprimente o cliente pelo nome
- Não invente informações sobre produtos
- Se não souber algo, transfira para um humano
**Informações da empresa:**
- Horário: Segunda a sexta, 9h às 18h
- Produtos: [lista de produtos]
- Políticas: [políticas de troca, garantia, etc.]2. Testar
A aba de testes permite conversar diretamente com o Agente IA antes de colocá-lo em produção.
Como Usar:
- Após adicionar o contexto, clique na aba "Testar"
- Digite mensagens como se fosse um cliente
- Observe as respostas do agente
- Verifique se o comportamento está adequado
O que Testar:
- ✅ Tom de voz e personalidade
- ✅ Respostas a perguntas frequentes
- ✅ Limites do que a IA pode/não pode fazer
- ✅ Cenários de transferência para humano
- ✅ Regras por canal, estágio e tags — use Simular contexto
Canal e condições
O mesmo agente pode atender em vários canais. Na aba Teste, abra Simular contexto para escolher canal, estágio e tags e validar o recorte. Detalhes: Canal e condições.
3. Arquivos
Adicione mídia que o agente pode enviar durante a conversa. Organize os arquivos em pastas (categorias) para facilitar a localização e o contexto da IA.
Tipos de arquivo suportados:
- 🖼️ Imagens: JPG, PNG, GIF, WebP
- 🎵 Áudios: MP3, WAV, OGG
- 🎬 Vídeos: MP4, WebM
- 📄 Documentos: PDF, DOCX, XLSX
Pastas:
- Crie pastas para agrupar documentos (ex.: Produtos, Políticas, Fotos)
- Renomeie uma pasta pelo ícone de lápis no cabeçalho — a alteração vale na hora para toda a organização
- Os arquivos da pasta permanecem acessíveis após o rename
Uso: O agente pode referenciar e enviar esses arquivos durante a conversa quando apropriado.
4. Ferramentas
Configure as ações que o agente pode executar durante a conversa. Há dois tipos:
- Ações prontas — cadastro do cliente, contato, endereço, consultar API, pesquisar em sites, transferir, agenda, funil, follow-up e outras. Em cada uma, Disponível quando restringe a ferramenta a canal, estágio e/ou tags.
- Ações personalizadas — ferramentas que você cria (parâmetros + o que executar ao acionar)
📖 Ver mais
Lista completa, descrição de cada ação e passo a passo: Ferramentas da IA. Condições por canal: Canal e condições.
5. Base de Conhecimento
Cadastre documentos internos da sua empresa para que a IA consulte durante os atendimentos, oferecendo respostas precisas sem depender de raciocínio genérico.
Como funciona:
Cada documento cadastrado vira automaticamente uma ferramenta disponível para a IA. A busca é adaptativa:
- Documentos curtos (até 3 blocos) → conteúdo completo retornado diretamente
- Documentos longos (mais de 3 blocos) → busca semântica RAG retorna apenas os trechos mais relevantes para a pergunta do cliente
A busca usa tecnologia híbrida combinando embeddings vetoriais com busca por palavras-chave, com suporte a Português, Inglês e Espanhol.
Como adicionar um documento:
- Na aba Base de Conhecimento, clique em "Adicionar documento"
- Preencha:
- Título – Nome do documento (ex:
Horário de Atendimento) - Descrição – Resumo do conteúdo; quanto mais específico, melhor a IA sabe quando chamar (ex:
Contém horários de funcionamento, feriados e telefone para agendamento) - Idioma – Idioma principal do conteúdo
- Conteúdo – Texto completo, com suporte a Markdown
- Título – Nome do documento (ex:
- Clique em "Salvar"
💡 Dica
A descrição é o campo mais importante. Use palavras que o cliente usaria ao perguntar: em vez de "Informações gerais", escreva "Contém endereço, horários, planos aceitos e valores de consulta".
📂 Organização por assunto
Prefira um documento por assunto (ex: Horários, Endereço, Política de Cancelamento) em vez de um único documento com tudo. Documentos focados geram respostas mais precisas.
Benefícios:
- ✅ Respostas mais rápidas e precisas com dados internos da empresa
- ✅ Redução no consumo de tokens
- ✅ Configuração zero — documentos viram ferramentas automaticamente
- ✅ Editor Markdown para formatação de conteúdo
6. Avançado
Configurações detalhadas do agente:
Informações Básicas
- Título: Nome identificador do agente
- Prompt Padrão: Disponibilizar para todas as organizações (apenas superadmins)
Configurações de IA
- Integração: Interflow (créditos do plano), OpenAI (chave própria) ou DeepSeek (chave própria)
- Modelo: Selecione o modelo conforme a integração
- Temperatura (OpenAI sem raciocínio): Controla a criatividade das respostas (0.0 a 2.0)
- Nível de Raciocínio (OpenAI com raciocínio): Baixo, Médio ou Alto
- Thinking Mode (DeepSeek): Liga/desliga raciocínio em cadeia e esforço (Alto / Máximo)
- Máximo de Tokens (OpenAI sem raciocínio): Limite de tokens na resposta
- Verbosidade (modelos GPT-5): Controla o tamanho das respostas
- Fuso Horário: Define o timezone para datas e horários
Envio de mensagens
Na aba Envio:
- Enviar mensagens pelo agente: a resposta final vai direto ao chat (remova o nó Enviar Texto do fluxo para não duplicar)
- Quebrar texto por parágrafo: cada parágrafo (linha em branco) vira uma mensagem
- Assinatura: texto no início ou no fim da mensagem; o modelo não lê esse texto
- Responder com áudio: converte a resposta em áudio com uma voz do sistema; se falhar, envia o texto
- Enviar áudio pelo canal auxiliar: no WhatsApp Oficial com auxiliar WAHA conectado, o áudio sai pelo auxiliar (OGG, som mais natural)
Configurações de Fluxo
- Visualizar Fluxo: Acesse o fluxo vinculado ao agente
- Resetar Fluxo: Recria o fluxo com a configuração padrão
- Gatilhos: Configure quando o agente deve ser acionado
Integração de Fallback
Configure um agente IA secundário que assume automaticamente quando o agente principal não consegue responder ou atinge um limite.
Para que serve?
- Garantir atendimento 24/7 mesmo quando o agente primário está limitado
- Redirecionar automaticamente para um agente especializado em determinados tópicos
- Evitar que clientes fiquem sem resposta em casos de erro ou timeout
Como configurar
- Na aba Avançado do agente, localize a seção "Integração de Fallback"
- Selecione o Agente IA de fallback
- Configure os alertas desejados (notificação ao acionar o fallback)
- Defina os casos de uso para acionamento automático
- Salve
💡 Caso de uso comum
Configure o agente principal para atendimento geral e um agente especializado (ex: suporte técnico) como fallback para perguntas técnicas específicas.
Créditos de IA
O uso dos Agentes IA é medido em créditos baseados em USD, proporcionando transparência no controle de custos.
Tipos de Créditos
| Tipo | Descrição |
|---|---|
| Créditos do Plano | Depositados na renovação mensal. Zerados ao renovar. |
| Créditos Comprados | Adquiridos separadamente. Não expiram. |
| Créditos Bônus | Promocionais ou de indicação. Não expiram. |
Tabela de Custos por Modelo (créditos Interflow / OpenAI)
| Modelo | Input (1M tokens) | Output (1M tokens) |
|---|---|---|
| GPT-5.5 | $5.00 | $30.00 |
| GPT-5.4 | $2.50 | $15.00 |
| GPT-5.4 Mini | $0.75 | $4.50 |
| GPT-5.4 Nano | $0.20 | $1.25 |
| GPT-5.2 / GPT-5.3 Chat Latest | $1.75 | $14.00 |
| GPT-5.1 / GPT-5 / GPT-5 Chat Latest | $1.25 | $10.00 |
| GPT-5 Mini | $0.25 | $2.00 |
| GPT-5 Nano | $0.05 | $0.40 |
| GPT-4.1 | $2.00 | $8.00 |
| GPT-4.1 Mini | $0.40 | $1.60 |
| GPT-4.1 Nano | $0.10 | $0.40 |
Preços DeepSeek (cobrança na conta DeepSeek): veja Integração DeepSeek.
💡 Economia
Tokens em cache custam até 10x menos. Modelos Mini e Nano são significativamente mais baratos para casos de uso de alto volume.
Extrato de Créditos
Acesse o histórico detalhado em Configurações → Uso → Créditos de IA:
- Saldo disponível total
- Detalhamento por fonte (Plano, Comprado, Bônus)
- Histórico completo de transações
- Filtros por tipo de transação e uso
Follow-up Inteligente
A IA pode ajustar automaticamente o follow-up com base no contexto da conversa.
Como Funciona
Quando o cliente menciona uma data futura ou indica que não é o momento:
- "Vamos conversar na quinta" → IA reprograma follow-up para quinta-feira
- "Volto no dia 25" → IA agenda retorno para dia 25
- "Já fechei negócio" → IA pausa o follow-up
Configurando
- Acesse as Ferramentas do agente
- Adicione a ação "Alterar Data de Retorno"
- Selecione o Fluxo e o Nó de destino
- Salve
Transferência com Resumo Automático
Ao transferir uma conversa para equipe humana, a IA pode gerar automaticamente um resumo:
- Edite a ação "Transferir para Equipe"
- Marque: ✅ "Gerar resumo do atendimento ao transferir"
- Salve
O resumo inclui:
- Motivo do contato
- Principais dúvidas do cliente
- Passos já realizados
- Dados importantes coletados
Assinatura em Mensagens
Adicione uma assinatura automática às mensagens enviadas pelo agente, no mesmo formato do nó Enviar Texto. Ela aparece no chat para o cliente, mas não entra no histórico que o modelo lê — a IA não copia nem duplica o texto.
Como Configurar
- Abra o Agente IA na aba Envio
- Ative Enviar mensagens pelo agente
- Preencha Assinatura e escolha Início (Header) ou Fim (Footer)
- Se o fluxo ainda tiver um nó Enviar Texto depois do agente, remova-o para evitar mensagens duplicadas
Inclua as quebras de linha no próprio texto da assinatura se quiser separar do conteúdo.
Fluxos antigos
Com Enviar mensagens pelo agente desligado, o envio continua no nó Enviar Texto — a assinatura nesse caso ainda é a do nó. Veja Mensagem de Texto.
Changelog: v2026.8.9
Resposta em áudio
O Agente IA pode enviar a resposta final como áudio, sem montar nós de TTS no fluxo. Cadastre a voz em Vozes do sistema (ElevenLabs, Minimax ou OpenAI) e ative a opção na aba Envio.
Como configurar
- Abra o Agente IA na aba Envio
- Ative Enviar mensagens pelo agente
- Ative Responder com áudio e escolha a voz
- Ajuste as regras:
- Se o cliente mandou áudio, responder em áudio
- Se a resposta tiver link, enviar texto
- Probabilidade de áudio em respostas de texto (0–100%; 25% equivale a 1 em 4)
- Enviar áudio pelo canal auxiliar — no WhatsApp Oficial com canal auxiliar WAHA conectado, o áudio sai pelo auxiliar (conversão para OGG e som mais natural). Sem auxiliar disponível, envia pelo oficial.
- Se o fluxo ainda tiver nós de TTS / áudio depois do agente, remova-os para não duplicar o envio
O texto gerado pelo modelo é reescrito para leitura em voz (números, datas e URLs por extenso). O áudio vai ao cliente com essa versão como transcrição. Listas interativas e mídia JSON continuam em texto.
Se o áudio falhar
Qualquer erro (voz, reescrita, TTS, upload ou envio) faz o agente enviar o texto original. O cliente não fica sem resposta.
Changelog: v2026.9.5
Integração com Agendamentos
A IA pode gerenciar agendamentos de forma conversacional:
Exemplo de Conversa
👤 Cliente: Quero marcar uma consulta
🤖 IA: Claro! Para qual dia você prefere? Temos horários disponíveis de segunda a sexta.
👤 Cliente: Quinta às 14h
🤖 IA: Perfeito! Temos disponibilidade quinta-feira às 14h com Dr. João.
Confirmo o agendamento?
👤 Cliente: Sim, por favor
🤖 IA: ✅ Agendamento confirmado!
📅 Data: Quinta-feira, 26/12/2025
⏰ Horário: 14:00
👨⚕️ Profissional: Dr. João
Enviarei um lembrete 24h antes. Até lá! 😊Respeitando Folgas
A IA automaticamente:
- ❌ Não oferece horários em períodos de folga
- ❌ Não permite criar agendamentos em dias bloqueados
- ✅ Explica ao cliente o motivo da indisponibilidade
- ✅ Sugere automaticamente datas alternativas
Mensagens e dados do cliente
Cada agente controla quanto histórico e quais dados do cliente entram no contexto enviado ao modelo. Na aba Contexto, o botão Mensagens e dados do cliente abre essa configuração.
O limite de mensagens define quantas mensagens do chat atual o modelo vê (1 a 200; padrão 50). Em conversas longas, um limite menor reduz tokens sem mudar o prompt.
Em Dados do cliente, escolha o que vai na primeira mensagem após o prompt:
| Opção | O que o modelo recebe |
|---|---|
| Sim | Todos os campos do cadastro. Opcional: ligar Mascarar dados e marcar o que ocultar em parte (CPF, e-mail, telefone, endereço) |
| Não | Nenhum dado cadastral |
| Alguns | Só os campos marcados em Enviar; em cada um, dá para marcar Mascarar |
Campos disponíveis: nome, e-mail, documento (CPF/CNPJ), país, contatos, endereços, tags, estágio do funil, campos personalizados, conversas anteriores e agendamentos futuros. Canal e data/hora do sistema entram sempre, independente dessa opção.
Agentes antigos sem essa configuração seguem com 50 mensagens e todos os dados, sem máscara.
Changelog: v2026.8.21
Executar em uma mensagem
No menu de uma mensagem do cliente ou do agente, Executar agente IA dispara o prompt sem iniciar fluxo. O modelo vê só aquela mensagem (mais data, canal e dados do cliente). As ferramentas são as mesmas; o envio ao chat depende de Enviar mensagens pelo agente.
Não aparece em nota privada, evento de sistema nem chat agendado. A permissão é a de iniciar fluxo.
Guia completo: Executar em uma mensagem
Skills
Skills são contextos adicionais concatenados ao prompt do agente — listas de produtos, FAQs, regras ou qualquer bloco extra. Diferente da base de conhecimento, o conteúdo entra direto no contexto, sem a IA precisar chamar uma ferramenta.
Tipos
- Texto livre: FAQ, regras, catálogo
- Lista WhatsApp: Formata o conteúdo para listas interativas do WhatsApp
Como adicionar
- Na aba Contexto, em Skills, clique em Adicionar skill
- Escolha o tipo (texto livre ou lista WhatsApp)
- Preencha título, descrição e conteúdo
- (Opcional) defina Exibir quando — canal, estágio e/ou tags
- Salve o contexto do agente
As skills que passam na condição são concatenadas em um único texto. Sem filtro, o bloco entra sempre. Guia: Canal e condições.
Boas Práticas
✅ Faça
- Seja específico no prompt sobre o comportamento esperado
- Forneça exemplos de respostas ideais
- Limite o escopo de atuação (o que a IA pode e não pode fazer)
- Teste exaustivamente antes de colocar em produção
- Monitore as conversas e ajuste o prompt
- Use Fora de contexto para ver perguntas de clientes que o agente não encontrou no contexto
❌ Evite
- Prompts vagos ou genéricos
- Permitir que a IA invente informações
- Dar autonomia excessiva sem supervisão
- Esquecer de configurar transferência para humano
- Ignorar feedback dos clientes sobre a IA
Métricas e Relatórios
Acompanhe o desempenho dos seus Agentes IA:
- Taxa de resolução: % de conversas resolvidas sem humano
- Tempo médio de resposta: Velocidade da IA
- Transferências: Quantas vezes transferiu para humano
- Satisfação: Avaliação dos clientes
- Uso de tokens: Consumo de API
Próximos Passos
- Executar em uma mensagem - Disparar o agente sem fluxo
- Canal e condições - Um agente em vários canais
- Ferramentas da IA - Configure ações do agente
- Melhorador de Texto - Comandos de IA para atendentes
- Fluxos de Atendimento - Integre IA nos fluxos
- Agenda - Configure agendamentos via IA
- Configurações - Controles de IA