Eventos de plantillas
Versiones de plantillas creadas, actualizadas, publicadas o eliminadas.
template.created
Se envía cuando se crea una versión de plantilla: con Crear una plantilla, al importar una plantilla en el panel o al guardar una campaña como plantilla. Una versión creada para un alias nuevo se publica de inmediato; comprueba published_at.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre template.created.
objectobjectLa versión de plantilla que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de plantilla
idstringEl ID de la versión de plantilla (tem_…).
objectstringSiempre template.
namestringEl nombre de la plantilla.
aliasstringEl alias que comparten todas las versiones de la plantilla.
fromstring | nullEl remitente por defecto.
subjectstring | nullEl asunto por defecto.
reply_tostring[] | nullLas direcciones de respuesta por defecto.
htmlstring | nullEl cuerpo HTML.
textstring | nullEl cuerpo en texto plano.
editorstringhtml, text, dragit o tiptap.
published_atstring | nullCuándo se publicó esta versión, o null si no es la versión publicada.
created_atstringCuándo se creó la versión, en formato ISO 8601 con desfase respecto a UTC.
updated_atstringCuándo se actualizó la versión por última vez.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "template.created",
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
},
"data": {
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
}
}
}template.updated
Se envía cuando una versión de plantilla cambia con Actualizar una plantilla. Publicar también envía este evento: una vez por la versión que publicas y otra por cada versión del alias que se despublicó. Usa published_at para distinguirlas.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre template.updated.
objectobjectLa versión de plantilla que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de plantilla
idstringEl ID de la versión de plantilla (tem_…).
objectstringSiempre template.
namestringEl nombre de la plantilla.
aliasstringEl alias que comparten todas las versiones de la plantilla.
fromstring | nullEl remitente por defecto.
subjectstring | nullEl asunto por defecto.
reply_tostring[] | nullLas direcciones de respuesta por defecto.
htmlstring | nullEl cuerpo HTML.
textstring | nullEl cuerpo en texto plano.
editorstringhtml, text, dragit o tiptap.
published_atstring | nullCuándo se publicó esta versión, o null si no es la versión publicada.
created_atstringCuándo se creó la versión, en formato ISO 8601 con desfase respecto a UTC.
updated_atstringCuándo se actualizó la versión por última vez.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "template.updated",
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-10-01T10:02:14.307000+00:00"
},
"data": {
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-10-01T10:02:14.307000+00:00"
}
}
}template.deleted
Se envía cuando se elimina una versión de plantilla con Eliminar una plantilla. El payload es la versión tal como estaba antes de eliminarse. Si era la versión publicada, el alias no tiene ninguna versión publicada hasta que publiques otra.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre template.deleted.
objectobjectLa versión de plantilla que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de plantilla
idstringEl ID de la versión de plantilla (tem_…).
objectstringSiempre template.
namestringEl nombre de la plantilla.
aliasstringEl alias que comparten todas las versiones de la plantilla.
fromstring | nullEl remitente por defecto.
subjectstring | nullEl asunto por defecto.
reply_tostring[] | nullLas direcciones de respuesta por defecto.
htmlstring | nullEl cuerpo HTML.
textstring | nullEl cuerpo en texto plano.
editorstringhtml, text, dragit o tiptap.
published_atstring | nullCuándo se publicó esta versión, o null si no es la versión publicada.
created_atstringCuándo se creó la versión, en formato ISO 8601 con desfase respecto a UTC.
updated_atstringCuándo se actualizó la versión por última vez.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "template.deleted",
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
},
"data": {
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
}
}
}