# 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-05-28T23:42:17.695Z ## Página - Título: Gerar Entidade - URL humana: https://agilize.app/docs/configuracao/referencias/nodes-webhooks/gerar-entidade - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Cria contato, empresa ou oportunidade usando dados do webhook. ## Seções - Quando usar - Impacto operacional - Entradas e saídas - Campos de configuração - Orientações do node - Boas práticas - Como validar - Próximos passos ## Conteúdo da página # Gerar Entidade Gerar Entidade é um node de webhook. Sua função principal é: cria contato, empresa ou oportunidade usando dados do webhook. Configure considerando o efeito operacional para clientes, equipe e dados da plataforma. ## Quando usar Use quando a automação precisa criar ou atualizar registros operacionais, como lead, contato, empresa, item de pipeline ou tarefa. ## Impacto operacional - Pode alterar oportunidade, funil, etapa, responsável ou status comercial. - Cria, busca ou atualiza entidades como lead, contato ou empresa. - Executa chamada externa ou webhook; tenha rota de contingência para erro ou timeout. - Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes. - Pode interromper o caminho quando a configuração ou condição não for atendida. ## Entradas e saídas Este node recebe 1 entrada e possui 1 saída. Quando houver mais de uma saída, nomeie os caminhos de forma clara para facilitar auditoria do fluxo. ## Campos de configuração | Campo | Como preencher | | --- | --- | | Tipo de Entidade | define qual registro de negócio será criado, atualizado, buscado ou salvo no contexto. | | Nome | define o nome, título ou valor principal usado pelo node. | | Verificar duplicidade por | controla a prevenção de duplicidade, geralmente por telefone ou e-mail. | | Modo de atribuição | define um responsável fixo ou vindo do contexto, quando a ação precisa ter dono operacional. | | Variável de destino da entidade no contexto | texto enviado, registrado ou usado como base da ação. Quando aceitar variáveis, valide se elas estarão preenchidas no momento da execução. | | Destino customizado | texto enviado, registrado ou usado como base da ação. Quando aceitar variáveis, valide se elas estarão preenchidas no momento da execução. | | Ignorar criação se já existir (duplicidade) ? | controla a prevenção de duplicidade, geralmente por telefone ou e-mail. | | Atribuir usuário também como criação/desenvolvimento (SDR)? | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. | | Tags | classifica o registro ou conversa para filtros, relatórios e regras futuras. | | Funil | escolhe o funil do CRM que receberá ou limitará a entidade. | | Etapa | define a etapa de destino no funil ou quadro selecionado. | | Origem | identifica a origem operacional do registro para relatórios e segmentação. | | Variável de usuário | texto enviado, registrado ou usado como base da ação. Quando aceitar variáveis, valide se elas estarão preenchidas no momento da execução. | | Responsável | define um responsável fixo ou vindo do contexto, quando a ação precisa ter dono operacional. | | Equipe | permite distribuir a ação entre membros de uma equipe, normalmente por rodízio ou regra equivalente. | | User Binding | define um responsável fixo ou vindo do contexto, quando a ação precisa ter dono operacional. | | Use Mapped User | define um responsável fixo ou vindo do contexto, quando a ação precisa ter dono operacional. | | Responsável ou equipe | define um responsável fixo ou vindo do contexto, quando a ação precisa ter dono operacional. | | Campos adicionais | lê ou grava valores no contexto para reaproveitamento em nodes posteriores. | ## Orientações do node O que faz - Cria entidades no CRM (contato, empresa ou oportunidade) a partir dos dados recebidos pelo webhook. - Suporta tags, responsável (usuário/equipe), funil/etapa/origem (para leads) e mapeamento de campos. Entradas configuráveis - Tipo de Entidade: contato, empresa ou oportunidade. - Nome: pode usar variáveis do payload/contexto. - Tags: lista de tags a associar. - Ignorar criação se já existir: evita duplicidade buscando por telefone ou e-mail. - Para oportunidade: funil, etapa e origem. - Responsável: escolha um modo entre usuário do contexto, usuário fixo, distribuição por equipe ou não atribuir; opção de marcar como criação/desenvolvimento (SDR). - Campos Adicionais: use o mapeador para preencher quaisquer campos (suporta variáveis). - O valor continua sendo exatamente a string/variável configurada em tela pelo usuário; o node não força origem automática. Saídas - Entidade criada: segue após criar a entidade. - Duplicidade encontrada: disponível quando a verificação encontra registro existente. Dicas - Utilize o nó de Debug para inspecionar o payload e facilitar o mapeamento de variáveis. - Se quiser valor literal, digite o texto; se quiser valor do evento, use a variável correspondente. - IDs criados podem ser reutilizados em nós posteriores. ## Boas práticas - Revise campos mínimos, origem, responsável e prevenção de duplicidade antes de ativar em produção. - Em webhooks, confirme se os campos do payload existem em todos os cenários do sistema de origem. ## Como validar - Configure o node em um fluxo de teste antes de publicar. - Execute com um registro, conversa ou payload controlado. - Confira se o caminho seguido, os dados criados e as mensagens enviadas correspondem ao resultado esperado. - Revise o histórico da entidade, conversa ou execução para confirmar o impacto real. ## Próximos passos Volte para a referência de [Nodes de webhooks](/docs/configuracao/referencias/nodes-webhooks) ou combine este node com outros nodes do mesmo fluxo para completar a jornada.