create_campaign
Create and schedule WhatsApp marketing campaigns with template variables, contact segmentation, and multimedia support for targeted bulk messaging.
Instructions
Crear campana de marketing — Crea una nueva campana de marketing masivo. Puede crearse como borrador o programarse para una fecha futura. Soporta variables de plantilla {nombre}, {telefono}, {tienda} en el mensaje. [mutation]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Nombre de la campana | |
| message_text | Yes | Texto del mensaje. Soporta variables: {nombre} (nombre del contacto), {telefono} (telefono del contacto), {tienda} (nombre de la tienda) | |
| list_id | Yes | ID de la lista de contactos a usar para esta campana | |
| send_interval_seconds | No | Segundos entre cada envio (minimo 10, por defecto 30) | |
| translate_by_prefix | No | Si true, traduce el mensaje al idioma del destinatario segun prefijo telefonico | |
| include_unsubscribe_link | No | Si true, anade un enlace de baja al final del mensaje | |
| archive_after_send | No | Si true, archiva automaticamente cada chat de WhatsApp tras enviar el mensaje | |
| session_ids | No | Array de IDs de sesion de WhatsApp a usar para enviar. Si no se especifica, usa todas las sesiones habilitadas para marketing masivo. Usa get_whatsapp_status para ver los IDs. | |
| scheduled_at | No | Fecha y hora para programar el envio (formato: YYYY-MM-DD HH:MM:SS). Debe ser una fecha futura. Si se especifica, la campana se crea con estado 'scheduled' en vez de 'draft'. | |
| segment_filters | No | Filtros de segmentacion para enviar solo a contactos que cumplan criterios. Objeto con claves opcionales: tags (array de nombres de tags), last_contact_days (entero, enviar solo a contactos con actividad en los ultimos N dias), has_whatsapp_history (boolean, enviar solo a contactos con historial de WhatsApp) | |
| media_url | No | URL del archivo multimedia a enviar con el mensaje (imagen, video, documento). Debe ser una URL publica accesible. | |
| media_type | No | Tipo de multimedia: 'image', 'video' o 'document'. Requerido si se especifica media_url. | |
| media_filename | No | Nombre del archivo multimedia. Requerido para tipo 'document'. | |
| is_recurring | No | Si true, la campana se ejecuta de forma recurrente segun recurring_cron | |
| recurring_cron | No | Expresion cron para campanas recurrentes (ej: '0 10 * * 1' para cada lunes a las 10:00). Requerido si is_recurring es true. |