Cadastrar um procedimento de coleta

Um procedimento reúne apresentação, perguntas e decisões em um cadastro reutilizável. Ele pode ser usado em vários agentes. Os dados que variam entre serviços, campanhas ou processos podem vir de uma lista do CRM ou de parâmetros, sem copiar todo o roteiro.

O procedimento conduz a conversa dentro do agente de IA. Suas saídas podem executar outras capacidades e, depois, retornar ao fluxo do bot.

Exemplo: qualificação para uma demonstração

Vamos montar um roteiro simples:

1. Apresentar o propósito das perguntas.
2. Perguntar como a pessoa prefere ser chamada.
3. Perguntar se deseja conhecer a solução em uma demonstração.
4. Se responder Não, encerrar a coleta por Sem interesse agora.
5. Se responder Sim, concluir por Quer uma demonstração.

É um exemplo de serviço comercial; a mesma estrutura serve para suporte, cadastro, solicitações, matrículas ou outros processos.

Abra o cadastro

Acesse Cadastrar procedimentos de coleta e crie um procedimento chamado Qualificação para demonstração.

Ampliar

O Roteiro organiza as etapas. Clique em uma etapa para editá-la na área ao lado. A Prévia ajuda a conferir a leitura das perguntas e dos resultados antes de usar o procedimento no agente.

1. Escreva a apresentação

Na etapa Apresentação, use:

Vou fazer duas perguntas rápidas para entender como podemos ajudar.

A mensagem inicial é opcional. Em Condução da conversa, escolha:

Para este exemplo, use Roteirizada. Nos dois modos, a IA pode interpretar respostas abertas; ela não pode ignorar as condições definidas para o processo.

2. Cadastre a primeira pergunta

Clique em + Pergunta e preencha:

O identificador pode ser gerado automaticamente. Depois de utilizá-lo em condições ou integrações, mantenha-o estável. A resposta fica disponível em values.nome.

3. Adicione a pergunta de interesse

Crie outra pergunta:

Ampliar

Perguntas com escolhas podem gerar opções estruturadas conforme o canal. Para escolhas personalizadas, use Escolher uma opção e cadastre os rótulos em linguagem clara. Os códigos das respostas são usados nas condições; não compare apenas o texto visual se houver códigos diferentes.

4. Encerre antecipadamente quando a resposta não atender

Em Saídas do procedimento, clique em + Saída por condição. Você também pode selecionar a pergunta e usar + Encerrar por condição em Depois da resposta. Configure:

1. Nome da saída: Sem interesse agora.
2. Quando avaliar: após a pergunta sobre interesse.
3. Em Se, selecione a resposta Interesse na demonstração pelo seletor.
4. Em Condição, escolha For igual a.
5. Em Valor, escolha Não.
6. Em Motivo registrado, informe Pessoa não deseja uma demonstração neste momento.
7. Confira o identificador sem_interesse e a prioridade em Identificador e prioridade.

Ampliar

A decisão é avaliada no ponto configurado. Quando corresponde, a coleta termina sem exigir perguntas seguintes. Use respostas já disponíveis até aquele ponto: uma regra antecipada não pode depender de uma pergunta que ainda será feita.

Para uma regra avaliada apenas depois de todas as perguntas, mantenha Ao concluir toda a coleta. Se houver várias saídas compatíveis, revise a prioridade e os casos de sobreposição.

5. Defina o resultado padrão

Em Saídas do procedimento > Quando nenhuma regra corresponder, use o resultado Quer uma demonstração, com identificador qualificado.

O resultado padrão é usado quando a coleta aplicável foi concluída e nenhuma decisão configurada correspondeu. Ele não significa aprovação universal: seu nome e seu uso devem refletir o processo que você desenhou.

6. Salve e conecte ao agente

1. Marque Ativo e salve o procedimento.
2. No construtor do agente, adicione Apresentação e coleta.
3. Escolha um procedimento fixo e selecione Qualificação para demonstração.
4. Atualize ou revise as saídas do bloco.
5. Conecte Quer uma demonstração à próxima etapa desejada.
6. Conecte Sem interesse agora a uma mensagem/resultado apropriado; para devolver ao bot, use Retornar ao bot ou uma saída por regra configurada.

As saídas do procedimento são conectores internos do construtor. Para criar uma saída no fluxo de bot, o desenho também precisa de um bloco de retorno ao bot com uma chave própria.

Você pode editar o procedimento a partir do próprio construtor. O rodapé mostra os agentes vinculados; alterações no cadastro compartilhado afetam os próximos usos pelos agentes que o reutilizam. Confira os vínculos antes de salvar. Para uma variação independente, use Criar cópia.

Aproveite o que já veio do bot

Em uma pergunta, abra Aproveitar informações já conhecidas. Em Informação já conhecida, selecione a entrada correspondente, por exemplo vars.nome.

Se a informação estiver presente e for válida, a pergunta é dispensada. Para obter vars.nome a partir de uma variável do bot, configure o mapeamento no node Agente operacional.

Use Valor inicial opcional somente quando aquele valor já puder ser considerado uma resposta. Ele não funciona como sugestão visual para a pessoa.

Personalize sem duplicar o roteiro

Em Parâmetros e dados disponíveis, você pode declarar parâmetros e mostrar campos de uma lista para facilitar a escolha de variáveis. Exemplos:

Declare os parâmetros necessários e mapeie-os no bloco Apresentação e coleta. Os tipos devem corresponder: um limite numérico não deve vir de um texto como dez.

Teste antes de reutilizar

Confira pelo menos:

• nome ausente e nome já recebido do bot;
• resposta Sim e resposta Não;
• resposta ambígua, pedindo esclarecimento;
• encerramento antecipado sem criar a oportunidade indevidamente;
• resultado padrão e próxima etapa correta;
• mesma estrutura com outro registro ou conjunto de parâmetros;
• pedido de atendimento humano durante a coleta.

Veja Testar o agente, Listas do CRM e a referência de Apresentação e coleta.