Buscar Entidade
Buscar Entidade é um node de webhook. Sua função principal é: busca uma entidade do CRM e a salva no contexto para uso em nós posteriores. 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.
- Lê ou grava variáveis de contexto que podem ser usadas pelos próximos nodes.
Entradas e saídas
Este node recebe 1 entrada e possui 2 saídas. 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. |
| Buscar por | campo de configuração do node. Preencha apenas quando ele for necessário para o comportamento desejado. |
| Valor de origem para busca | identifica a origem operacional do registro para relatórios e segmentação. |
| Campo adicional indexado | lê ou grava valores no contexto para reaproveitamento em nodes posteriores. |
| Variável de destino 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. |
| Funil | escolhe o funil do CRM que receberá ou limitará a entidade. |
Orientações do node
O que faz
- Busca uma entidade do CRM por telefone, e-mail, ID ou campo adicional indexado.
- Para oportunidades, pode restringir a busca a um funil específico.
- Quando encontra, salva a entidade no contexto.
- Quando não encontra, limpa o slot daquela entidade no contexto.
Entradas configuráveis
- Tipo de entidade.
- Critério de busca.
- Valor de origem para busca vindo do payload/contexto.
- Funil opcional quando a entidade for oportunidade.
- Campo adicional indexado, quando aplicável.
Saídas
- Entidade encontrada.
- Entidade não encontrada.
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.