Como criar um agente de Serviços no Whizz Studio

O agente de Serviços é um agente de IA Whizz pensado para o segmento educacional e para empresas de serviços em geral. Ele recebe novos leads, qualifica (ou desqualifica) de acordo com o perfil de cliente ideal, tira dúvidas, conduz matrículas e direciona as conversas para o time comercial.
​

Este guia explica os dois caminhos de criação (com IA e manual), o que cada bloco do editor faz, como ajustar o agente com Editar com IA e Revisar com IA, quais configurações extras revisar e o que checar antes de publicar.
​

Depois de selecionar o tipo do agente, você escolhe entre dois botões: Criar manualmente ou Criar Whizz com IA.

A qualidade do agente depende diretamente da qualidade das informações fornecidas. Tenha estes seis itens em mãos antes de abrir a tela de criação:

Importante: se o agente for usado para qualificação e os critérios de desqualificação não estiverem definidos, alinhe isso antes de criar. Sem eles, o agente qualifica todos os leads e o time comercial recebe contatos fora do perfil.

Em seguida, clique em Criar Whizz com IA.

A tela de briefing tem os blocos abaixo. O botão Criar Whizz com IA fica habilitado quando os campos obrigatórios estão preenchidos.
​

Nome do Whizz: já vem preenchido do passo anterior.
​

Responsabilidades e características do seu Whizz (até 4.096 caracteres): é o principal insumo do agente. Escreva em texto corrido e inclua:

Exemplo: "O agente deve qualificar interessados em cursos EAD perguntando idade, conclusão do ensino médio, área de interesse, objetivo profissional, disponibilidade para estudar e previsão de início. O perfil ideal inclui pessoas com ensino médio completo, intenção de começar em até 3 meses e acesso à internet; candidatos sem esses critérios devem ser orientados de que não podem seguir e o atendimento deve ser encerrado. Para seguir com a matrícula, o agente deve coletar dados básicos e direcionar para inscrição ou atendimento humano. A comunicação deve ser acolhedora, clara e objetiva."
​

Dica: se o texto não tiver pelo menos uma frase para cada um dos cinco itens, o briefing ainda está incompleto. Informações genéricas geram etapas genéricas.
​

Perfil do cliente (ICP): descreve quem é o cliente ideal. A IA usa este campo para criar as etapas e as perguntas do fluxo.

Contexto do negócio (até 4.096 caracteres): ramo de atuação, o que a empresa oferece, público-alvo, portfólio e diferenciais. É obrigatório na criação com IA e ajuda a evitar respostas genéricas ou inventadas.
​

Fonte de conhecimento: preencha pelo menos uma opção.

Valide o site antes de usar. Sites com pouco conteúdo, muita informação em imagem ou ainda em construção deixam o agente sem resposta. Nesses casos, suba um documento com as informações relevantes.

Ação final e ação após desqualificação:

Ao clicar em Criar Whizz com IA, a plataforma mostra o progresso da criação e gera automaticamente:

Ao final, a mensagem Seu agente está pronto! aparece com um chat de teste. Faça o primeiro teste ali mesmo, antes de qualquer ajuste:

Depois, clique em Continuar editando para ir ao modo de edição.

Na criação manual, você configura cada bloco do agente diretamente no editor.
​

A configuração segue esta ordem:

Cada um desses blocos está detalhado na seção abaixo.

O agente é criado com o status Não publicado. O editor tem quatro seções no menu à esquerda e, no topo, os botões Revisar com IA, Editar com IA, Testar agente, Salvar e Publicar.

Valem para a conversa inteira e têm dois campos:

Habilidades são ações que o agente aciona durante a conversa, como responder com um texto fixo, transferir para um time, finalizar a conversa ou consultar uma API.

Bloco que pode ser ativado ou desativado para enviar uma mensagem no início da conversa. Há duas opções de comportamento:

Clique em Criar etapa para adicionar uma nova etapa ao fluxo. É possível excluir etapas e reorganizar o canvas. Existem três tipos de etapas:

Campos da etapa padrão:

