Programación y campañas
Envíos a una hora fija, en la hora local de cada usuario y recurrentes.
Tipos de programación (schedule.type)
| Tipo | Campos | Envía |
|---|---|---|
now |
— | De inmediato (por defecto) |
at |
sendAt, timezone |
A esa fecha y hora. Sin zona, se usa la de tu empresa |
local_time |
date, time |
A esa hora en la zona de cada dispositivo. Se reparte durante ~26 horas, a medida que llega esa hora en cada zona |
Opciones:
windowMinutes: reparte el envío en una ventana, para no saturar tu servidor con aperturas;expireAt: no enviar después de esa hora.
Se puede programar hasta 365 días hacia adelante.
"schedule": { "type": "local_time", "date": "2026-11-28", "time": "09:00" }Un envío programado se puede editar, cancelar o enviar ya (POST /v1/notifications/{id}/send-now) mientras no haya empezado.
Campañas recurrentes
POST /v1/campaigns con:
name;- la
notification(destino y contenido); - la
recurrence:
| Campo | Ejemplo |
|---|---|
freq |
daily, weekly, monthly |
interval |
2 = cada 2 semanas |
weekdays |
["mon","thu"] |
monthDay o monthWeek |
15, o { "nth": -1, "weekday": "fri" } (último viernes) |
time, timezone |
"09:00", "America/Santo_Domingo" |
startDate, endDate, count |
Límites de la campaña |
Cada ocurrencia crea una notificación normal, con su historial y su analítica. Las campañas se pueden pausar y reanudar.
Errores
2011: programación inválida (fecha pasada, más allá del límite o campos que faltan).2012: zona horaria inválida. Usa nombres IANA, comoAmerica/Santo_Domingo.3004: tu plan no incluye programación, hora local o recurrencias.