Última modificación: 28 de agosto de 2025
Utiliza la API de análisis de eventos para buscar eventos asociados con registros de CRM de cualquier tipo (solo Marketing Hub Enterprise, Sales Hub Enterprise, Service Hub Enterprise o CMS Hub Enterprise). Esto incluye eventos estándar, como visitas a páginas web y aperturas de correos electrónicos, además de eventos personalizados. Por ejemplo, usa esta API para ver una cronología de las interacciones que un contacto ha tenido con tu contenido. Luego puedes usar esta cronología para crear un conjunto de datos para analíticas personalizadas o presentar una cronología de contacto en una aplicación externa.

​
Consultar eventos individuales completados

Esta API devuelve eventos para un registro de CRM a la vez. Puedes seleccionar el registro especificando el objectType e incluir el parámetro de consulta objectId o objectProperty.

​
Seleccionar por ID de objeto

Para especificar un registro por su ID, agrega el parámetro de consulta objectId. Por ejemplo, para especificar un registro de contacto con el ID de 2832, deberías hacer la siguiente solicitud GET: /events/v3/events/?objectType=contact&objectId=224834

​
Seleccionar por propiedad de objeto

Para especificar un registro por una propiedad única en lugar de ID de contacto, agrega el parámetro objectProperty. Consulta la propiedad incluyendo el nombre de la propiedad y el valor en el siguiente formato: objectProperty.{propname}={propvalue} Por ejemplo, para especificar un contacto por su dirección de correo electrónico, deberías hacer la siguiente solicitud GET: /events/v3/events/?objectType=contact&objectProperty.email=user12@dev.com

​
Consulta y filtrado de tipos de eventos

Cuando buscas para los eventos asociados con un objeto de CRM determinado, la respuesta incluirá todos los tipos de eventos, incluidos eventos de comportamiento personalizados. Para devolver solo finalizaciones de eventos para un tipo de evento específico, puedes incluir un parámetro eventType, seguido del nombre del evento. Para obtener una lista de todos los tipos de eventos disponibles, puedes hacer una solicitud GET a /events/v3/events/event-types. La respuesta devolverá todos los tipos de eventos en tu cuenta. A continuación, puedes usar uno de estos nombres de eventos como parámetro de consulta en una solicitud GET al punto de terminación /events/v3/events. Por ejemplo: /events/v3/events/eventType={EVENT_NAME}&objectType=contact&objectId=224834