A etapa Informativa tem nome, instruções e conteúdo, próxima etapa e habilidades.

A etapa Dúvidas tem os mesmos campos da etapa padrão, exceto os critérios de desqualificação.

Modos de pergunta

Desqualificação: critério + habilidade

Todo critério de desqualificação precisa de uma habilidade vinculada. Sem ela, o lead é reprovado e não é encaminhado para lugar nenhum. Exemplo:

Último bloco do fluxo. O lead que passa por todas as etapas sem ser desqualificado precisa ser encaminhado para um time, bot ou outro agente, ou ter o atendimento encerrado. Selecione a habilidade com a ação desejada.

É onde o agente busca as informações para responder o lead, como duração do curso, grade ou serviços oferecidos.

Dica: na dúvida entre link estático e busca em tempo real, pergunte: "essa informação muda?" Caso não, o link estático é mais rápido e indicado, mas não acompanha atualizações do site.

Permite alterar a configuração do agente com pedidos em linguagem natural, sem precisar procurar o bloco no canvas.

Exemplos de pedidos:

Dicas: faça um pedido por mensagem, cite a etapa pelo nome (e não só pelo número) e leia o card antes de seguir. Para mudanças estruturais grandes, edite direto no canvas.

Faz uma auditoria automática da configuração e propõe correções para você aceitar ou ignorar.

Cada sugestão mostra o tipo de problema (ex.: "Pergunta duplicada"), a explicação, a proposta de remoção ou substituição, a localização no agente e a severidade.

Importante: aplicar as sugestões não salva nem publica o agente. Clique em Salvar, teste novamente e depois em Publicar.

Dicas: comece pelas sugestões de severidade Alta e leia o card inteiro. Nem toda sugestão precisa ser aceita, por exemplo quando o texto foi aprovado pelo jurídico. Se a sugestão for remover uma informação das diretrizes, leve esse conteúdo para a base de conhecimento ou para uma habilidade.

As configurações extras não são geradas a partir do briefing e vêm desabilitadas por padrão. Revise esta seção antes de publicar para evitar leads sem retorno e pedidos de atendimento humano ignorados.

Deve ser configurada no bot vinculado ao agente, em Automações > Bot Studio Pro > Configurações > Eventos. Saiba mais em Cadastro de inatividade por multibot.

Ao ativar, selecione o Time responsável, que receberá as conversas na fila. Recomendamos ativar na maioria dos casos, para que o cliente não fique sem resposta. Deixe desativada apenas quando não houver time humano disponível para o canal.

Esse time é independente do time configurado na ação final: um recebe o lead qualificado, o outro recebe quem pediu ajuda no meio da conversa. Podem ser o mesmo time, desde que seja uma escolha consciente.

Ative para manter a fila organizada e as métricas de atendimento corretas, especialmente em fluxos de qualificação com transbordo bem definido. Deixe desativado quando a conversa precisar permanecer aberta para acompanhamento manual.

Ao ativar, o Whizz envia cada resposta completa em uma só mensagem. Isso reduz a quantidade de mensagens enviadas pelo agente e, consequentemente, o custo de mensagens da Meta.

Antes de publicar, teste estes cinco cenários no Testar agente:

Com os testes aprovados, clique em Publicar. Depois da publicação, conecte o agente a um canal de atendimento para que ele comece a receber conversas, seguindo a orientação exibida na tela.

Recomendamos a criação com IA na maioria dos casos, inclusive para fluxos complexos. A criação manual é indicada para fluxos muito específicos, réplicas de fluxos já validados ou fluxos que dependem de API.

Provavelmente o ICP está genérico ou faltam critérios de desqualificação. Descreva região, perfil e o que reprova um lead, e confira se cada critério tem uma habilidade vinculada.

O conteúdo pode estar cadastrado como link estático, que guarda a versão do site no momento do cadastro. Para informações que mudam, use a busca em tempo real.

Revise o objetivo da etapa. Objetivos vagos impedem o agente de saber quando avançar. Descreva o objetivo como um dado a ser coletado.

Aplicar sugestões não salva nem publica o agente. Clique em Salvar e depois em Publicar.