# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-10-30T16:33:31.630Z ## Página - Título: Listas do CRM - URL humana: https://agilize.app/docs/configuracao/crm-dados/listas-do-crm - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Organize registros e campos tipados, códigos de busca e referências para reutilizar dados em processos e agentes. ## Seções - Acesse e crie uma lista - Escolha os campos pelo tipo do dado - Use referências sem digitar identificadores - Exemplo: serviços com roteiros compartilhados - Edite os dados com agilidade - Identifique a linha antes da IA - Deixe a lista escolher o procedimento - Aplique funil, etapa e tags no lead ## Conteúdo da página # Listas do CRM Listas do CRM organizam dados operacionais em linhas e campos configuráveis. Você pode representar serviços, unidades, campanhas, solicitações ou qualquer outro catálogo do seu processo. A lista não obriga a usar um domínio específico nem exige um agente de IA. Quando usada com Agentes Avançados, ela permite variar contexto, regras e procedimento por registro sem copiar todo o agente. ## Acesse e crie uma lista Acesse :ScreenEntry{href="https://my.agilize.app/crm/lists" label="Configurar listas do CRM" path="Configurações > Configuração Básica > IA > Agentes Avançados > Listas do CRM"} e crie a lista. A entrada de menu depende da liberação do recurso para a conta. Dê um nome orientado ao processo, como `Serviços e roteiros`, e uma descrição curta. Dentro da lista, use **Campos** para definir a estrutura e **Novo registro** ou a criação inline para adicionar linhas. ![Lista do CRM com serviços e referência ao procedimento compartilhado](/docs/screenshots/agentes-avancados/listas-do-crm.png) ## Escolha os campos pelo tipo do dado | Tipo | Exemplos | | --- | --- | | Texto | Descrição, requisito, orientação ou código simples. | | Número | Limite, quantidade, valor ou pontuação. | | Sim ou não | Critério habilitado ou requisito obrigatório. | | Data / data e hora | Prazo ou início de uma condição. | | Escolha simples ou múltipla | Categoria, turno ou conjunto de alternativas. | | Códigos / palavras-chave | Apelidos e referências que identificam o registro. | | Referência | Ligação com outro cadastro, selecionada pelo picker. | Cada campo tem nome e identificador. O nome ajuda a pessoa a editar; o identificador é usado por regras e integrações. Mantenha-o estável depois de configurar fluxos que dependem dele. **Usar na busca** habilita o campo para localizar registros por texto/código. **Disponível ao agente** permite que seu valor componha o contexto do agente. São finalidades diferentes; um campo pode servir a uma delas ou às duas. ## Use referências sem digitar identificadores O tipo **Referência** pode apontar para: - funil e etapa de funil; - tags de lead, contato ou empresa; - procedimento de perguntas da IA; - usuário e equipe de distribuição; - origem e motivo de arquivamento de lead; - outra lista do CRM. O sistema define as fontes e os filtros aceitos. Para etapas, associe o campo de funil em **Filtrar pelo campo de funil**. Para várias tags, habilite **Permitir vários registros**. Um campo de referência não é um campo de palavra-chave. Use um campo textual ou de códigos separado para identificar a linha. ## Exemplo: serviços com roteiros compartilhados Crie estes campos: | Campo | Tipo e finalidade | | --- | --- | | Código | **Códigos / palavras-chave**, com busca habilitada para `DEMO` ou `DIAGNOSTICO`. | | Descrição | **Texto**, disponível ao agente, com apresentação específica do serviço. | | Procedimento | **Referência** a procedimento de perguntas da IA, indicando o roteiro da linha. | | Funil | **Referência** a funil, para definir o destino da oportunidade. | | Etapa | **Referência** a etapa, dependente do campo de funil. | | Tags | **Referência múltipla** a tags de lead, para classificar a oportunidade. | Cadastre duas linhas. Elas podem usar o mesmo procedimento com descrições e parâmetros diferentes. Quando a estrutura das perguntas for diferente, selecione outro procedimento na linha correspondente. ## Edite os dados com agilidade - Clique em uma célula para editar inline, inclusive referências e tags. - Use a linha de criação inline para incluir outro registro sem abrir um cadastro completo. - Expanda conteúdos longos quando precisar ler o detalhe. - Use busca, filtros, seleção de colunas e visões para reduzir a informação em tela. - Agrupe quando houver um campo apropriado e utilize a apresentação em quadro quando disponível para o agrupamento. - Arquive registros que não devem mais ser utilizados, em vez de manter códigos ativos obsoletos. A edição inline altera o registro; não confunda uma seleção visual da célula com um rascunho do agente. Observe o feedback de salvamento e corrija erros de validação antes de continuar. ## Identifique a linha antes da IA No bot, adicione [Carregar registro da lista](/docs/configuracao/referencias/nodes-fluxos-do-bot/carregar-registro-da-lista). Escolha a lista, o campo de códigos e o modo de identificação. Esse node busca de forma determinística e trata ausência, duplicidade e erro. No [Agente operacional](/docs/configuracao/referencias/nodes-fluxos-do-bot/agente-operacional), selecione a referência carregada como registro de contexto. A IA recebe os dados permitidos dessa linha; não precisa receber todas as linhas da lista. ## Deixe a lista escolher o procedimento No construtor do agente, adicione **Apresentação e coleta**, selecione a origem no registro da lista e escolha o campo de procedimento. O registro precisa estar identificado antes da coleta. Os procedimentos possíveis devem ter parâmetros mapeados e resultados compatíveis com os conectores do bloco. Use o [guia de procedimentos](/docs/configuracao/inteligencia-artificial/agentes-avancados/cadastrar-procedimento) para montar o primeiro roteiro. ## Aplique funil, etapa e tags no lead Em **Criar entidade** ou **Alterar entidade**: 1. Selecione **Lead**. 2. Adicione os campos Funil, Etapa e Etiquetas necessários. 3. Em **Obter valor de**, escolha **Informação do contexto**. 4. Selecione os campos de referência do registro ativo pelo picker. 5. Revise se as tags devem substituir ou ser adicionadas às existentes. 6. Teste duas linhas com destinos diferentes. A lista fornece os valores. A alteração do CRM só acontece quando a capacidade correspondente executa. ## Cuidados ao escalar Use dados tipados para o que varia, mantenha códigos distintos e exponha somente os campos necessários ao agente. Um registro por processo não exige um agente por registro. Ao compartilhar roteiros, revise os agentes vinculados antes de mudar perguntas, parâmetros ou saídas. Teste código válido, desconhecido e duplicado, registro arquivado, procedimento desativado e referência de etapa incompatível com o funil.