HeadOfficeOS Documentação
Construir IAgentes
HEADOFFICE OS / DOCUMENTAÇÃO

Coleta de dados e funil

Separe cadastro, conversa e regras determinísticas de progressão.

Edição de 7 de outubro de 2026 • Português

Campos não são etapas

Na configuração do IAgente, CRM define o que coletar sobre o contato. Funil de vendas define por quais etapas o contato passa. Adicionar um campo não cria uma coluna no funil.

A interface distingue a orientação conversacional da validação determinística: o texto orienta como perguntar; o funil/FSM valida e controla progressão.

Configure a coleta

  1. Use Adicionar campo para o dado necessário à missão.
  2. Revise tipo, obrigatoriedade, sensibilidade e etapa em que perguntar.
  3. Escolha coleta por formulário inicial, conversa ou combinação adequada.
  4. Defina estratégia: o quanto antes, só quando necessário ou gradual.
  5. Defina tom, limite de tentativas e alternativa quando o cliente recusar.
  6. Teste dados ausentes, inválidos e duplicados.

Peça apenas o dado necessário ao próximo passo. Para uma triagem inicial, nome, assunto e descrição podem ser suficientes; informações adicionais devem ter finalidade clara.

Reconhecer contatos existentes

O bloco oferece telefone ou e-mail como chave primária, reconfirmação após um período e políticas de merge. A interface alerta que encontrar o mesmo telefone não prova identidade e distingue vinculação de alteração de cadastro.

Se houver divergência, confirme o contato antes de associar a conversa. Alterar nome, telefone ou e-mail de um cadastro existente merece confirmação específica, conforme a configuração escolhida.

Desenhar o funil

ATLAS DEMO · PASSO A PASSO Botão Salvar e compilar do funil do Atlas Demo. Revise etapas e ações antes de aplicar.
Botão Salvar e compilar do funil do Atlas Demo. Revise etapas e ações antes de aplicar.

Use etapas que representem estados observáveis. Exemplo editorial:

EtapaEntradaSaída
Novo contatoPrimeira interaçãoIntenção identificada
IdentificadoDados mínimos válidosDiagnóstico suficiente
Em atendimentoCaso em resoluçãoResultado confirmado ou encaminhamento
ConcluídoTrabalho finalizadoReabertura quando houver nova demanda

A interface permite várias ações por etapa, como mensagem, webhook, tag e mudança de etapa. Revise a sequência para evitar ciclos e mensagens duplicadas.

Salvar, compilar e conferir

Depois de revisar as etapas, o comando Salvar e compilar aplica a definição. O bloco Workflow vigente é descrito como leitura direta da máquina de estados executada. Confira se o fluxo vigente corresponde ao que você pretendia configurar.

Teste um caso completo e os caminhos de exceção: campo recusado, transição fora de ordem, contato que retorna e falha de uma ação. O desenho visual sozinho não comprova a execução.

Nesta página