Skip to main content
GET
/
integrators
/
timeline
/
v3
/
events
/
{eventTemplateId}
/
{eventId}
Obtener una instancia de evento
curl --request GET \
  --url https://api.hubapi.com/integrators/timeline/v3/events/{eventTemplateId}/{eventId} \
  --header 'Authorization: Bearer <token>'
{
  "objectType": "contacts",
  "id": "petspot:1001298:[email protected]",
  "eventTemplateId": "1001298",
  "email": "[email protected]",
  "objectId": "28001",
  "timestamp": "2020-01-30T18:37:15.569Z",
  "tokens": {
    "petName": "Art3mis",
    "petColor": "black",
    "petAge": "3"
  },
  "extraData": {
    "questions": [
      {
        "question": "Who's a good girl?",
        "answer": "Bark!"
      },
      {
        "question": "Do you wanna go on a walk?",
        "answer": "Woof!"
      }
    ]
  },
  "timelineIFrame": {
    "linkLabel": "View Art3mis",
    "headerLabel": "Art3mis dog",
    "url": "https://my.petspot.com/pets/Art3mis",
    "width": 600,
    "height": 400
  }
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Starter

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
eventId
string
required

El ID del evento.

​
eventTemplateId
string
required

El ID de la plantilla de evento.

Response

successful operation

The current state of the timeline event.

​
eventTemplateId
string
required

El ID de la plantilla de evento.

​
id
string
required

Identificador del evento. Debe ser único para la aplicación y la plantilla del evento. Si utilizas el mismo ID para diferentes objetos del CRM, el último en ser procesado ganará y el primero no tendrá un registro. También puedes usar "{{uuid}}" en cualquier parte del ID para generar una cadena única, garantizando la unicidad.

​
objectType
string
required

El ObjectType asociado con el EventTemplate.

​
tokens
object
required

Una colección de claves de token y los valores asociados con los tokens de plantilla.

​
createdAt
string<date-time>

Unused.

​
domain
string

El dominio del evento (con frecuencia asociado con utk).

​
email
string

La dirección de correo utilizada para eventos específicos del contacto. Se puede usar para identificar contactos existentes, crear nuevos contactos o cambiar el correo de un contacto existente (si se combina con "objectId").

​
extraData
object

Datos adicionales específicos del evento que pueden ser interpretados por el markdown de la plantilla.

​
objectId
string

El identificador del objeto de CRM. Es obligatorio para todos los eventos excepto para los contactos (donde se puede usar utk o correo).

​
timelineIFrame
object
Example:
{
  "linkLabel": "View Art3mis",
  "headerLabel": "Art3mis dog",
  "url": "https://my.petspot.com/pets/Art3mis",
  "width": 600,
  "height": 400
}
​
timestamp
string<date-time>

La hora cuando ocurrió el evento. Si no se incluye, se usará la hora actual. Esto se utiliza para determinar dónde se muestra un evento en la cronología de un objeto del CRM.

​
utk
string

Usa el parámetro "utk" para asociar un evento con un contacto por "usertoken". Esto se recomienda si no conoces el correo de un usuario, pero tienes un token que identifica al usuario en tu cookie.