# 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-09-04T17:55:01.913Z

## Página

- Título: Geração de Entidade no fluxo de voz
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-de-voz/geracao-de-entidade
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Crie ou atualize contato, empresa ou oportunidade a partir dos dados da chamada.

## Seções

- Quando usar
- Onde configurar
- Visão da configuração
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Boas práticas e cuidados
- Como testar

## Conteúdo da página

# Geração de Entidade no fluxo de voz

O node **Geração de Entidade** usa dados da chamada e das variáveis para criar ou atualizar um contato, uma empresa ou uma oportunidade no CRM. Para oportunidades, também permite definir funil, etapa, origem, temperatura e responsabilidade.

## Quando usar

- criar um contato identificado durante a chamada;
- registrar uma empresa ou oportunidade depois da qualificação;
- enviar ao CRM dados coletados ou retornados por integrações.

## Onde configurar

Acesse :ScreenEntry{href="https://my.agilize.app/voice/flow" label="Fluxos Avançados na plataforma"}. Pela interface, abra o módulo **Voz**, selecione **Configurações** e, na árvore **Telefonia e Voz**, escolha **Fluxos Avançados**.

Abra ou crie um fluxo. No editor, localize **Geração de Entidade** no grupo **Dados e integrações**, arraste o item para o canvas e abra sua configuração.

## Visão da configuração

![Configuração do node Geração de Entidade no fluxo de voz](/docs/screenshots/config-fluxo-voz-node-geracao-de-entidade.png)

## Campos de configuração

| Campo | Como usar |
| --- | --- |
| Entidade | Escolha Contato, Empresa ou Oportunidade. |
| Nome | Informe texto fixo ou variável que formará o nome do registro. |
| Tags | Selecione as tags que serão associadas. |
| Dados da oportunidade | Para Oportunidade, configure funil, etapa, origem e temperatura. |
| Responsável | Escolha um usuário ou uma equipe. Na execução de voz, são essas opções que definem a responsabilidade do registro. |
| Atribuir usuário na transferência | A opção aparece no formulário, mas não define o responsável por si só na execução atual do fluxo de voz. Prefira usuário ou equipe. |
| Atribuir como criação/desenvolvimento | Usa o usuário definido ou distribuído pela equipe como referência de criação ou desenvolvimento comercial. |
| Sobrescrever entidade criada nesta sessão | Permite atualizar o registro criado pelo próprio fluxo durante a chamada atual. |
| Permitir sobrescrever mesmo sem criação nesta sessão | Autoriza atualizar um registro existente e exige revisão cuidadosa. |
| Campos adicionais | Mapeie telefone, e-mail e campos extras com valores fixos ou variáveis. |

## Entradas e saídas

| Conexão | Comportamento |
| --- | --- |
| Entrada | Recebe a chamada do node anterior. |
| Saída única | Segue depois da criação ou atualização. |

## Exemplo prático

1. Colete nome e interesse e normalize o telefone da chamada.
2. Escolha **Oportunidade**, defina funil, etapa e responsável.
3. Mapeie nome, telefone e interesse nos campos correspondentes.
4. Use o registro criado no atendimento posterior.

## Boas práticas e cuidados

- A busca por telefone ajuda a evitar duplicidade.
- Para definir responsável no fluxo de voz, selecione um usuário ou uma equipe; não dependa apenas da opção de atribuição na transferência.
- Ative sobrescrita de registros existentes somente quando a regra de negócio autorizar.
- Confirme funil, etapa e responsabilidade antes de colocar o fluxo em produção.
- O identificador da entidade fica disponível em uma variável com o nome `lead`, `contact` ou `company`.

## Como testar

1. Use dados fictícios e confirme o registro criado no CRM.
2. Repita a chamada com o mesmo telefone e revise o comportamento de duplicidade.
3. Teste com e sem sobrescrita em um ambiente controlado.
4. Confirme tags, responsável e campos adicionais.

Faça os testes em uma chamada controlada antes de vincular ou publicar o fluxo em um número de produção.

## Guias relacionados

- [Nodes de fluxos de voz](/docs/configuracao/referencias/nodes-fluxos-de-voz)
- [Telefonia](/docs/configuracao/telefonia)
- [Vínculo do fluxo de telefonia no número de entrada](/docs/configuracao/telefonia/vinculo-fluxo-telefonia-numero-entrada)