# 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:01.003Z

## Página

- Título: Gerar Entidade
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/gerar-entidade
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Cria ou atualiza contato, empresa ou oportunidade a partir da conversa.

## Seções

- Quando usar
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Boas práticas e riscos comuns
- Como testar
- Guias relacionados

## Conteúdo da página

# Gerar Entidade

Cria ou atualiza contato, empresa ou oportunidade a partir da conversa. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções.

## Quando usar

- Use quando o fluxo precisa alterar dados da conversa, consultar sistemas, criar registros ou expor informações ao operador.

## Campos de configuração

- **Tipo de Entidade**: contato, empresa ou oportunidade.
- **Nome**: pode usar variáveis da conversa.
- **Tags**: lista de tags a associar.
- **Para oportunidade**: funil, etapa, origem e temperatura.
- **Responsável**: usuário, equipe ou atribuir no momento da transferência.
- **Atribuir como criação/desenvolvimento (SDR)**: marca o usuário como criador/SDR quando definido.
- **Ignorar criação se já existir**: evita duplicidade buscando por telefone ou e-mail.
- **Não vincular a sala**: não grava o ID na sala atual.
- **Sobrescrever campos da entidade criada nesta sessão**: atualiza apenas registros criados pelo fluxo durante a sessão atual.
- **Permitir sobrescrever mesmo sem criação nesta sessão**: força a atualização da entidade já vinculada na sala e exige cuidado operacional.
- **Campos adicionais**: mapeamento de chaves/valores, com suporte a _phone e _email.

## Entradas e saídas

- Entradas: recebe 1 entrada.
- Saídas: possui 1 saída.
- 1 saída: segue o fluxo após a criação/atualização.

## Exemplo prático

Depois de coletar nome, telefone e interesse, crie uma oportunidade em um funil específico e vincule a conversa ao registro.

## Boas práticas e riscos comuns

- Tenha cuidado ao permitir sobrescrita de registros existentes.
- Defina critérios de duplicidade para evitar contatos, empresas ou oportunidades repetidas.
- Confirme funil, etapa, origem e responsável quando a entidade for uma oportunidade.
- O ID criado/atualizado fica disponível para uso em nós seguintes.
- Combine com condicionais para diferentes regras de distribuição.

## Como testar

- Use dados de teste para simular sucesso, falha e retorno vazio.
- Confira se variáveis, tags, registros ou integrações foram alterados corretamente.
- Valide o caminho seguido depois da execução.

## Guias relacionados

- [Nodes de fluxos do bot](/docs/configuracao/referencias/nodes-fluxos-do-bot)
- [Guia geral de fluxos do bot](/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot)
- [Fluxos do bot](/docs/configuracao/fluxos-automacoes/fluxos-do-bot)