Campañas

Listar 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.

Leer 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).

Crea 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 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).

Copiar una campaña, incluidos sus segmentos y plantillas de canal. La copia se crea como DRAFT y no envía nada.

Eliminar 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.

Mueve una campaña por su ciclo de vida: 'schedule' pone en cola una Campaña de MARKETING para toda su audiencia (el envío masivo real, inmediatamente o en la hora programada; requiere una plantilla de canal); 'cancel' detiene una Campaña de marketing programada o en envío y la devuelve a borrador; 'activate' activa una Campaña de TRANSACTIONAL; 'pause' la suspende.

Adjunta o actualiza el mensaje del canal de una campaña: lo que realmente se envía.

Añade contactos específicos a la audiencia de una Campaña de MARKETING (además de segmentos / enviar a todos), por ejemplo una lista importada desde un archivo o filtrada en código. Requiere una campaña editable con al menos una plantilla de canal.

Vista previa de cuántos destinatarios alcanzará una Campaña de MARKETING por canal, según su audiencia actual; compruébalo antes de programar el envío.

Reintenta los destinatarios fallidos de una campaña (hasta 1000 por llamada). Omite recipient_ids para reintentarlos todos.

Quita los destinatarios pendientes (aún no enviados) de una Campaña de MARKETING editable. Omite contact_ids para quitar todos los pendientes.

Muestra los campos de personalización (marcadores {{variable}}) de una campaña con sus valores predeterminados.

Crea o actualiza un campo de personalización ({{variable}}) en una campaña con su valor predeterminado. Las claves reservadas como first_name/last_name se resuelven desde el contacto; las demás usan el valor predeterminado salvo que una entrada por destinatario lo reemplace.

Define valores de personalización por destinatario en una campaña de MARKETING. Pasa una entrada por destinatario, identificado por email, teléfono o user_id. Pasa dry_run para previsualizar qué destinatarios coincidirían sin escribir nada.

Pon 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.

Cancela una Campaña de MARKETING en estado SCHEDULED o SENDING: vuelve a DRAFT y se puede editar y volver a programar. Los destinatarios ya enviados siguen enviados.

Activar 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 una campaña transactional ACTIVE. Los desencadenadores se rechazan hasta que vuelva a activarse; la configuración se conserva.

Enviar 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).

Estadí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.

Enumera 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.