Ir a contenido principal
Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado. La versión en inglés se considera, por tanto, la versión oficial y es posible que haya sido actualizada. Para acceder a la versión en inglés, haz clic aquí.

Crear eventos personalizados

Última actualización: febrero 6, 2025

Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise

Los eventos personalizados permiten definir y monitorizar eventos únicos para tu empresa. Los eventos personalizados pueden relacionarse con propiedades de evento, que puedes usar en las herramientas de HubSpot. 

Existen diferentes maneras de crear eventos personalizados: 

  • Enviar a través de la API: utiliza el punto de terminación de definición de eventos personalizado para crear tu evento. A partir de ahí, utiliza tu ID de evento con el enlace enviar punto de terminación de evento personalizado para enviar las finalizaciones de eventos a HubSpot.
  • Captura datos de tu sitio web sin la API:
    • Código Javascript: mediante Javascript personalizado, puedes insertar código personalizado en tu script de seguimiento de HubSpot utilizando el editor de código.
    • Utilizar el visualizador de eventos (solo Marketing Hub Enterprise): haz seguimiento de las visitas a la página o de los elementos en los que se ha hecho clic seleccionándolos en tu sitio web. Más información sobre la creación de eventos personalizado con el visualizador de eventos.
  • Importar hoja de cálculo: sube una hoja de cálculo de datos de eventos para capturar actividad offline, rellenar datos o integrar manualmente cualquier herramienta con HubSpot.
  • Configurar webhooks (Operations Hub Pro y Enterprise solamente): personaliza las condiciones que desencadenan un webhook y los datos que se enviarán. 

 

Nota: la herramienta de eventos personalizados reemplaza la herramienta de eventos anterior. Cualquier evento creado en la herramienta preexistente seguirá funcionando, y aún puedes administrar y analizar esos eventos en la herramienta preexistente

El proceso de creación de eventos implica dos partes:

  • Definir el evento en HubSpot, incluyendo cualquier propiedad de evento personalizada.
  • Crear un fragmento de código de Javascript o definir la llamada a la API que desencadenará el evento. 

Crear evento mediante API

Si envías datos a HubSpot a través de la API, tendrás que utilizar la opción Enviar a través de la API o el punto de terminación de definición de evento personalizado para crear tu evento. Más información sobre cómo definir tu llamada a la API en Documentación para desarrolladores de HubSpot.

Necesitarás algunos datos para tu llamada de API, que puedes obtener desde HubSpot:

  • Nombre del evento: el nombre interno del evento. 
  • Nombre de la propiedad: los nombres internos de las propiedades que enviarás datos.

Para finalizar la creación de tu evento para enviar datos a través de la API:

  • Selecciona Enviar datos a HubSpot y copia el ID de seguimiento.
  • Haz clic en Crear.

Para encontrar el nombre interno de un evento existente y los nombre de propiedad:

  • En tu cuenta de HubSpot, dirígete a Gestión de datos > Eventos personalizados.
  • Haz clic en Eventos personalizados.
  • Haz clic en el nombre del evento. Se te dirigirá a la página de detalles del evento.
  • En la parte superior, ubica el nombre del evento en Nombre interno.

  • Para encontrar los nombres internos de las propiedades que actualizarás, haz clic en el nombre de una propiedad.
  • En el panel derecho, haz clic en el icono de código y luego ve el nombre en Nombre interno.
Nota:
Cuando envíes datos a tu evento, se aplicarán los límites indicados a continuación:
  • Los nombres de propiedad están limitados a 50 caracteres. 
  • Las propiedades de URL y referencia pueden recibir hasta 1024 caracteres, mientras que todas las demás propiedades pueden recibir hasta 256 caracteres.
  • Cada finalización de evento puede contener datos de hasta 50 propiedades.
  • Los nombres internos de las propiedades deben empezar por una letra y contener sólo letras minúsculas de la a a la z, números del 0 al 9 y guiones bajos. Las propiedades con el mismo nombre interno después de las minúsculas se consideran duplicadas, y sólo se utilizará una de las propiedades al finalizar.
Si se superan estos límites al realizar una solicitud de API HTTP, la solicitud fallará. Si se superan estos límites al realizar una solicitud de la API JS, HubSpot truncará cualquier valor de nombre de propiedad a la longitud permitida y/o actualizará solo 50 propiedades por finalización de evento.

