Carregar registro da lista
Use Carregar registro da lista para identificar um registro ativo a partir da mensagem recebida ou de uma variável do bot. É indicado quando muitos serviços, campanhas ou processos compartilham o fluxo, mas cada registro fornece seus próprios dados ou procedimento.
A busca é determinística e não usa IA para escolher o registro. Não é necessário criar uma saída do bot para cada linha da lista.
Onde configurar
Acesse Criar fluxo com carga de registro. No editor, adicione Carregar registro da lista no grupo Coleta de Dados.
Prepare a lista
- Crie um campo de código ou palavras-chave.
- Marque Usar na busca nesse campo.
- Cadastre os códigos em registros ativos.
- Evite códigos repetidos entre registros que possam ser encontrados pela mesma mensagem.
- Marque Disponível ao agente nos campos que a IA precisa usar depois.
Veja Listas do CRM para organizar campos e referências.
Campos do node
| Campo | Como usar |
|---|---|
| Lista do CRM | Fonte dos registros a identificar. |
| Campo com códigos ou palavras-chave | Campo da lista habilitado para busca. |
| Como identificar | Palavra/frase na mensagem ou valor completo igual ao código. |
| Origem da referência | Mensagem recebida ou variável do fluxo. |
| Variável de origem | Caminho selecionado no picker quando a origem é uma variável. |
| Guardar resultado em | Nome do resultado; padrão catalogRecord. |
O modo por palavra/frase procura correspondências dos termos configurados no conteúdo recebido; não interpreta significado por IA. O modo exato exige o valor completo normalizado, adequado para um código já extraído por uma etapa anterior. Não é um campo para cadastrar expressões regulares.
Entradas e saídas
Recebe uma entrada e possui quatro saídas:
| Saída | Significado e ação sugerida |
|---|---|
| Encontrado | Um único registro ativo correspondeu. Passe sua referência ao agente ou continue o bot. |
| Não encontrado | Nenhum registro correspondeu. Peça outro código ou apresente uma orientação. |
| Duplicado | Mais de um registro correspondeu. Esclareça a referência e revise códigos conflitantes. |
| Erro | A configuração ou a consulta impediu a identificação. Ofereça uma alternativa e revise lista, campo e origem. |
Resultado e uso pelo agente
Com o namespace padrão, o resultado fica em catalogRecord. Em sucesso, catalogRecord.record contém a referência à linha identificada.
No node Agente operacional, abra Registro de contexto · opcional e escolha esse resultado. O agente carrega os campos permitidos da linha e pode usar, por exemplo, sua descrição e referência a procedimento.
O registro da lista não é o lead. Ele representa o contexto do processo; criar ou atualizar oportunidade exige a capacidade ou node correspondente.
Exemplo
| Registro | Códigos e procedimento |
|---|---|
| Demonstração comercial | Códigos DEMO e CONHECER; procedimento Qualificação para demonstração. |
| Diagnóstico de operação | Código DIAGNOSTICO; procedimento Coleta para diagnóstico. |
Uma mensagem com DEMO identifica o primeiro registro. A mensagem com códigos dos dois registros deve seguir por Duplicado, sem escolher um deles arbitrariamente.
Desempenho e manutenção
O node usa as chaves de busca preparadas nos registros e restringe a consulta ao projeto, lista e registros ativos. Ele não envia toda a lista ao modelo. Mantenha os dados que variam em campos tipados, sem copiar um grande prompt para cada registro.
Como testar
Teste um código válido, desconhecido, repetido e um registro arquivado. Confira busca por mensagem e por variável, bem como o namespace recebido pelo agente. Conecte todas as saídas relevantes antes de ativar no canal.