
scheduled_at y timezone; GOWA almacena la solicitud y un trabajador de fondo la envía en ese momento. Los programas sobreviven a los reinicios y esperan un dispositivo sin conexión.
Tipos de mensajes programables: texto, imagen, archivo, vídeo, audio, sticker, contacto, enlace, ubicación, encuestas y reenvío (/message/{id}/forward). Presencia, indicadores de tecleo y el final experimental /send/interactive no son programables.
Programar campos
Sin
scheduled_at, la solicitud se envía inmediatamente como de costumbre.
Ejemplos
schedule_id en lugar de message_id.
weekdays como campos repetidos (-F weekdays=1 -F weekdays=3).
Gestionar programas
Los programas pertenecen a un dispositivo; envíe el mismoX-Device-Id.
results.data y results.pagination (limit, default 25; offset; total).
Statuses
Comportamiento de entrega
- El trabajador verifica los horarios de vencimiento cada 5 segundos.
- Dispositivo sin conexión o no conectado: la ejecución espera y vuelve a intentarlo cada 30 segundos. Esperar no cuenta como un intento fallido, por lo que un programa sobrevive a largas interrupciones.
- Enviar errores: reintentó con backoff a partir de 15 segundos y se limitó a 5 minutos, hasta 10 intentos por ocurrencia. Un programa recurrente luego se salta a su siguiente ocurre; un programa único se vuelve
failed. - Solicitud no válida (por ejemplo un mal destinatario): falla inmediatamente sin reintentar.
- Late runs: no se envía una ocurrencia retrasada pasada
end_at. - Accidentes y reinicios: el apagado no aborta un envío ya en vuelo. Antes del primer intento, GOWA persiste un ID de mensaje de WhatsApp para la ocurrencia. Después de que expire su reclamo de 2 minutos, una ocurrencia interrumpida es solicitada con ese mismo ID y cuenta para el presupuesto de intento. Las encuestas también mantienen su cifrado secreto a través de las recuperaciones. Esto preserva la identidad del mensaje después de un reconocimiento ambiguo, pero no garantiza una entrega exacta una vez.
- Anteriores intentos interrumpidos: intentos heredados cuyo resultado es desconocido retienen la recuperación conservadora. El trabajador salta esa ocurrencia para un programa recurrente o falla un programa único en lugar de asignarle una nueva identidad de mensaje.
Sobre MCP
La herramienta MCPwhatsapp_send acepta los mismos campos de programación, y whatsapp_schedule listas, obtienen, pausas, reanudan y cancelan programas. Vea Servidor MCP.
Comprueba
GET /app/info: results.scheduled_sends es true cuando el servidor acepta campos de programación y expone /send/schedules.