Crea eventos con un fragmento de código de Javascript

  • En tu cuenta de HubSpot, dirígete a Gestión de datos > Eventos personalizados.
  • En la parte superior derecha, haz clic en Crear un evento.
  • Selecciona Código de Javascript.
 
  • Haz clic en Siguiente.
  • Introduce un Nombre de evento y, opcionalmente, proporciona la descripción de tu evento.
  • Selecciona un Objeto asociado. Esto te permite asociar las finalizaciones de tus eventos a diferentes objetos de HubSpot, como Contactos, Empresas, Negocios y Tickets


  • Haz clic en Siguiente.

Agregar propiedades

Cuando se cree un evento, estarán disponibles las propiedades del evento predeterminadas. También puedes crear tus propias propiedades personalizadas. Las propiedades de eventos se almacenan por separado de otras propiedades de CRM y son únicas para el evento (es decir, no puedes editar estas propiedades desde la configuración de tu cuenta). 

  • Para desactivar la creación de propiedades del evento predeterminadas, desactiva la opción Propiedades del evento predeterminadas.
  • Para crear propiedades personalizadas, selecciona el tipo de propiedad haciendo clic en el Tipo de campo de tu propiedad. Las opciones incluyen: 
    • Propiedad de cadena personalizada: crea una propiedad que sea una cadena de texto sin formato. 
    • Propiedad de número personalizada: crea una propiedad que sea un valor de número.
    • Propiedad de marca de tiempo personalizada: crea una propiedad que sea un valor de fecha. Debes enviar tus datos en forma de milisegundos epoch o ISO8601. 
    • Propiedad de enumeración personalizada: crea una propiedad con un conjunto de valores predefinidos.

    • Cuando hayas seleccionado tu propiedad, configúrala en el panel derecho:

    • Introduce un nombre y una Descripción para la propiedad.
    • Para Propiedades de enumeración, haz clic en Siguiente e introduce las Etiquetas y los Valores para tu propiedad.
      • Las propiedades de enumeración pueden ser de selección única o múltiple. Para activar los valores de selección múltiple, activa el conmutador Admite varios valores.

      • Debes configurar tus valores y etiquetas antes de enviarles datos. Si no se completa este paso antes de enviar los datos que no están en la lista, no se podrán utilizar. Para enviar varios valores a través de la API, sepáralos con punto y coma.
Nota: no es posible importar propiedades de enumeración de selección múltiple.
    • Haz clic en Listo.
  • Haz clic en Siguiente.
  • Tras configurar el evento y sus propiedades, puedes agregar este evento al código de seguimiento de tu sitio web seleccionando el fragmento de código de Javascript.

Crear eventos con un fragmento de código Javascript te permite agregar Javascript a tu código de seguimiento de HubSpot automáticamente. Puede utilizarse para capturar datos de eventos más complejos que el código de seguimiento no captura por opción predeterminada. 

  • Selecciona Fragmento de código de JavaScript. Utiliza el fragmento en el panel derecho para hacer un seguimiento del evento en HubSpot. Cualquier propiedad personalizada que se cree estará predefinida dentro del fragmento de código. 
  • Modifica el fragmento según necesites introduciendo texto en el panel derecho. Cualquier código que agregues se incluirá automáticamente como parte del código de seguimiento de HubSpot.
  • Cuando hayas terminado, haz clic en Crear para finalizar tu evento e iniciar automáticamente el seguimiento. 

Importar datos de eventos

Sube tus datos de asistencia de eventos presenciales, datos con fecha y hora procedentes de aplicaciones que no integras con HubSpot, datos de campañas o leads puntuales de un proveedor, o cualquier otro dato de eventos en forma de hoja de cálculo. Los eventos te permiten capturar comportamientos y luego utilizarlos en HubSpot. 

Las importaciones pueden crear y actualizar registros de contactos. Las importaciones de eventos solo pueden utilizarse para eventos que ya hayan ocurrido. En un archivo de importación de eventos personalizado debe incluirse lo siguiente:

Archivo de ejemplo

Para importar eventos personalizados:

  • En tu cuenta de HubSpot, dirígete a Gestión de datos > Eventos personalizados.
  • En la parte superior derecha, haz clic en Crear un evento.
  • Selecciona Importar hoja de cálculo.

  • Haz clic en Siguiente.
  • Introduce un Nombre de evento y, opcionalmente, proporciona la descripción de tu evento.
  • Selecciona un Objeto asociado. En este momento, los eventos creados mediante importación solo pueden asociarse a contactos.

  • Asigna columnas a propiedades del evento y del contacto, y luego haz clic en Siguiente.
  • Confirma el nombre de tu archivo de importación.
  • Haz clic en la casilla de verificación para confirmar que esos contactos esperan saber de ti y que el archivo de importación no es una lista comprada. Consulta más información sobre la política de uso aceptable de HubSpot.
  • Selecciona el formato de fecha de la propiedad Ocurrió en.
  • Haz clic en Finalizar importación.

