Abrir o Beeven

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.

Painel lateral de um nó Agente aberto na aba Configuração, mostrando os cartões Perfil, Missão, Tags automáticas, Preencher campos personalizados, Follow-ups e sem resposta, Saídas condicionais e Catálogo de produtos. A aba Perguntas frequentes aparece ao lado.

Passo a passo

  1. Clique em Agente no menu de adicionar nós.
  2. Clique no nó Agente no canvas.
  3. Escolha um agente existente na lista ou clique em Criar novo agente.
  4. Preencha os cartões da aba Configuração.
  5. Se quiser ensinar respostas fixas, abra a aba Perguntas frequentes e adicione as perguntas do negócio.
  6. 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:

  1. No campo Tag, selecione uma tag existente ou clique em Criar para cadastrar uma nova.
  2. Em Quando aplicar, explique o sinal que deve fazer o agente aplicar a tag.
  3. 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.

  1. Em Campo, selecione o campo que o agente deve preencher. Os campos aparecem agrupados em Contato e Lead.
  2. 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.
  3. 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.

  1. Clique em Adicionar tentativa.
  2. Em Tempo sem resposta, informe o intervalo e escolha Minutos ou Horas.
  3. Em Como o agente deve conduzir o follow-up, escreva o que ele deve dizer ou fazer nessa tentativa.
  4. Adicione até 5 tentativas, sempre com tempos maiores que a tentativa anterior.
  5. 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.

  1. Na aba Configuração do agente, vá até o cartão Catálogo de produtos.
  2. Ligue a chave do cartão.
  3. 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.

  1. Em Pergunta, escreva a dúvida do cliente.
  2. Em Resposta, escreva o conteúdo que o agente deve usar.
  3. Clique em Adicionar pergunta.
  4. 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.