Passer au contenu principal
GET
/
integrators
/
timeline
/
v3
/
events
/
{eventTemplateId}
/
{eventId}
Obtenir une instance d'événement
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
  }
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
eventId
string
required

L'ID de l'événement.

​
eventTemplateId
string
required

L'ID du modèle d'événement.

Response

successful operation

The current state of the timeline event.

​
eventTemplateId
string
required

L'ID du modèle d'événement.

​
id
string
required

Identifiant pour l'événement. Celui-ci doit être unique à l'application et au modèle d'événement. Si vous utilisez le même ID pour différents objets CRM, le dernier à être traité l'emportera et le premier ne bénéficiera pas d'une fiche d'informations. Vous pouvez également utiliser {{uuid}} n'importe où dans l'ID pour générer une chaîne unique, garantissant l'unicité.

​
objectType
string
required

Le ObjectType associé au EventTemplate.

​
tokens
object
required

Une collection de clés de jetons et de valeurs associées aux jetons de modèle.

​
createdAt
string<date-time>

Non utilis

​
domain
string

Le domaine de l'événement (souvent associé à utk).

​
email
string

L'adresse e-mail utilisée pour des événements spécifiques aux contacts. Cela peut être utilisé pour identifier des contacts existants, en créer de nouveaux ou changer l'e-mail d'un contact existant (si associé à objectId).

​
extraData
object

Données supplémentaires spécifiques à l'événement pouvant être interprétées par le markdown du modèle.

​
objectId
string

L'identifiant de l'objet CRM. Cela est requis pour chaque événement autre que les contacts (où utk ou email peuvent être utilisés).

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

L'heure à laquelle l'événement s'est produit. Si non spécifiée, l'heure actuelle sera supposée. Cela est utilisé pour déterminer où un événement sera affiché sur la chronologie de l'objet CRM.

​
utk
string

Utilisez le paramètre utk pour associer un événement à un contact par usertoken. Ceci est recommandé si vous ne connaissez pas l'e-mail d'un utilisateur, mais que vous avez un jeton utilisateur identifiant dans vos cookies.