Perfit Developers
  • Inicio
  • Contacts API
    • Introducción
    • Autenticación
    • Manejo de errores
    • Usos más frecuentes
      • Crear o actualizar un contacto en una lista
      • Modificar un contacto existente
      • Agregar un interés a un contacto
      • Desuscribir a un contacto
    • Referencia completa
  • Custom Triggers
    • Introducción
    • Activación y envío de eventos
    • Disparo de automations
    • Utilizando el contexto
  • Transactional API
    • Introducción
    • Envío usando HTTP
    • Autenticación
    • Límites y errores
    • Formatos
    • Java SDK
    • Ejemplos PHP y Node
    • Envío usando SMTP
  • Personalización
    • Contenidos dinámicos
    • Links especiales
    • Ejemplos
  • Monitoreo
    • Configuración
    • Webhooks de eventos
    • Listado de actividad
Con tecnología de GitBook
En esta página
  • Eventos
  • Contexto
  1. Custom Triggers

Introducción

Los Custom Triggers permiten disparar automations utilizando eventos enviados desde sistemas externos via API.

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:

{
  "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.

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.

Contexto

Adicionalmente, es posible incluir un contexto en el evento:

{
  "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.

AnteriorDesuscribir a un contactoSiguienteActivación y envío de eventos

Última actualización hace 1 año