# 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:43:48.069Z

## Página

- Título: Gerar Entidade
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-automacao-crm/gerar-entidade
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Cria ou atualiza contato, empresa ou oportunidade no CRM.

## 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 automação de CRM. Sua função principal é: cria ou atualiza contato, empresa ou oportunidade no CRM. 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.

## 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. |
| Temperatura | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |
| 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. |
| Origem | identifica a origem operacional do registro para relatórios e segmentação. |
| Equipe | permite distribuir a ação entre membros de uma equipe, normalmente por rodízio ou regra equivalente. |
| Responsável | define um responsável fixo ou vindo do contexto, quando a ação precisa ter dono operacional. |
| Funnel/Stage/Source | escolhe o funil do CRM que receberá ou limitará a entidade. |
| Owner/Team | 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
- Gera (ou atualiza) uma entidade do CRM a partir dos dados atuais.
- Permite definir tags, responsável (usuário/equipe), funil/etapa/origem (para leads), temperatura e campos adicionais.

Entradas configuráveis
- Tipo de Entidade: contato, empresa ou oportunidade.
- Nome: pode usar variáveis; padrão depende da origem.
- Tags: lista de tags a associar.
- Ignorar criação se já existir: evita duplicidade buscando por telefone ou e-mail.
- Funil, Etapa, Origem e Temperatura (apenas para oportunidade).
- Responsável: usuário, equipe ou marcar na transferência.
- Atribuir usuário também como criação/desenvolvimento (SDR): marcação adicional quando houver responsável.

Saídas
- 1 saída: segue após criar/atualizar a entidade.

Dicas
- O ID gerado poderá ser usado por outros nós do fluxo.

## Boas práticas

- Revise campos mínimos, origem, responsável e prevenção de duplicidade antes de ativar em produção.

## 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 automação de CRM](/docs/configuracao/referencias/nodes-automacao-crm) ou combine este node com outros nodes do mesmo fluxo para completar a jornada.