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 ou combine este node com outros nodes do mesmo fluxo para completar a jornada.