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.