Por exemplo, você deseja segmentar melhor seus contatos com base nas interações deles com sua empresa e conteúdo. Para fazer isso, você precisa de mais informações sobre eles. O aplicativo pode criar eventos personalizados (contatos que se registraram, mas não participaram de um webinar recente, qual variante de um fluxo de inscrição um contato concluiu, etc.) que forneçam mais contexto sobre as interações dos contatos com a empresa.
## Criar um modelo de evento
Antes de começar a criar eventos, crie um modelo de evento. Modelos de evento descrevem ações que seu aplicativo adicionará à linha do tempo de um contato, uma empresa ou um negócio no HubSpot. Exemplos dessas ações incluem a visualização de um vídeo, o registro para participar de um webinar ou a resposta a uma pesquisa. Um único aplicativo pode criar até 750 modelos de evento.
Por padrão, os modelos de evento são criados para contatos, mas podem ser criados para empresas ou negócios usando o campo `objectType`. Para obter mais informações, veja a criação de um modelo de evento de linha do tempo.
Cada modelo de evento tem seu próprio conjunto de tokens e modelos. Você pode usar eventos criados para contatos como critérios ao criar novas listas de contatos ou fluxos de trabalho, como: "Create a list of all contacts with a Video Like where the video name contains XYZ", onde o nome do modelo de evento é "Video Like" e tem um token de evento denominado "video name".
### Criar modelos de evento por meio da API
Para este exemplo, criaremos o novo modelo de evento “Exemplo de Registro no Webinar”. Para autenticação, use a chave de API do desenvolvedor encontrada na sua conta de desenvolvedor de apps.
```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/<
Você começará com um rascunho do novo modelo de evento. Depois de definir o tipo de objeto e os modelos de cabeçalho e de detalhes do evento, clique em **Criar**.
Ao criar ou editar seu modelo de evento, defina quaisquer tokens que deseje usar com ele na guia *Dados*.
Clicar em “Mostrar detalhes” exibe o modelo de detalhes:
Para definir o ícone que é exibido ao lado dos eventos, consulte "[Configurando um ícone personalizado"](/api-reference/crm-timeline-v3/guide#customicon) abaixo.
O texto “Exemplo de nome do aplicativo” acima consiste no nome do aplicativo. Na linha do tempo do CRM, os eventos podem ser filtrados por aplicativo.
### Definir todos os aspectos de um modelo de evento em uma única chamada
Agora que você viu que cada aspecto de um modelo de evento é definido progressivamente, poderá defini-lo em uma chamada do comando `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/<
### Definir o registro de data/hora do evento
O registro de data/hora do evento determina onde o evento aparecerá na linha do tempo do objeto. Por padrão, o registro de data/hora do evento consiste no momento em que o comando POST é enviado. Você pode personalizar o horário do evento fornecendo-o no corpo da solicitação em uma propriedade de registro e data/hora:
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Clicar nesse link abriria uma janela modal com a página definida no `url`:
### Marcar dados de evento nas propriedades do objeto do CRM
Em muitos casos, você vai querer modificar as propriedades dos contatos, das empresas ou dos negócios aos quais está adicionando eventos. Geralmente isso acontece nos casos em que a adição do evento criará, de fato, um contato. Você provavelmente desejará atualizar as propriedades de nome e sobrenome no contato para não criar um contato que tenha apenas um endereço de e-mail e um evento.
Você pode marcar dados no objeto associado a partir de um evento mapeando seus tokens de eventos personalizados para propriedades de contatos, empresa ou negócios.
Considere esse comando `PUT` para atualizar um modelo de evento personalizado. Observe o 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/<
Observação: se um token de evento estiver marcado para uma propriedade personalizada e essa propriedade personalizada não estiver presente para uma conta da HubSpot, o valor continuará definido para o evento, mas será ignorado para o objeto correspondente.
### Noções básicas sobre `extraData`
Talvez seja preciso adicionar dados detalhados a um evento que não se encaixa na estrutura simples de token-valor usada pelo modelo de evento. Pode ser necessário adicionar uma lista ou detalhamento hierárquico a um evento de integração. É aqui que entra o `extraData`.
Você pode adicionar um atributo `extraData` ao corpo JSON do evento. O valor desse `extraData` pode ser qualquer JSON válido. Por exemplo:
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
Observação: o atributo `extraData` só pode ser referenciado no modelo de detalhes de um evento. Ele não pode ser usado no modelo de cabeçalho nem na segmentação de lista.
### Configurar um ícone personalizado
Para criar um apelo visual a seus itens de linha do tempo, você pode adicionar um ícone personalizado.
Este arquivo de imagem desse ícone deve:
* Ter dimensões quadradas
* Ter um fundo transparente
* Ter o conteúdo no centro do ícone
* Poder ser reduzido para até 30 x 30 pixels
* Ter um tamanho máximo de arquivo de 5 MB
Para definir o ícone usado para eventos de linha do tempo, vá para Eventos da linha do tempo. Clique na imagem do espaço reservado ou no ícone existente para definir ou atualizar.
Depois que os ícones forem definidos, eles aparecerão ao lado de todos os eventos de linha do tempo associados a este aplicativo:
### Limites de instâncias de eventos
Ao criar um evento, cada instância de evento serializada está sujeita aos seguintes limites de tamanho:
* 500 bytes para o ID da instância do evento
* 510 KB por propriedade/token
* 1 MB de tamanho total para a instância do evento
***
#### Documentos relacionados
[Noções básicas do CRM](/guides/crm/understanding-the-crm)
[Cartões de CRM](/api-reference/crm-public-app-crm-cards-v3/guide)