- Central de conhecimento
- Automação
- Fluxos de trabalho
- Direcione e use dados CRM registro em ações fluxo de trabalho no Agent Hub
Direcione e use dados CRM registro em ações fluxo de trabalho no Agent Hub
Ultima atualização: 16 de setembro de 2026
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
-
Marketing Hub Professional, Enterprise
-
Sales Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional, Enterprise
-
Smart CRM Professional, Enterprise
-
Revenue Hub Professional, Enterprise
Ao criar fluxos de trabalho no Agent Hub, use as ações Localizar um registro, Encontrar muitos registros, Localizar um registro associado e Localizar muitos registros associados para direcionar os registros do CRM em seu fluxo de trabalho. Por exemplo, se você configurou um fluxo de trabalho em que o gatilho não está associado a nenhum registro, ou se deseja direcionar ou usar dados de um registro associado totalmente diferente.
Permissões necessárias É necessário ter permissões de Superadministrador ou de Fluxos de trabalho para usar a ferramenta de fluxos de trabalho.
Use outros tipos de registro com ações de fluxo de trabalho
Para usar um registro diferente com sua ação, adicione a ação Encontrar um registro antes da ação selecionada para localizar e identificar um registro específico. Por exemplo, se seu fluxo de trabalho for disparado por um evento de negócio, você pode fazer referência a uma empresa completamente diferente ou a um negócio associado com base nas propriedades do outro registro.
Você também pode usar a ação Localizar muitos registros para localizar vários registros. Por exemplo, você pode usar a ação para direcionar e identificar os cinco negócios mais envolvidos por Número de atividades de vendas. Em seguida, você pode usar a ação Editar registro para atualizar esses negócios para um pipeline de prioridade mais alta.
Observação: as ações Encontrar um registro e Encontrar muitos registros compartilham um limite de conta de 5 execuções por segundo. Além desse limite, as execuções extras serão repetidas e poderão causar atrasos.
Encontrar uma ação de registro
- Na sua conta HubSpot, navegue até Agentes > Agent Hub.
- Na parte superior, clique na guia Fluxos de trabalho .
- Clique no nome de um fluxo de trabalho existente criado no construtor do agente.
- No canto superior esquerdo ou no editor de fluxo de trabalho de ação, clique no ícone + adicionar.
- No painel esquerdo, procure e selecione a ação Localizar um registro. Em seguida, configure sua ação:
- Registro a ser localizado: o tipo de objeto a ser localizado, como uma empresa ou registro de registro de negócio.
- Localizar [object-type] onde: a propriedade usada para encontrar o registro correspondente. Se vários registros corresponderem aos critérios de identificação, será usado o registro correspondente mais antigo . Você pode se basear em:
- Se um registro tiver um valor de propriedade específico. Por exemplo, se um contato registro de empresa estiver associado a um marca específico na sua conta. Ou, se o endereço de e-mail no seu gatilho do Google Planilhas corresponder ao endereço de e-mail de um contato.
- Ou você pode corresponder as propriedades entre os dois registros. Por exemplo, se o propriedade de Empresa domínio do contato corresponder a um empresa propriedade de Domínio .
- Depois de configurar a ação Localizar um registro , saiba como usar o registro encontrado com outras ações.
Encontre muitos registros
- Na sua conta HubSpot, navegue até Agentes > Agent Hub.
- Na parte superior, clique na guia Fluxos de trabalho .
- Clique no nome de um fluxo de trabalho existente criado no construtor do agente.
- No canto superior esquerdo ou no editor de fluxo de trabalho de ação, clique no ícone + adicionar.
- No painel esquerdo, procure e selecione a ação Localizar um registro. Em seguida, configure sua ação:
- Registro a ser localizado: o tipo de objeto a ser localizado, como registros de empresa ou de negócio.
- Localizar [object-type] onde: os filtros usados para encontrar os registros correspondentes. Por exemplo, se os registros tiverem um valor de propriedade específico. Por exemplo, você pode querer filtrar por todos os registros em um determinado setor.
- Ordenar por: a propriedade pela qual classificar os registros ao determinar quais registros devem ser recuperados. Por exemplo, talvez você queira recuperar e classificar as 10 maiores empresas por receita.
- Limite de Registros: o número de registros a serem recuperados. Ao usar a ação Localizar muitos registros , isso é limitado a 100 registros.
- Depois de configurar a ação Localizar muitos registros , saiba como usar os registros encontrados com outras ações.
Usar registros associados com ações de fluxo de trabalho
Use a ação Localizar um registro associado ou Encontre muitos registros associados para localizar e usar outros registros associados. Você pode usar esta ação para encontrar registros associados com o registro inscrito ou com outros registros localizados a partir da ação Localizar um registro .
Localizar um registro associado
- Na sua conta HubSpot, navegue até Agentes > Agent Hub.
- Na parte superior, clique na guia Fluxos de trabalho .
- Clique no nome de um fluxo de trabalho existente criado no construtor do agente.
- No canto superior esquerdo ou no editor de fluxo de trabalho de ação, procure e selecione o ícone + adicionar.
- No painel esquerdo, clique na ação Encontrar um registro associado. Em seguida, configure sua ação:
- De: a origem da associação. Por exemplo, você pode selecionar o registro inscrito, como o contato do gatilho ou qualquer registro localizado de uma ação anterior do Find one registro.
- Localizar associado: o tipo de objeto a ser localizado. Por exemplo, você pode identificar um negócio ou ticket associado.
- Filtrar por rótulo: filtre o objeto associado digitado por rótulo de associação. Saiba mais sobre CRM associação rótulos.
- Se vários registros corresponderem, escolha: selecione Associado mais recentemente ou Associado pela primeira vez.
- Depois de configurar a ação Encontrar um registro associado , saiba como usar o registro encontrado com outras ações.
Localizar muitos registros associados
- Na sua conta HubSpot, navegue até Agentes > Agent Hub.
- Na parte superior, clique na guia Fluxos de trabalho .
- Clique no nome de um fluxo de trabalho existente criado no construtor do agente.
- No canto superior esquerdo ou no editor de fluxo de trabalho de ação, clique no ícone + adicionar.
- No painel esquerdo, pesquise e selecione a ação Encontrar muitos registros associados . Em seguida, configure sua ação:
- De: a origem da associação. Por exemplo, você pode selecionar o registro inscrito, como o contato do gatilho ou qualquer registro localizado de uma ação anterior do Find one registro.
- Localizar associado: o tipo de objeto a ser localizado. Por exemplo, você pode identificar negócios ou tickets associados.
- Filtrar por rótulo: filtre o objeto associado digitado por rótulo de associação. Saiba mais sobre CRM associação rótulos.
- Se vários registros corresponderem, escolha: selecione Associado mais recentemente ou Associado pela primeira vez.
- Limite de Registros: o número de registros a serem recuperados. Ao usar a ação Localizar muitos registros associados , isso é limitado a 1.000 registros associados.
- Depois de configurar a ação Encontrar um registro associado , saiba como usar o registro encontrado com outras ações.
Usar saídas de ações de direcionamento
Você pode usar as saídas das ações Localizar um registro, Localizar muitos registros, Localizar um registro associado e Localizar muitos registros associados das seguintes maneiras:- Para direcionar os registros em uma ação: use o registro de uma ação quando como o registro de destino ao configurar uma nova ação.
- Por exemplo, em uma ação Adicionar ao segmento estático , você pode selecionar o registro ou registros no menu suspenso Registros para adicionar ao segmento . Ou, usando uma ação Editar registro , você pode atualizar todos os registros de destino com a mesma alteração de propriedade.
- Para usar seu registro, clique no primeiro menu suspenso e selecione seu registro .
- Usar variáveis de dados dos registros: use variáveis de dados da ação. Isso se aplica somente às ações registro Encontrar um registro e Encontrar um.
- Por exemplo, ao criar uma tarefa ou enviar uma notificação, você pode usar propriedades da ação Localizar um registro , como a descrição de uma empresa. Saiba mais sobre como usar variáveis de dados em ações.
- Você também pode fazer referência a variáveis de dados de outros tipos de objetos como tokens personalizados ao enviar e-mails automatizados ou webhooks.
Observação: ao usar a ação Enviar e-mail , você pode usar tokens de outros tipos de objetos da ação Localizar um registro ou Encontrar um registro associado . Por exemplo, use dados de registros de negócios ou tickets em seu e-mail automatizado. Se seu fluxo de trabalho for acionado por contatos e você estiver enviando e-mails automatizados para outros contatos associados, apenas os dados do contato inscrito preencherão os tokens de dados.