Gestión de Mensajes Programados

Subflow incluye un motor de programación de mensajes que permite encolar comunicaciones para fechas y horas futuras con precisión al segundo.

Listar Mensajes Programados Pendientes

• Método: GET
• Ruta: /api/v1/integrations/:integrationKey/messages/scheduled
• Parámetros: page (default 1), limit (default 20)

Ejemplo de Petición

curl -X GET "https://api.omniflou.com/api/v1/integrations/agendaconmigo/messages/scheduled?page=1&limit=5" \
  -H "Authorization: Bearer sf_int_agendaconmigo_your_token"

Respuesta (200 OK)

{
  "docs": [
    {
      "_id": "6a4ffc99e5956fd8d285c5c0",
      "tenantId": "6a4ffc99e5956fd8d285c5aa",
      "conversationId": "6a4ffc99e5956fd8d285c5be",
      "direction": "outbound",
      "sender": "system",
      "contentType": "text",
      "content": {
        "text": "Recordatorio: Tu vuelo sale en 3 horas."
      },
      "status": "scheduled",
      "scheduledAt": "2026-09-01T08:00:00.000Z",
      "createdAt": "2026-08-20T10:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 5,
  "totalPages": 1,
  "hasNextPage": false,
  "hasPrevPage": false
}

Cancelar un Mensaje Programado

Si necesitas anular un envío antes de que se despache:

• Método: DELETE
• Ruta: /api/v1/integrations/:integrationKey/messages/scheduled/:messageId

Ejemplo de Petición

curl -X DELETE "https://api.omniflou.com/api/v1/integrations/agendaconmigo/messages/scheduled/6a4ffc99e5956fd8d285c5c0" \
  -H "Authorization: Bearer sf_int_agendaconmigo_your_token"

Respuesta (200 OK)

{
  "success": true,
  "message": "Mensaje programado cancelado correctamente."
}