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 configurações 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. Uma vez selecionadas as propriedades e o operador, você receberá informações sobre a frequência de atualização das propriedades todos os meses. Todos os eventos de alteração de propriedades contam para os limites mensais de ocorrência de eventos.
7. Clique Criar evento.

Eventos personalizados

1. Em sua conta HubSpot, acesse 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. Uma vez selecionadas as propriedades e o operador, você receberá informações sobre a frequência de atualização das propriedades todos os meses. Todos os eventos de alteração de propriedades contam para os limites mensais de ocorrência de eventos.
7. Clique em Próximo.
8. Informe um nome de Evento e Descrição (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. Em sua conta HubSpot, acesse 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. Em sua conta HubSpot, acesse 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.