# Introducción

## Eventos

Utilizando custom triggers puedes enviar eventos asociados a tus contactos y utilizarlos para iniciar automations personalizados.

La estructura básica de un custom trigger es:

```json
{
  "trigger_key": "my_custom_event",
  "contact": "contact@domain.com",
  "context": {}
}
```

* **trigger\_key:** Es el identificador de tipo de evento, con el cual debes configurar los automations que quieres iniciar. Puede ser cualqueir cadena alfanuérica minúscula de hasta 30 caracteres, puedes incluir guin bajo también.
* **contact:** La dirección de email del contacto asociado. En caso que no exista en tu cuenta de Perfit, será creado.
* **context**: Datos adiciones para utilizar dentro del contenido del email. Ver ejemplo a continuación.

{% hint style="info" %}
El uso de los custom triggers está limitado a la recepción de **un máximo de** **200 eventos por hora.** Superado este volumen, la API responderá error 429 (too many requests) y los eventos serán descartados.
{% endhint %}

## Contexto

Adicionalmente, es posible incluir un contexto en el evento:

```json
{
  "trigger_key": "my_custom_event",
  "contact": "contact@domain.com",
  "context": {
    "key1": "value1",
    "key2": "value2"
  }
}
```

Esta información será incluida en el contexto del automation y podrá ser utilizada para personalizar el contenido y comportamiento.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.myperfit.com/custom-triggers/introduccion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.