> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create an event template > Las plantillas de eventos definen la estructura general de un evento de cronología personalizado y te permiten enviar datos de eventos a HubSpot. Una plantilla incluye una copia formateada para su encabezado y detalles, así como cualquier definición de propiedad personalizada. Una sola aplicación puede incluir hasta 750 plantillas de eventos.
las API de eventos de cronología `v1` y `v3` solo están disponibles para socios de aplicaciones con eventos de cronología `v1`/`v3` definidos en su aplicación pública. Si no eres un App Partner, puedes enviar datos de eventos personalizados a HubSpot utilizando la [API de eventos personalizados](/api-reference/events-manage-event-definitions-v3/guide). export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => { const translations = { header: "Productos compatibles", description: "Se requiere uno de los siguientes productos o productos de ediciones superiores.", productNames: { marketing: "Marketing Hub", sales: "Sales Hub", service: "Service Hub", cms: "Content Hub" }, tiers: { free: "Gratuito", starter: "Starter", professional: "Pro", enterprise: "Enterprise" } }; const translateTier = tier => { if (!tier) return ''; const lowerTier = tier.toLowerCase(); return translations.tiers[lowerTier] || tier; }; const products = [{ name: marketing ? translations.productNames.marketing : '', level: translateTier(marketingLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg", alt: "Marketing Hub" }, { name: sales ? translations.productNames.sales : '', level: translateTier(salesLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg", alt: "Sales Hub" }, { name: service ? translations.productNames.service : '', level: translateTier(serviceLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg", alt: "Service Hub" }, { name: cms ? translations.productNames.cms : '', level: translateTier(cmsLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg", alt: "Content Hub" }].filter(product => product.name && product.level); if (products.length === 0) return null; return
{translations.description}
{products.map((product, index) =>
{product.alt} {product.name} - {product.level}
)}
; }; ## OpenAPI ````yaml specs/legacy/v3/crm-timeline-v3.json POST /integrators/timeline/v3/{appId}/event-templates openapi: 3.0.1 info: title: Cronología description: Basepom for all HubSpot Projects version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Después de configurar un nuevo conjunto de flujos de registro en tu sitio web, actualiza las cronologías de contactos para indicar qué flujo completaron. En cada evento, también podrías incluir un enlace para abrir un iframe que muestre datos externos adicionales sobre el evento. x-hubspot-related-documentation: - name: Timeline Events Guide url: https://developers.hubspot.com/docs/guides/api/crm/extensions/timeline x-hubspot-introduction: >- Utiliza la API de eventos de cronología para agregar información de evento personalizada a las cronologías de registros del CRM. En primer lugar, deberás crear una aplicación pública, y luego una plantilla de evento para mostrar los datos del evento. servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch paths: /integrators/timeline/v3/{appId}/event-templates: post: tags: - Basic summary: Crear una plantilla de evento description: >- Las plantillas de eventos definen la estructura general de un evento de cronología personalizado y te permiten enviar datos de eventos a HubSpot. Una plantilla incluye una copia formateada para su encabezado y detalles, así como cualquier definición de propiedad personalizada. Una sola aplicación puede incluir hasta 750 plantillas de eventos.
las API de eventos de cronología `v1` y `v3` solo están disponibles para socios de aplicaciones con eventos de cronología `v1`/`v3` definidos en su aplicación pública. Si no eres un App Partner, puedes enviar datos de eventos personalizados a HubSpot utilizando la [API de eventos personalizados](/api-reference/events-manage-event-definitions-v3/guide). operationId: post-/integrators/timeline/v3/{appId}/event-templates_create parameters: - name: appId in: path description: '' required: true style: simple explode: false schema: type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/TimelineEventTemplateCreateRequest' required: true responses: '201': description: successful operation headers: Location: description: URL of the newly created resource style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/TimelineEventTemplate' default: $ref: '#/components/responses/Error' description: '' deprecated: true security: - oauth2: - developers-write components: schemas: TimelineEventTemplateCreateRequest: required: - name - objectType - tokens type: object properties: detailTemplate: type: string description: >- Esto utiliza la sintaxis Markdown con Handlebars y datos específicos del evento para renderizar HTML en una cronología cuando expandes los detalles. headerTemplate: type: string description: >- Esto utiliza la sintaxis Markdown con Handlebars y datos específicos del evento para renderizar HTML en una cronología como un encabezado. name: type: string description: El nombre de la plantilla. objectType: type: string description: >- El tipo de objeto del CRM para el que está diseñada esta plantilla. [Se admiten contactos, empresas, tickets y negocios]. tokens: type: array description: >- Una colección de tokens que se pueden utilizar como propiedades personalizadas en el evento y para crear objetos del CRM completos. items: $ref: '#/components/schemas/TimelineEventTemplateToken' TimelineEventTemplate: required: - id - name - objectType - tokens type: object properties: createdAt: type: string description: >- La fecha y hora en que se creó la plantilla de evento, como una marca de tiempo ISO 8601. Será nulo si la plantilla se creó antes del 18 de febrero de 2020. format: date-time detailTemplate: type: string description: >- Esto utiliza la sintaxis Markdown con Handlebars y datos específicos del evento para renderizar HTML en una cronología cuando expandes los detalles. headerTemplate: type: string description: >- Esto utiliza la sintaxis Markdown con Handlebars y datos específicos del evento para renderizar HTML en una cronología como un encabezado. id: type: string description: El ID de la plantilla. name: type: string description: El nombre de la plantilla. objectType: type: string description: >- El tipo de objeto del CRM para el que está diseñada esta plantilla. [Se admiten contactos, empresas, tickets y negocios]. tokens: type: array description: >- Una colección de tokens que se pueden utilizar como propiedades personalizadas en el evento y para crear objetos del CRM completos. items: $ref: '#/components/schemas/TimelineEventTemplateToken' updatedAt: type: string description: >- La fecha y hora en que se actualizó por última vez la plantilla de evento, como una marca de tiempo ISO 8601. Será nulo si la plantilla se creó antes del 18 de febrero de 2020. format: date-time TimelineEventTemplateToken: required: - label - name - options - type type: object properties: createdAt: type: string description: >- La fecha y hora en que se creó el token de plantilla de evento, como una marca de tiempo ISO 8601. Será nulo si la plantilla se creó antes del 18 de febrero de 2020. format: date-time label: type: string description: Se utiliza para segmentación de listas e informes. name: type: string description: >- El nombre del token referenciado en las plantillas. Debe ser único para la plantilla específica. Solo puede contener caracteres alfanuméricos, puntos, guiones o guiones bajos (. - _). objectPropertyName: type: string description: >- El nombre de la propiedad del objeto del CRM. Esto rellenará la propiedad del objeto del CRM asociada con el evento. Con una cantidad suficiente de estos nombres, puedes construir completamente objetos del CRM a través de la API de Cronología. options: type: array description: >- Si el tipo es "enumeración"; deberíamos tener una lista de opciones para elegir. items: $ref: '#/components/schemas/TimelineEventTemplateTokenOption' type: type: string description: >- El tipo de datos del token. Actualmente puedes elegir entre [cadena, número, fecha, enumeración]. enum: - date - enumeration - number - string updatedAt: type: string description: >- La fecha y hora en que se actualizó por última vez el token de plantilla de evento, como una marca de tiempo ISO 8601. Será nulo si la plantilla se creó antes del 18 de febrero de 2020. format: date-time Error: required: - category - correlationId - message type: object properties: category: type: string description: La categoría del error context: type: object additionalProperties: type: array items: type: string description: Contexto de la condición de error example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identificador único para la solicitud. Incluye este valor con cualquier informe de error o ticket de asistencia. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: información adicional acerca del error items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un mapa de nombres de enlaces a las URI asociadas que contienen documentación sobre el error o los pasos recomendados para solucionarlo message: type: string description: >- Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede example: An error occurred subCategory: type: string description: >- Una categoría específica que contiene detalles más concretos acerca del error example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base TimelineEventTemplateTokenOption: required: - label - value type: object properties: label: type: string description: La etiqueta de la opción que se muestra en el front-end. value: type: string description: >- El valor de la opción que se proporciona cuando se produce el evento. ErrorDetail: required: - message type: object properties: code: type: string description: El código de estado asociado al detalle del error context: type: object additionalProperties: type: array items: type: string description: Contexto de la condición de error example: '{missingScopes=[scope1, scope2]}' in: type: string description: El nombre del campo o parámetro en el que se encontró el error. message: type: string description: >- Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede subCategory: type: string description: >- Una categoría específica que contiene detalles más concretos acerca del error responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.companies.highly_sensitive.read.v2: '' crm.objects.companies.highly_sensitive.write.v2: '' crm.objects.companies.read: '' crm.objects.companies.sensitive.read.v2: '' crm.objects.companies.sensitive.write.v2: '' crm.objects.companies.write: '' crm.objects.contacts.highly_sensitive.read.v2: '' crm.objects.contacts.highly_sensitive.write.v2: '' crm.objects.contacts.read: '' crm.objects.contacts.sensitive.read.v2: '' crm.objects.contacts.sensitive.write.v2: '' crm.objects.contacts.write: '' crm.objects.deals.highly_sensitive.read.v2: '' crm.objects.deals.highly_sensitive.write.v2: '' crm.objects.deals.read: '' crm.objects.deals.sensitive.read.v2: '' crm.objects.deals.sensitive.write.v2: '' crm.objects.deals.write: '' crm.schemas.companies.read: '' crm.schemas.companies.write: '' crm.schemas.contacts.read: '' crm.schemas.contacts.write: '' crm.schemas.deals.read: '' crm.schemas.deals.write: '' developers-read: '' developers-write: '' tickets: '' tickets.highly_sensitive.v2: '' tickets.sensitive.v2: '' timeline: '' timeline.read: '' timeline.write: '' ````