Campaign
Campaign permite que los administradores autorizados gestionen registros, condiciones de audiencia, contenido por canal, horarios y contadores de envío. La disponibilidad depende del plan, la configuración y los servicios desplegados del proyecto. Que una campaña aparezca no confirma que la audiencia sea precisa ni que se haya enviado un mensaje.
Al abrir esta sección se recuperan datos privados de campañas, y abrir una campaña puede enviar sus condiciones para evaluar la audiencia. Crear, guardar, cancelar, eliminar o editar una campaña puede guardar registros, seleccionar destinatarios, poner trabajos en cola o afectar los envíos externos. Usa un proyecto de prueba aprobado y destinatarios sintéticos; no expongas datos reales de destinatarios, credenciales de proveedores, mensajes, URL ni horarios durante las pruebas.
Disponibilidad y navegación
La ruta /marketing/campaign está restringida a administradores de nivel 0, pero no repite la comprobación de la función Campaign. Además, la barra lateral requiere que se cumplan los requisitos del grupo Marketing —proyecto Pro o Enterprise elegible, nivel 0 y estado sin modo de solo lectura— y que el indicador marketingCampaigns esté habilitado para mostrar Campaign. El acceso a la ruta, la visibilidad del grupo, la del elemento, la autorización de la API y el requisito de proyecto definido por el código fuente de la API son condiciones independientes.
Consultas autenticadas y evaluación automática de audiencias
La lista de campañas recupera registros autenticados y paginados, y permite buscar por nombre de campaña o tipo de contacto. Al abrir una campaña, se recuperan sus condiciones y contadores de envío, además de las categorías de configuración Pro que usa el formulario.
Abrir una campaña con datos también puede enviar sus condiciones actuales y tipo de contacto al servicio de audiencias. La respuesta puede incluir registros de destinatarios y paginación; por eso, evaluar una audiencia no es una vista previa local y puede exponer datos personales.
Estados de campañas y canales
Las campañas admiten los tipos de contacto email, SMS, WhatsApp, notification, popup y webhook. Los datos pueden incluir un nombre, contenido específico del canal, tipo de audiencia, condiciones, horario, hora de finalización, estado, contadores y eventos de destinatarios.
Aunque los registros aceptan los seis tipos de contacto, el flujo automatizado de lanzamiento procesa tareas por destinatario solo para email, SMS, notification y webhook. WhatsApp y popup no se envían mediante ese flujo. Confirma la disponibilidad de canales para tu proyecto antes de programar una campaña.
Las acciones de campaña tienen estos límites:
- La creación de campañas se limita a proyectos elegibles.
- El tipo de contacto es obligatorio al crear y la ruta de actualización no permite cambiarlo.
- Las campañas finalizadas o canceladas rechazan las actualizaciones; una campaña activa solo acepta la cancelación.
- La creación requiere al menos una condición de audiencia y una audiencia fija no puede estar vacía.
- La programación puede cambiar el estado inicial y retrasar un trabajo de lanzamiento en cola, pero la hora programada no garantiza el envío.
Los cambios de estado y los mensajes de éxito de Dashboard no confirman que la API aceptara la solicitud ni que un proveedor la procesara.
Superficies con efectos persistentes y externos
Las acciones de campaña pueden:
- crear una campaña y sus filas de condiciones;
- calcular una audiencia mediante POST y, para una audiencia fija, guardar relaciones con destinatarios;
- despachar un trabajo de lanzamiento de campaña inmediatamente o con una demora calculada por el código fuente, con ramas por destinatario inspeccionadas solo para email, SMS, notification y webhook;
- actualizar campos generales, de horario, audiencia y contenido por canal;
- crear o eliminar condiciones individuales;
- cancelar o eliminar una campaña e invocar acciones o hooks de complementos;
- consultar eventos de envío de destinatarios, como enviado, abierto, rebotado, queja, cancelación de suscripción o clic.
La cancelación puede eliminar registros de destinatarios pendientes de envío que no pertenezcan a la campaña seleccionada. Confirma este comportamiento con el administrador de tu proyecto antes de cancelar o volver a intentar una campaña.
Privacidad y límites de proveedores
Los nombres de campañas, condiciones, registros de destinatarios, correos electrónicos, números de teléfono, contenido por canal, configuración y credenciales de proveedores, destinos de webhooks o redirecciones, horarios, identificadores de seguimiento y eventos de envío son datos operativos privados o cercanos a secretos. Las comprobaciones de configuración de proveedores y los hooks de complementos pueden cruzar límites entre sistemas. No copies valores reales a capturas, tickets, chats, registros ni documentación.
La disponibilidad y el comportamiento de Campaign dependen de la configuración del proyecto y del servicio desplegado. Que una campaña aparezca o muestre una confirmación no demuestra por sí solo que se hayan seleccionado los destinatarios previstos o que se haya enviado un mensaje. Comprueba el estado actual de la campaña antes de volver a intentar una acción.
Guías relacionadas: Descripción general de Marketing · Advanced offers