Por ejemplo, supongamos que deseas segmentar mejor a los contactos según las interacciones con tu empresa y el contenido. Para hacer esto, necesitas más información sobre ellos. La aplicación puede crear eventos personalizados (por ejemplo, contactos que se registraron pero no asistieron a un webinario reciente, variantes de un flujo de registro que un contacto haya completado, etc.) para proporcionar mayor contexto sobre las interacciones de los contactos con la empresa.
## Creación de una plantilla de eventos
Antes de comenzar a crear eventos, debes crear una plantilla de evento. Las plantillas de evento describen las acciones que la aplicación agregará a la cronología de un objeto de contacto, empresa o negocio en HubSpot. Ejemplos de estas acciones incluyen ver un video, registrarse para un webinario o completar una encuesta. Una sola aplicación puede crear hasta 750 plantillas de evento.
Las plantillas de evento se crean para los contactos de forma predeterminada, pero pueden crearse para empresas o negocios usando el campo `objectType`. Puedes encontrar más información en la sección de la creación de una plantilla de evento de cronología.
Cada plantilla de evento tiene su propio conjunto de tokens y plantillas. Puedes usar eventos creados para contactos como criterio al crear listas o workflows para contactos nuevos, tales como 'Crear una lista de todos los contactos con un video similar cuyo nombre contenga las letras XYZ’, en el que la plantilla de video se denomina "Video similar" y tiene un token de evento denominado "Nombre del video"."
### Creación de plantillas de eventos a través de la API
Para este ejemplo, crearemos una nueva plantilla de evento llamada "Ejemplo de registro en webinario". Para la autenticación, usa la clave de API de desarrolladores que se encuentra en tu cuenta de desarrollador de aplicaciones.
```shell theme={null}
curl -X POST
-H "Content-Type: application/json" -d '
{
"name": "Example Webinar Registration",
"objectType": "contacts"
}' \
'https://api.hubapi.com/crm/v3/timeline/<
Comenzarás con un borrador de tu nueva plantilla de eventos. Una vez que hayas establecido el tipo de objeto y las plantillas de detalles y encabezado para el evento, haz clic en **Crear**.
Cuando creas o editas tu plantilla de eventos, establece los tokens que deseas usar con la plantilla en la pestaña *Datos*.
Al hacer clic en "Mostrar detalles", muestra la plantilla de detalles:
Para definir el ícono que se muestra junto a los eventos, consulta la "[Configuración de un ícono personalizado"](/api-reference/crm-timeline-v3/guide#customicon) abajo.
El texto anterior "Ejemplo de nombre de aplicación" es el nombre de la aplicación. En la cronología del CRM, los eventos se pueden filtrar por la aplicación.
### Definición de todos los aspectos de una plantilla de eventos en una única llamada
Ahora que has visto cómo se define progresivamente cada aspecto de una plantilla de eventos, puedes definirlo todo al mismo tiempo en una sola llamada `POST`.
```shell theme={null}
curl -X POST -H "Content-Type: application/json" -d '
{
"name": "Another Webinar Registration",
"objectType": "contacts",
"headerTemplate": "Registered for [{{webinarName}}](https://mywebinarsystem/webinar/{{webinarId}})",
"detailTemplate": "Registration occurred at {{#formatDate timestamp}}{{/formatDate}}",
"tokens": [
{
"name": "webinarName",
"label": "Webinar Name",
"type": "string"
},
{
"name": "webinarId",
"label": "Webinar Id",
"type": "string"
},
{
"name": "webinarType",
"label": "Webinar Type",
"type": "enumeration",
"options": [
{
"value": "regular",
"label": "Regular"
},
{
"value": "ama",
"label": "Ask me anything"
}
]
}
]
}' \
'https://api.hubapi.com/crm/v3/timeline/<
### Establecer la marca de tiempo del evento
La marca de tiempo del evento determina dónde aparecerá el evento en la cronología del objeto. Por opción predeterminada, la marca de tiempo del evento es cuando se envía el comando POST. Puedes personalizar la hora del evento proporcionándola en el cuerpo de la solicitud de una propiedad de marca de tiempo:
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Al hacer clic en ese enlace, se abrirá una ventana modal que muestra la página establecida en la `url`:
### Transferencia de los datos de eventos a las propiedades de objetos del CRM
En muchos casos, querrás modificar las propiedades de los contactos, empresas y negocios a los que estás agregando eventos. Esto suele suceder en casos cuando la creación del evento genera un nuevo contacto: probablemente quieras actualizar las propiedades de nombre y apellido para no terminar con un contacto que solo tenga una dirección de correo electrónico y un evento asociado.
Puedes transferir datos al objeto asociado desde un evento mediante la asignación de los tokens personalizados del evento a propiedades del contacto, empresa o negocio.
Considera usar el comando `PUT` para actualizar una plantilla de evento personalizada, ten en cuenta el campo `objectPropertyName`:
```shell theme={null}
curl -X PUT -H "Content-Type: application/json" -d '
{
"label" : "Updated Webinar Name",
"objectPropertyName": "zz_webinar_name"
}' \
'https://api.hubapi.com/crm/v3/timeline/<
Nota: si un token de evento se transfiere a una propiedad personalizada y esa propiedad personalizada no está presente en la cuenta de HubSpot, el valor seguirá para el evento, pero será ignorado para el objeto correspondiente.
### Comprender la `extraData`
Es posible que debas agregar datos detallados a un evento que no se adapta a la estructura de token-valor utilizada por los tokens de las plantilla de eventos. Es posible que debas agregar una lista o algunos desgloses jerárquicos a un evento de integración. Aquí es donde entra la `extraData`.
Puedes agregar un atributo `extraData` al cuerpo JSON de un evento. El valor de `extraData` puede ser cualquier JSON válido. Por ejemplo:
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Nota: solo se puede hacer referencia al atributo `extraData` en la plantilla de detalles de un evento. No se puede usar ni en la plantilla de encabezado ni en la segmentación de listas.
### Configurar un ícono personalizado
Para agregar un atractivo visual a la cronología, deberás agregar un ícono personalizado.
Este archivo de imagen para este ícono debe:
* Tener dimensiones aproximadamente cuadradas
* Tener un fondo transparente
* Tener el contenido en el centro del ícono
* Poderse reducir en tamaño hasta 30 x 30 píxeles
* Tener un tamaño de archivo de 5 MB o menos
Para establecer el ícono para los eventos de cronología, dirígete a la opción Eventos de la cronología. Haz clic en la imagen del marcador de posición o el ícono existente para configurarlo o actualizarlo.
Una vez que establezcas el o los íconos, se mostrarán junto a todos los eventos de la cronología asociados a esta aplicación:
### Límites de la instancia del evento
Al crear un evento, cada instancia de evento serializada está sujeta a los siguientes límites de tamaño:
* 500 bytes para el ID de la instancia del evento
* 510 KB por propiedad y token
* 1 MB de tamaño total para la instancia del evento
***
#### Documentos relacionados
[Comprender el CRM](/guides/crm/understanding-the-crm)
[Tarjetas del CRM](/api-reference/crm-public-app-crm-cards-v3/guide)