Configurar agentes
Visão geral
O nó Agente coloca o Agente de IA no meio do seu fluxo. Configure o comportamento, o objetivo e as saídas do agente para que ele converse com o cliente e entregue cada situação ao próximo caminho.
Onde encontrar
No menu lateral, acesse Fluxos, abra um fluxo e clique no botão + do canvas. Escolha Agente e depois clique no nó criado para abrir o painel lateral.

Passo a passo
- Clique em Agente no menu de adicionar nós.
- Clique no nó Agente no canvas.
- Escolha um agente existente na lista ou clique em Criar novo agente.
- Preencha os cartões da aba Configuração.
- Se quiser ensinar respostas fixas, abra a aba Perguntas frequentes e adicione as perguntas do negócio.
- Clique em Salvar.
Ao editar um agente existente, o botão voltar permite retornar à lista de agentes. Se você sair com alterações não salvas, o Beeven pergunta se deseja Continuar editando ou Descartar.
Perfil
O cartão Perfil define a identidade do agente:
- Nome: como o agente será identificado dentro do fluxo. Exemplo:
Qualificador da Clínica Exemplo. - Personalidade: explique o tom de voz, o jeito de escrever, o que o agente pode fazer e o que deve evitar. Use instruções concretas, como “responda de forma simpática e objetiva” ou “não invente informações”.
Missão
O cartão Missão define o resultado que o agente deve buscar:
- Objetivo: descreva a principal meta em cada conversa e a sequência que o agente deve seguir.
- Critério de sucesso: diga o que precisa acontecer para o agente considerar o atendimento bem-sucedido e poder encerrar.
Escreva a missão como uma orientação de trabalho. Em vez de “vender”, explique o que o agente deve descobrir, recomendar e fazer quando o cliente demonstrar interesse.
Tags automáticas
Use Adicionar tag automática para criar regras que aplicam tags ao lead conforme a conversa. Em cada item:
- No campo Tag, selecione uma tag existente ou clique em Criar para cadastrar uma nova.
- Em Quando aplicar, explique o sinal que deve fazer o agente aplicar a tag.
- Remova a regra pelo ícone de lixeira quando ela não for mais necessária.
Você pode configurar até 5 tags automáticas. Exemplo: aplique a tag Interesse em clareamento quando o lead pedir preço ou demonstrar interesse nesse procedimento.
Preencher campos personalizados
Use Adicionar campo personalizado para fazer o agente extrair uma informação da conversa e gravá-la no contato ou no lead.
- Em Campo, selecione o campo que o agente deve preencher. Os campos aparecem agrupados em Contato e Lead.
- Em O que preencher, descreva qual informação deve ser extraída e como reconhecê-la. Exemplo:
Extraia o CPF que o lead informar durante a conversa. - Salve o nó.
Você pode configurar até 5 campos personalizados. O mesmo campo não pode ser usado duas vezes no mesmo agente.
Follow-ups e sem resposta
Use este cartão para que o agente tente reengajar um lead que parou de responder antes de seguir pela saída Sem resposta.
- Clique em Adicionar tentativa.
- Em Tempo sem resposta, informe o intervalo e escolha Minutos ou Horas.
- Em Como o agente deve conduzir o follow-up, escreva o que ele deve dizer ou fazer nessa tentativa.
- Adicione até 5 tentativas, sempre com tempos maiores que a tentativa anterior.
- No cartão Sem resposta, defina quanto tempo deve passar depois da última tentativa.
O aviso no final do cartão mostra quando a saída Sem resposta será acionada no total. O tempo do cartão Sem resposta é somado ao tempo da última tentativa.
Saídas condicionais
Use Adicionar saída condicional para criar caminhos extras quando o agente identificar uma situação específica, como uma reclamação, um pedido de orçamento ou uma solicitação de atendimento humano.
Para cada saída:
- Em Nome, escreva um rótulo curto, com até 20 caracteres. Esse nome aparece como saída no canvas.
- Em Quando usar, explique em que situação o agente deve escolher esse caminho.
Você pode criar até 5 saídas condicionais. Depois de salvar, conecte cada saída ao nó correspondente.
Informar horários livres
Ligue o cartão Informar horários livres para o agente consultar a Agenda quando o lead perguntar por horário. Em Tipos de agendamento, marque os tipos cujos horários ele pode informar; os profissionais vêm de cada tipo. O agente só informa: nunca agenda nem reserva, e passa para a equipe quando o lead quer marcar. Consome mais créditos de IA, e a mudança só vale depois de republicar os fluxos que usam o agente.
Veja como configurar, os avisos do cartão e exemplos de resposta em Informar horários livres.
Catálogo de produtos
Ligue o cartão Catálogo de produtos para o agente consultar sua lista de produtos durante a conversa. Ele pode informar nome, preço e descrição e envia as imagens cadastradas logo depois da resposta.
- Na aba Configuração do agente, vá até o cartão Catálogo de produtos.
- Ligue a chave do cartão.
- Clique em Salvar.
Como funciona:
- Vale para o agente. Todos os fluxos que usam esse agente passam a consultar o catálogo.
- O agente vê só os produtos relacionados. A cada mensagem do lead, ele recebe até 5 produtos ativos ligados ao que o lead escreveu, não o catálogo inteiro.
- Produtos inativos ficam de fora. Um Produto inativo continua na sua lista de produtos, mas o agente não o cita, não informa o preço e não envia as imagens dele. Reative o produto para que o agente volte a oferecê-lo.
- Categorias ajudam o agente a encontrar o produto certo. Atribua Categorias de produto aos seus produtos para agrupá-los: além do nome e da descrição, elas ajudam o agente a achar o produto ligado ao que o lead pediu.
- Imagens de até 3 produtos por resposta, e só dos produtos que têm imagem cadastrada. As imagens chegam logo depois do texto da resposta, começando pela Imagem de capa (a primeira da lista do produto).
- Produto com uma imagem vai como foto. Com 2 ou 3 imagens, no WhatsApp ele vai como um Carrossel de produto: um card por imagem, cada um com nome, preço e o botão Tenho interesse. No Instagram, que não tem carrossel, cada imagem chega como uma mensagem separada.
- No Atendimento, o carrossel aparece como uma imagem só, a Imagem de capa, com o nome e o preço na legenda. Quando o lead toca em Tenho interesse, isso chega como uma mensagem de texto comum.
- Perguntas do agente chegam depois das imagens. Se a resposta termina com uma pergunta para o lead, ela vai numa mensagem própria, depois das imagens.
- Produtos novos ou editados levam alguns segundos para aparecer. Depois de cadastrar um produto ou mudar o nome ou a descrição, espere um pouco antes de testar.
- Consome mais créditos de IA, porque o agente recebe os produtos junto com cada mensagem.
- Em Testar fluxo, um produto com uma imagem aparece como um balão Imagem: nome do produto, e um produto com 2 ou 3 imagens aparece como um balão de carrossel com o nome do produto. A pergunta do agente aparece depois, na mesma ordem em que chegaria ao lead.
Perguntas frequentes
Na aba Perguntas frequentes, ensine respostas para as dúvidas mais comuns dos clientes.
- Em Pergunta, escreva a dúvida do cliente.
- Em Resposta, escreva o conteúdo que o agente deve usar.
- Clique em Adicionar pergunta.
- Edite uma entrada pelo menu de ações da tabela ou remova-a quando necessário.
Você pode cadastrar até 20 perguntas. Cada pergunta aceita até 200 caracteres e cada resposta, até 500 caracteres.
Atenção: O agente só pode ser publicado quando os campos obrigatórios — Nome, Personalidade, Objetivo, Critério de sucesso e Sem resposta — estiverem preenchidos.
Pronto!
Conecte as saídas Resposta bem-sucedida, Sem resposta e as saídas condicionais aos próximos nós. Teste cada caminho em Testar fluxo antes de publicar e consulte configurar mensagens para criar respostas específicas antes ou depois do agente.