Campañas
Acciones integradas para campañas de marketing y transaccionales
Listar campañas
CampañasListar las campañas de esta organización, primero las más recientes. Las campañas MARKETING son envíos masivos a segmentos o a todos los contactos; las TRANSACTIONAL son envíos a un único destinatario activados por desencadenadores o por la API.
Obtener campaña
CampañasLeer una sola campaña completa: estado, programación, audiencia (segmentos o todos los contactos), plantillas de canal y contadores de entrega (enviados, entregados, abiertos, fallidos).
Crear campaña
CampañasCrea una Campaña como BORRADOR: una campaña de marketing masiva (p. ej. un envío masivo de plantillas de WhatsApp) para segmentos o todos los contactos, o un envío transaccional a un solo destinatario.
Actualizar campaña
CampañasActualizar el nombre, la hora programada o la audiencia de una campaña. La audiencia y la programación solo pueden cambiarse mientras la campaña sea editable (marketing: DRAFT, CANCELLED o FAILED; transactional: DRAFT, ACTIVE o PAUSED).
Duplicar campaña
CampañasCopiar una campaña, incluidos sus segmentos y plantillas de canal. La copia se crea como DRAFT y no envía nada.
Eliminar campaña
CampañasEliminar permanentemente una campaña y su historial de entregas. Las campañas de marketing no pueden eliminarse mientras estén programadas o enviándose; las transactional deben pausarse primero.
Programar campaña
CampañasPon en cola una Campaña de MARKETING para enviarla a toda su audiencia. Se envía de inmediato cuando la campaña no tiene hora programada; si no, espera hasta ese momento. Este es el envío masivo real: confírmalo con el usuario antes de ejecutarlo. Requiere estado DRAFT, CANCELLED o FAILED y al menos una plantilla de canal.
Cancelar campaña
CampañasCancelar una campaña MARKETING con estado SCHEDULED o SENDING. Los destinatarios ya enviados se mantienen; el resto se omite.
Activar campaña
CampañasActivar una campaña TRANSACTIONAL para que acepte desencadenadores y empiece a enviar a destinatarios individuales. Se permite desde DRAFT o PAUSED; requiere al menos una plantilla de canal.
Pausar campaña
CampañasPausar una campaña transactional ACTIVE. Los desencadenadores se rechazan hasta que vuelva a activarse; la configuración se conserva.
Enviar prueba de campaña
CampañasEnviar una prueba de una campaña a una sola dirección de correo electrónico o número de teléfono para revisar su contenido antes del envío real. Solo funciona mientras la campaña sea apta para pruebas (marketing: DRAFT, CANCELLED o FAILED; transactional: DRAFT, ACTIVE o PAUSED).
Obtener analíticas de campaña
CampañasEstadísticas agregadas de entrega e interacción por campaña: totales, tasa de entrega y tasa de apertura, opcionalmente limitadas a un intervalo de fechas.
Listar destinatarios de campaña
CampañasEnumera las entregas individuales de una campaña con su estado (sent, delivered, opened, failed, bounced). Responde a "¿enviamos X a este contacto?": filtra por campaña, por contacto o busca por nombre, email o teléfono entre todas las campañas.