For the complete documentation index, see llms.txt. This page is also available as Markdown.

Campos obrigatórios: dados obrigatórios por etapa

Garanta a qualidade dos seus dados. Configure "travas" para que a IA (ou sua equipe) não possa avançar um cliente para uma etapa específica sem ter os dados obrigatórios completos, incluindo agora c

A funcionalidade de Campos Obrigatórios atua como um filtro de qualidade no seu funil de vendas. Permite definir quais informações são obrigatórias para entrar em uma etapa específica, incluindo agora campos de contato. Isso permite uma personalização mais profunda na coleta de dados por fase do processo.

A Regra de Ouro: Os campos são obrigatórios para ENTRAR na etapa.

  • Se a IA tentar mover um cliente para "Cotização", primeiro verificará se ele tem os dados exigidos por "Cotização".

  • Se você mover manualmente um ticket para "Cotização", o sistema pedirá que você preencha esses dados manualmente.


1. Como funciona a lógica da IA?

Quando seu Assistente de IA decide que é hora de avançar um cliente (ex: o cliente pede cotação), o sistema executa uma validação de segurança sobre a etapa de destino:

  1. Tentativa de Mudança: A IA executa a função change_stage para mover o cliente para a etapa-alvo (ex: "Pendente Enviar Cotação").

  2. Verificação de Destino: O sistema verifica: "Esta etapa de destino exige algum dado obrigatório?".

  3. Extração Inteligente (Gemini Flash):

    • Se o dado estiver faltando (ex: RUT), a IA analisa toda a conversa histórica e as ferramentas usadas anteriormente para ver se o cliente já o mencionou.

    • Se encontrar, salva automaticamente e autoriza a entrada na etapa.

  4. Solicitação Ativa:

    • Se o dado não existir no chat, o sistema bloqueia a mudança de etapa.

    • A IA, em vez de mover o cliente, responde solicitando o dado faltante.

Exemplo:

  • Meta: Entrar na etapa "Pendente Cotação" (Requer: RUT).

  • Ação: A IA detecta que falta o RUT.

  • Resposta ao cliente: "Para gerar sua cotação formal e avançar, preciso que você me informe seu RUT, por favor."


2. Configuração Passo a Passo

Para ativar esses requisitos de entrada, siga estes passos:

  1. Entre no seu Funil e clique no ícone de Lápis (Editar Funil) no canto superior direito.

  2. Selecione a aba Tickets.

  3. Localize a coluna da Etapa de Destino (a etapa à qual você quer adicionar requisitos de entrada).

  4. Ative o botão "Campos obrigatórios".

  5. Selecione na lista os dados (incluindo campos de contato) que devem estar preenchidos para permitir a entrada.

  1. Clique em Salvar alterações.


3. Movimentos Manuais vs. IA

É importante entender como isso afeta sua operação diária:

  • 🤖 Movimento por IA: É 100% automático. A IA busca o dado no chat. Se não estiver lá, pede ao cliente de forma natural na conversa.

  • 👤 Movimento Manual (Agente): Se você arrastar um ticket manualmente para uma etapa com requisitos, o sistema detectará que o dado está faltando e abrirá uma janela pop-up obrigando você a preenchê-lo manualmente naquele momento. Você não poderá soltar o ticket nessa etapa até completar as informações.


4. Visualização nos Logs (Field Extraction)

Você pode monitorar como a IA busca essas informações revisando os logs da conversa ou o Playground. Você verá um evento chamado FIELD_EXTRACTION.

  • Required fields: Mostra o que a etapa de destino exigia.

  • Missing fields: Mostra o que não encontrou.

  • Message sent to user: Mostra a pergunta que gerou para pedir o dado.

Atualizado

Isto foi útil?