Traducción. Autoritativo: fs-msg-0007-campaigns-and-triggers.md.
Contexto
Dos formas de campaña, y fallan distinto. Un blast es una vez a un segmento: los riesgos son volumen, exactitud de la lista y el momento sin retorno. Una automatización es un disparador permanente: los riesgos son duplicados, zonas horarias y detenerse en silencio. Tratarlas como una sola cosa produce un diseño que no maneja bien ninguna. El disparador por propiedad de fecha es el que hay que diseñar con cuidado. “Feliz cumpleaños” es la automatización más común de la categoría y la más fácil de equivocar de forma vergonzosa — enviada un día antes en una zona, dos veces en año bisiesto, o a todos a las 03:00 porque el cron corre en UTC.Alcance (normativo)
messaging.campaigns:blastoautomation, con categoría.messaging.campaign_triggers: evento, propiedad de fecha, entrada o salida de segmento.- Programación por propiedad de fecha con zona horaria del destinatario.
messaging.campaign_runspara contabilidad e idempotencia por corrida.- Programación de blasts, vista previa del conteo de destinatarios y cancelación antes del despacho.
- Overrides de quiet hours y frequency caps por campaña.
Fuera de alcance (normativo)
- Journeys multi-paso con ramas. Deliberadamente fuera: un constructor de journeys es su propio producto y uno malo es peor que ninguno.
- Testing A/B — F2.
- El motor de reglas, que es de
loyalty. - La definición de segmentos, que es de
core.
Comportamiento (normativo)
- Una campaña es
blastoautomation. Un blast corre una vez contra un snapshot del segmento tomado al despachar, no al programar — la lista es la que hay cuando sale. - Los disparadores por propiedad de fecha corren por tenant con fan-out de cron, en una ventana de envío en la zona horaria del destinatario, cayendo a la del tenant. Un correo de cumpleaños a las 03:00 local es peor que ninguno.
- Los duplicados son imposibles por construcción: una clave única de (campaña, contacto, fecha de ocurrencia). Reejecutar el job, un reintento o un segundo worker no pueden producir un segundo mensaje.
- Los cumpleaños del 29 de febrero se disparan el 28 en años no bisiestos. Se enuncia porque la alternativa es un member que nunca recibe uno.
- Una campaña cuya plantilla, segmento o disparador se vuelve inválido se pausa y se notifica a su dueño, nunca se salta en silencio. Una campaña que dejó de correr sin avisar se descubre meses después.
- Los blasts son cancelables hasta que empieza el despacho y reportan un conteo antes. Una vez iniciado corren hasta el final — un blast a medio enviar no se puede des-enviar.
- Toda campaña declara una categoría, y las de marketing obedecen quiet hours y frequency caps con override opcional por campaña (DEC-E5).
- Cada mensaje que una campaña produce pasa la cascada individualmente. Una campaña no es un atajo; es una razón para enviar.
campaign_runsregistra qué corrió, cuándo, cuántos resolvieron, cuántos se excluyeron y por qué.
Datos (normativo)
API (normativo)
Eventos (normativo)
messaging.campaign.triggered, disponible como webhook saliente, con campaña y ocurrencia.
Criterios de aceptación (normativo)
- Una campaña de cumpleaños envía una vez por member por año, en la ventana de su zona horaria, verificado cruzando la línea de cambio de fecha.
- Reejecutar el job el mismo día produce cero mensajes adicionales.
- Un cumpleaños del 29 de febrero se dispara el 28 en año no bisiesto.
- Un blast toma snapshot de su segmento al despachar, no al programar.
- Un blast se puede cancelar hasta que empieza el despacho, y no después.
- Una campaña con plantilla inválida se pausa y se notifica a su dueño.
- Cada mensaje pasa la cascada individualmente — un member suprimido dentro del segmento no recibe nada y la exclusión se cuenta.
- Una campaña de marketing obedece quiet hours salvo que declare override.
- Negativo: ningún camino de campaña alcanza un adaptador sin pasar la cascada.
Ejecución
Pipeline asíncrono. Evaluación de disparadores y fan-out enbackend/scheduler, despacho por el
carril de marketing en backend/workers.