Criar um evento de alteração de propriedade

Rastrear quando os valores do objeto forem alterados e usar os dados em listas, fluxos de trabalho e relatórios. Isso é útil para criar trilhas de auditoria, como verificações de registros de rastreamento.

Por exemplo, imagine que você mantém um CRM em que os contatos devem ser "verificados" antes de serem atribuídos ao departamento de vendas. Ao rastrear a is_verified propriedade, você pode capturar automaticamente quem verificou o registro e exatamente quando isso aconteceu sem entrada manual de dados.

Requisitos e limitações

Ao criar eventos de alteração de propriedade, os limites abaixo se aplicam:

• Você pode criar até 25 eventos de alteração de propriedade por conta.
• Propriedade eventos de alteração são contabilizados no limite total de ocorrência de eventos de 30 milhões por mês.
• Os eventos de alteração de propriedades não são recuperáveis depois de atingir o limite de 30M.

Criar um evento de alteração de propriedade

Um evento de alteração de propriedade pode ser criado por meio de configurações de Propriedade ou Eventos personalizados.

Configurações de propriedades

1. Na sua conta HubSpot, clique no ícone de settings icon na barra de navegação superior.
2. Na barra lateral esquerda, navegue até Propriedades.
3. Clique no menu suspenso Selecionar um objeto e selecione [Objeto] propriedades para controlar as alterações de uma propriedade para esse objeto.
4. No canto superior esquerdo, use os menus suspensos para filtrar por grupo de propriedades (por exemplo, is_verified), tipo de campo ou qual usuário criou a propriedade. Ou digite o nome de uma propriedade na caixa de pesquisa para localizar uma propriedade específica.

5. Passe o mouse sobre uma propriedade e clique em Mais. Em seguida, selecione Controlar alterações.
   
   
6. Selecione um operador.
   • O operador determina quando a alteração do valor da propriedade deve ser controlada.
   • Por exemplo, se você selecionar a Buying Role propriedade do contato e escolher o operador é qualquer um de , poderá ver sempre que a propriedade foi atualizada para um valor específico. Selecionar é qualquer um dos usuários finais mostra todas as instâncias em que a propriedade foi definida como Usuário final.
7. Clique Criar evento.

Depois que o evento for criado, revise, edite e analise-o na ferramenta de eventos personalizados . A partir daí, acompanhe quantas vezes a propriedade foi atualizada para os valores escolhidos, juntamente com a data de cada ocorrência, o valor para o qual foi atualizada e o usuário que fez a alteração. Você também pode filtrar por intervalo de datas, por exemplo, ocorrências na última semana ou no último mês.

Eventos personalizados

1. Na sua conta HubSpot, clique em Mais e navegue até Gerenciamento de dados > Gerenciamento de eventos. Se a opção Mais não aparecer na sua conta, navegue diretamente para Gerenciamento de dados > Gerenciamento de eventos.
2. No canto superior direito, clique em Criar um evento e clique em Criar evento personalizado .
3. Selecione Rastrear alterações no objeto .
4. Clique em Próximo.
5. Clique nos menus suspensos para selecionar quais propriedades de Objeto e Objeto rastrear. Quando o valor da propriedade é alterado, ele gatilho o evento de alteração.

6. Selecione um operador.
   
   • O operador determina quando a alteração do valor da propriedade deve ser controlada.
   • Por exemplo, se você selecionar a Buying Role propriedade do contato e escolher o operador é qualquer um de , poderá ver sempre que a propriedade foi atualizada para um valor específico. Selecionar é qualquer um dos usuários finais mostra todas as instâncias em que a propriedade foi definida como Usuário final.
7. Clique em Próximo.
8. Insira o Nome e a Descrição do evento (opcional).
9. As propriedades de evento padrão serão criadas para o evento.

Caso de uso: implementação de evento de alteração de propriedade

Depois de criar um evento de alteração de propriedade para is_verified, você pode escolher entre um método sem código ou um método codificado personalizado para carimbar os detalhes do editor.

Método sem código

Depois de criar o evento:

1. Na sua conta HubSpot, clique em Mais e navegue até Gerenciamento de dados > Gerenciamento de eventos. Se a opção Mais não aparecer na sua conta, navegue diretamente para Gerenciamento de dados > Gerenciamento de eventos.
2. Passe o mouse sobre o evento. Clique em Ações e selecione Usar em. No menu suspenso, selecione Relatórios. O HubSpot captura automaticamente:
   • Carimbo de data/hora: quando o valor mudou
   • Iniciador: o usuário ou integração específica que fez a alteração.

Método codificado personalizado

Se você precisar armazenar o nome do editor diretamente no registro do Contato para uso em integrações externas, use uma ação codificada personalizada em um fluxo de trabalho.

1. Converter sua propriedade de data/hora: as propriedades de data padrão do HubSpot suportam apenas data/hora meia-noite. Para oferecer suporte a minutos/segundos precisos, atualize sua verified_at propriedade por meio da API:

2. Usar o código do Fluxo de trabalho: Inscrever-se contatos quando is_verified for modificado. Use este script para buscar o updatedByUserId histórico da propriedade e marcar o verified_by_owner_id.

Usar dados de eventos de alteração de propriedades

As propriedades padrão geradas após a criação de um evento de alteração de propriedade podem ser usadas em listas, fluxos de trabalho e relatórios. 

1. Na sua conta HubSpot, clique em Mais e navegue até Gerenciamento de dados > Gerenciamento de eventos. Se a opção Mais não aparecer na sua conta, navegue diretamente para Gerenciamento de dados > Gerenciamento de eventos.
2. Passe o mouse sobre o evento e clique em Ações. Em seguida, selecione Usar em. Nas opções, selecione a ferramenta na qual deseja usar os dados do evento.

3. Você será redirecionado para a ferramenta selecionada, onde poderá configurar a configuração.