Configurar webhooks

Establece las condiciones que desencadenarán un webhook.

  • En tu cuenta de HubSpot, dirígete a Gestión de datos > Eventos personalizados.
  • En la parte superior derecha, haz clic en Crear un evento.
  • Selecciona Configurar webhooks.
  • Haz clic en Siguiente.
  • Introduce un Nombre del evento y selecciona un Objeto asociado.



  • Haz clic en Siguiente.
  • Configura un evento de prueba:
    • Copia la URL del webhook
    • Navega a la página de configuración del webhook en la aplicación de terceros con la que quieras integrarte.
    • Pega la URL copiada.
    • Haz clic en Enviar un evento de prueba.
  • Haz clic en Siguiente.
  • Revisa las propiedades de tu webhook. Haz clic en el menú desplegable Tipo de propiedad para seleccionar un tipo de propiedad. 
  • Haz clic en Siguiente.
  • Selecciona una propiedad de tu webhook de terceros que coincida exactamente con una propiedad de objeto de HubSpot. 

Utilizar datos de eventos personalizados

Los datos de eventos personalizados se pueden ver y usar en las herramientas de HubSpot. A continuación, descubre dónde ver las finalizaciones de eventos y las maneras en que puedes incorporar esa información a otras herramientas.

Puedes abrir tus eventos seleccionados directamente en determinadas herramientas de HubSpot con el menú desplegable de acciones de tu lista de eventos, la vista de eventos individuales o la esquina superior derecha de los gráficos de la pestaña Analizar.

Informar sobre eventos personalizados

Los eventos completados pueden ser analizados desde la herramienta de eventos personalizados y también estarán disponibles los datos de eventos en el generador de informes personalizados y los informes de atribución.

Más información sobre cómoanalizar los eventos personalizados.

Ver las finalizaciones de eventos en la cronología del contacto

Los eventos completados aparecerán en la cronología del registro de contacto, junto con cualquier propiedad que se haya cargado.

Para ver los detalles del evento en la cronología del contacto:

  • Navega a un registro de contacto que completó un evento personalizado.
  • Para filtrar la cronología de un contacto por eventos completados, haz clic en Filtrar actividad y luego selecciona Evento de personalizado.
  • En la cronología del contacto, haz clic para expandir el evento para mostrar los detalles del evento.

Utilizar eventos personalizados en workflows

En un workflow, puedes retrasar según los eventos personalizados finalizados usando una acción Retrasar hasta que ocurra el evento o un desencadenante de inscripción de evento.

  • En tu cuenta de HubSpot, dirígete a Automatizaciones > Workflows.
  • Haz clic en el nombre de un workflow. O, descubre cómo crear un nuevo workflow.
  • Para agregar un desencadenante:
    • En el editor del workflow, haz clic en Configurar activadores.
    • En el panel izquierdo, selecciona Cuando se produce un evento. Configura los activadores y luego haz clic en Aplicar filtro.
    • Para refinar aún más tu desencadenante, haz clic en Agregar filtros de refinamiento. Puedes seleccionar propiedades adicionales para refinar los objetos que te gustaría inscribir en el workflow.
    • Por opción predeterminada, los registros solo se inscribirán en un workflow la primera vez que cumplen con los activadores de inscripción. Para habilitar la reinscripción, en la sección ¿Debe reinscribirse [objeto] en este workflow? , selecciona Sí, reinscribir cada vez que se produce el desencadenante.
  • Para agregar un retraso:
    • En el editor de workflows, haz clic en el icono + más para agregar una acción de workflow.
    • En el panel derecho, selecciona Retrasar hasta que ocurra el evento.
    • Configura el retraso:
      • Haz clic en el menú desplegable Evento y luego selecciona un evento personalizado.
      • Luego, selecciona la propiedad del evento que deseas retrasar.
      • Selecciona el filtro para la propiedad del evento.
      • Haz clic en Aplicar Filtro.
      • Selecciona la hora de espera máxima o selecciona la casilla de comprobación Retraso en la medida de lo posible.
  • Haz clic en Guardar.

Nota: todos los desencadenantes de inscripción de eventos se separarán utilizando el operador O. Esto significa que solo debe producirse uno de los desencadenantes de inscripción de eventos para que el registro se inscriba en el workflow.

El workflow se retrasará de los registros inscritos hasta que cumplan con los criterios de eventos personalizados especificados o se desencadenarán cuando ocurra el evento.

¿Te resultó útil este artículo?
Este formulario se utiliza solo para recibir comentarios a la documentación. Cómo recibir ayuda con HubSpot.