Par exemple, vous souhaitez mieux segmenter vos contacts en fonction de leurs interactions avec votre entreprise et votre contenu. Pour cela, vous devez en savoir davantage sur eux. Votre application peut créer des événements personnalisés (contacts inscrits mais n'ayant pas assisté à un webinar récent, variante d'un flux de souscription complété par un contact, etc.) qui offrent davantage de contexte sur les interactions des contacts avec votre entreprise.
## Créer un modèle d'événement
Avant de commencer à créer des événements, vous devez créer un modèle d'événement. Les modèles d'événement décrivent les actions que votre application ajoutera à la chronologie d'un contact, d'une entreprise ou d'une transaction dans HubSpot. Ces actions comprennent la consultation d'une vidéo, l'inscription à un webinar ou encore la réponse à une enquête. Une seule application peut créer jusqu'à 750 modèles d'événement.
Les modèles d'événement sont créés pour les contacts par défaut, mais ils peuvent être créés pour des entreprises ou des transactions via le champ `objectType`. Consultez la création d'un modèle d'événement de chronologie pour plus de détails.
Chaque modèle d'événement possède ses propres jetons et modèles. Vous pouvez utiliser des événements créés pour les contacts comme critères lors de la création de nouvelles listes de contacts ou de workflows, comme : « Créer une liste de tous les contacts avec une mention J'aime pour une vidéo, où le nom de la vidéo contient XYZ, où votre modèle d'événement est intitulé « Mention J'aime pour la vidéo » et possède un jeton d'événement intitulé « nom de la vidéo »."
### Créer des modèles d'événement via l'API
Dans cet exemple, un nouveau modèle d'événement, « Exemple d'inscription au webinar », sera créé. Pour l'authentification, utilisez la clé d'API de développeur trouvée dans votre compte de développeur d'applications.
```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/<
Vous commencerez avec un brouillon de votre nouveau modèle d'événement. Une fois que vous avez défini le type d'objet ainsi que les modèles de détails et d'en-tête pour l'événement, cliquez sur **Créer**.
Lorsque vous créez ou modifiez votre modèle d'événement, définissez tous les jetons que vous souhaitez utiliser dans l'onglet *Données*.
Un clic sur Afficher les détails affiche le modèle de détails :
Pour définir l'icône affichée à côté des événements, consultez "[Configurer une icône personnalisée"](/docs/api-reference/crm-timeline-v3/guide#customicon) ci-dessous.
Le texte « Example App Name » ci-dessus est le nom de l'application. Dans la chronologie du CRM, les événements peuvent être filtrés par application.
### Définir tous les aspects d'un modèle d'événement dans un seul appel
Maintenant que vous avez vu chaque aspect d'un modèle d'événement, vous pouvez tous les définir dans un seul appel `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/<
### Définir l'horodatage d'événement
L'horodatage d'événement détermine où l'événement apparaîtra dans la chronologie de l'objet. Par défaut, l'horodatage d'événement correspond à l'envoi de la commande POST. Vous pouvez personnaliser l'heure de l'événement en la fournissant dans le corps de la demande dans une propriété d'horodatage :
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Un clic sur ce lien ouvrira une fenêtre modale qui affichera la page définie dans `url` :
### Horodater des données d'événement dans des propriétés d'objet de CRM
Dans de nombreux cas, vous souhaiterez modifier les propriétés des contacts, des entreprises ou des transactions auxquels vous ajoutez des événements. Cela se produit souvent dans les cas où l'ajout de l'événement crée un contact. Vous devrez probablement mettre à jour les propriétés de prénom et de nom pour le contact afin de ne pas créer de contact avec uniquement une adresse e-mail et un événement.
Vous pouvez horodater les données sur l'objet associé à partir d'un événement par mappage de jetons d'événement personnalisés pour les propriétés de contact, d'entreprise et de transaction.
Tenez compte de la commande `PUT` pour mettre à jour un modèle d'événement personnalisé ainsi que du champ `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/<
Remarque : si un jeton d'événement est horodaté pour une propriété personnalisée et que la propriété personnalisée n'est pas présente pour un compte HubSpot, la valeur sera toujours définie pour l'événement, mais elle sera ignorée pour l'objet correspondant.
### Comprendre `extraData`
Vous devrez peut-être ajouter des données détaillées à un événement qui ne correspondent pas à la structure jeton-valeur simple utilisée par les jetons de modèle d'événement. Vous devrez peut-être ajouter une liste ou une répartition hiérarchique à un événement d'intégration. C'est ici que `extraData` entre en jeu.
Vous pouvez ajouter un attribut `extraData` au corps JSON d'un événement. La valeur `extraData` peut être tout JSON valide. Par exemple :
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Remarque : L'attribut `extraData` ne peut être mentionné que dans le modèle de détails pour un événement. Il ne peut pas être utilisé dans le modèle d'en-tête ou dans la segmentation de liste.
### Configurer une icône personnalisée
Pour ajouter un attrait visuel à vos éléments de chronologie, vous souhaiterez ajouter une icône personnalisée.
Ce fichier d'image pour cette icône doit :
* Avoir une forme approximativement carrée
* Avoir un arrière-plan transparent
* Présenter son contenu au centre de l'icône
* Pouvoir être réduit jusqu'à 30 x 30 pixels
* Être égal ou inférieur à 5 Mo
Pour définir l'icône utilisée pour les événements de chronologie, accédez à Événements de chronologie. Cliquez sur l'image de l'espace réservé ou sur l'icône existante pour la définir ou la mettre à jour.
Une fois que vous avez défini une icône, celle-ci sera affichée à côté des événements de chronologie associés à cette application :
### Limites d'instances d'événements
Lors de la création d'un événement, chaque instance d'événement sérialisée est soumise aux limites de taille suivantes :
* 500 octets pour l'ID d'instance d'événement
* 510 Ko par propriété/jeton
* 1 Mo de taille totale pour l'instance d'événement
***
#### Documents associés
[Comprendre le CRM](/docs/guides/crm/understanding-the-crm)
[Cartes CRM](/docs/api-reference/crm-public-app-crm-cards-v3/guide)