Mensajes programados WhatsApp

Como funciona

Los mensajes programados permiten planificar envios de WhatsApp para una fecha y hora futura. El sistema los procesa automaticamente cuando llega el momento indicado.

1. Creas el programado

Defines fecha, hora, destinatarios y mensaje desde el Dashboard o via API.

2. El sistema lo procesa

El sistema compara la fecha programada con la fecha actual y ejecuta los envios pendientes.

3. Recurrencia

Si el intervalo de repeticion es mayor que 0, el mensaje se reenvia cada N dias automaticamente.

Zona horaria: La fecha y hora de envio (schedule) respeta la zona horaria configurada en el perfil del usuario. Asegurate de que la timezone este correctamente configurada en Dashboard > Configuracion.

Crear mensaje programado

POST Dashboard > WhatsApp > Programados > Crear — caso add.whatsapp.scheduled

Crea un nuevo mensaje programado para envio futuro. Puedes dirigirlo a numeros de telefono individuales, grupos de contactos o ambos.

Parametros

Parametro	Tipo	Estado	Descripcion
`account`	`string`	Obligatorio	ID unico de la cuenta de WhatsApp vinculada desde la cual se enviara el mensaje.
`schedule`	`datetime`	Obligatorio	Fecha y hora de envio en formato `YYYY-MM-DD HH:mm`. Respeta la timezone del usuario. Ejemplo: `2026-04-15 09:30`.
`repeat`	`integer`	Obligatorio	Intervalo de recurrencia en dias. `0` = envio unico (se elimina tras enviar). Valor `> 0` = se reenvia cada N dias.
`numbers`	`string`	Condicional	Numeros de telefono separados por coma en formato E.164. Requerido si no se especifica `groups`. Ejemplo: `+34612345678,+34698765432`.
`groups`	`array`	Condicional	Array de IDs de grupos de contactos. Requerido si no se especifica `numbers`. Los contactos del grupo recibiran el mensaje.
`message`	`string`	Obligatorio	Texto del mensaje a enviar. Soporta spintax: `{Hola\|Buenos dias}`.
`message_type`	`string`	Opcional	Tipo de mensaje: `text`, `media` o `document`. Por defecto: `text`.
`shortener`	`integer`	Opcional	ID del acortador de URL. Las URLs en el mensaje seran acortadas automaticamente.
`file`	`file`	Opcional	Archivo adjunto (imagen, video, audio o documento) via `multipart/form-data`. Solo se usa cuando `message_type` es `media` o `document`.

Destinatarios: Debes especificar al menos uno de los parametros numbers o groups. Puedes usar ambos simultaneamente para combinar destinatarios individuales con grupos de contactos.

Editar mensaje programado

POST Dashboard > WhatsApp > Programados > Editar — caso edit.whatsapp.scheduled

Modifica un mensaje programado existente. Acepta los mismos parametros que la creacion. El sistema actualizara los campos proporcionados manteniendo los valores anteriores para los no enviados.

Parametro	Tipo	Estado	Descripcion
`id`	`integer`	Obligatorio	ID del mensaje programado a editar.

Ademas de id, acepta todos los parametros de la seccion Crear mensaje programado.

Sistema de recurrencia

El parametro repeat controla la recurrencia del mensaje programado. Cuando es mayor que 0, el sistema reenvia el mensaje automaticamente cada N dias.

Valor de `repeat`	Comportamiento	Ejemplo
`0`	Envio unico. El mensaje se envia una sola vez en la fecha programada y se elimina automaticamente tras el envio.	Recordatorio puntual para una cita el 15 de abril.
`1`	Envio diario. Se reenvia cada dia desde la fecha programada.	Buenos dias automatico a las 8:00 AM.
`7`	Envio semanal. Se reenvia cada 7 dias.	Recordatorio semanal de reunion todos los lunes.
`30`	Envio mensual (aproximado). Se reenvia cada 30 dias.	Factura mensual o recordatorio de pago.

En mensajes recurrentes, el sistema registra la ultima fecha de envio y vuelve a enviar automaticamente en el siguiente intervalo configurado.

Procesamiento automatico

Los mensajes programados se procesan automaticamente en el momento configurado. El sistema resuelve los destinatarios (numeros directos y contactos de los grupos) y distribuye los mensajes a la cola de envio.

Importante: Si tienes muchos mensajes programados simultaneos, se procesaran de forma asincrona respetando los limites de envio de tu suscripcion.

Limites de la suscripcion

La cantidad de mensajes programados que un usuario puede tener activos simultaneamente esta controlada por el parametro subscription.scheduled_limit de su plan de suscripcion.

Si el usuario alcanza el limite, no podra crear nuevos mensajes programados hasta que elimine alguno existente o actualice su plan.
Los mensajes de envio unico (repeat = 0) se eliminan automaticamente tras el envio, liberando espacio.
El administrador puede configurar los limites desde el panel de administracion en la seccion de planes de suscripcion.

Ejemplo de uso

Crear mensaje programado con cURL

cURL — Crear programado (envio unico)

curl -X POST \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "secret=TU_API_KEY" \
  -d "account=ACCOUNT_ID" \
  -d "schedule=2026-04-15 09:30" \
  -d "repeat=0" \
  -d "numbers=+34612345678,+34698765432" \
  -d "message=Recordatorio: tu cita es manana a las 10:00" \
  -d "message_type=text" \
  "//whatsboost.netdashboard/requests"

Crear mensaje recurrente con PHP

PHP — Programado recurrente (cada 7 dias)

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "//whatsboost.netdashboard/requests");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    "secret"       => "TU_API_KEY",
    "type"         => "add.whatsapp.scheduled",
    "account"      => "ACCOUNT_ID",
    "schedule"     => "2026-04-15 09:30",
    "repeat"       => 7,
    "numbers"      => "+34612345678",
    "message"      => "Feliz lunes! Aqui tienes tu resumen semanal.",
    "message_type" => "text"
]));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);