Visão Geral
As funcionalidades de captura e uso de dados do consumidor permitem que os agentes do Whizz utilizem informações do consumidor como variáveis dinâmicas dentro das instruções do agente e também capturem novos dados durante a conversa para salvamento automático no perfil do consumidor.
Com essa funcionalidade, o Whizz passa a oferecer conversas mais personalizadas, contextuais e estruturadas, permitindo:
Uso de variáveis dinâmicas no prompt do agente
Captura automática de novos dados durante a conversa
Persistência de informações diretamente no perfil do consumidor na Omni
Reutilização dos dados capturados em interações futuras
Essa abordagem é especialmente útil em cenários onde o agente precisa:
Personalizar o atendimento utilizando dados do consumidor
Coletar informações durante fluxos de qualificação
Salvar dados importantes sem integrações externas
Estruturar processos de matrícula, onboarding, cadastro ou suporte
Reutilizar informações já coletadas ao longo da jornada
Exemplos de dados suportados:
Nome
E-mail
Telefone
CPF
CEP
Campos adicionais/customizados
Durante a configuração do agente no Whizz Studio, o usuário pode utilizar variáveis diretamente nas instruções e também configurar comandos estruturados de captura de dados.
Exemplo:
Olá @Cliente.Nome, tudo bem? Qual seu melhor email? /capturar.cliente.email
Nesse cenário:
O nome do consumidor será utilizado dinamicamente na conversa
O Whizz solicitará o email ao consumidor
O dado será validado
O email será salvo automaticamente no perfil do consumidor
O valor poderá ser reutilizado futuramente como @Cliente.EMail
Como Funciona
A funcionalidade é dividida em dois comportamentos principais:
Uso de variáveis dinâmicas
Captura e salvamento de dados do consumidor
Uso de variáveis dinâmicas
O Whizz permite utilizar dados disponíveis no perfil do consumidor como variáveis dentro do prompt de instruções do agente.
As variáveis seguem o padrão:
@Cliente.Nome
@Cliente.Email
@Cliente.CPF
Quando a conversa acontece, o Whizz substitui automaticamente essas variáveis pelos dados reais do consumidor.
Exemplo:
Olá @Cliente.Nome, tudo bem?
Resultado esperado:
Olá Amanda, tudo bem?
Importante:
Somente o padrão “@” é reconhecido como variável.
Qualquer outro formato será tratado como texto comum.
Captura e salvamento de dados
Durante a configuração do agente, o usuário pode utilizar comandos estruturados para que o Whizz solicite informações ao consumidor e salve automaticamente esses dados no perfil.
O fluxo funciona da seguinte forma:
o usuário digita “/” no editor de instruções
o Whizz exibe uma lista de ações disponíveis
o usuário seleciona a ação desejada
o tipo de dado é definido
durante a conversa, o agente solicita a informação ao consumidor
o dado é validado automaticamente quando aplicável
a informação é salva no perfil do consumidor
o dado passa a ficar disponível como variável
Exemplo:
Qual seu melhor email? /Capturar.Cliente.EMail
Nesse caso:
o agente solicita o email
o consumidor responde
o Whizz valida o formato do email
o dado é salvo automaticamente
o email pode ser reutilizado posteriormente como @Cliente.EMail
Importante:
Somente o padrão “/” é reconhecido para ativar uma ação de captura.
Qualquer outro formato será tratado como texto comum.
Para campos estruturados, o Whizz realiza validações automáticas.
Exemplos:
email válido
telefone válido
CPF válido
data de nascimento válida
O sistema também pode tratar informações enviadas fora do formato esperado.
Exemplo:
25 de setembro de 91
Pode ser convertido automaticamente para:
25/09/1991
Caso o dado informado seja inválido, o agente solicitará a correção ao consumidor.
Configuração no Whizz Studio
Acessar a área de configuração
No menu principal do Whizz Studio:
Acesse Agentes
Selecione o agente desejado
Acesse a área de Instruções do agente
Para utilizar variáveis no prompt:
Dentro do editor de instruções digite “@”
O sistema exibirá as variáveis disponíveis. Selecione a variável desejada.
O dado a ser utilizado ficará destacado em azul no texto
Exemplos:
@Cliente.Nome
@Cliente.Email
@Cliente.CPF
As variáveis disponíveis podem incluir:
Dados padrões do consumidor
Dados adicionais/customizados do cadastro
O editor exibirá feedback visual (texto destacado em azul) indicando quais variáveis estão sendo utilizadas
Importante:
Caso algum dado do consumidor não esteja preenchido, a variável ficará em branco durante a conversa.
Para capturar dados do cliente:
Dentro do editor de instruções digite “/”
O sistema exibirá uma lista de ações disponíveis
Selecione o dado que deseja capturar
O dado a ser capturado ficará destacado em verde no texto
Exemplos:
/Capturar.Cliente.EMail
/Capturar.Cliente.CPF
/Capturar.Cliente.Telefone
Também é possível utilizar campos customizados.
Exemplo de configuração:
Olá! Para continuar seu atendimento, preciso de algumas informações. Qual seu melhor email? /Capturar.Cliente.EMail Qual seu curso de preferência? /Capturar.Cliente.CamposCustomizados.CursoDoUsuario
Exemplo de prompt de instruções com captura de informações do cliente:
Benefícios
Permite utilizar informações do cliente dinamicamente durante a conversa.
Padroniza a captura de informações importantes diretamente no fluxo conversacional.
Dados capturados passam a ficar disponíveis como variáveis reutilizáveis.
Facilita a criação de agentes de qualificação, onboarding, matrícula e suporte.
O agente consegue conduzir conversas mais contextualizadas e naturais.
Considerações
Somente variáveis no padrão “@” serão reconhecidas pelo sistema.
Para acessar ações disponíveis deve ser utilizado o padrão “/”.
Campos estruturados possuem validação automática de formato.
Dados não preenchidos no perfil do consumidor resultarão em variáveis vazias.
Os dados capturados são automaticamente salvos no perfil do consumidor na Omni.
Campos customizados também podem ser utilizados.
Recomenda-se utilizar instruções claras e objetivas para melhorar a qualidade da coleta de dados realizada pelo agente.