# Cola

Define tus horarios de la semana una vez y envía los posts con `"queue": true` en vez de `scheduled_at`: Wyro programa cada uno en el próximo horario libre y devuelve la hora elegida en `scheduled_at` (y `"queued": true`).

## Configurarla

```
curl -X PUT https://wyroapi.com/v1/queue -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/Argentina/Buenos_Aires",
    "slots": [
      {"days": ["mon", "tue", "wed", "thu", "fri"], "times": ["10:00", "19:00"]},
      {"day": "sat", "time": "11:30"}
    ]
  }'
```

- `timezone`: nombre IANA (por defecto `America/Argentina/Buenos_Aires`). El horario de verano se respeta: las 10:00 siguen siendo las 10:00 locales todo el año.
- `slots`: ítems `{"day": "mon", "time": "10:00"}`, o `{"days": [...], "times": [...]}` para cada día × cada horario. Días: `mon` a `sun`; horarios en 24 h. Hasta 100 horarios.
- Hasta que guardes una, la cola es de lunes a viernes a las 10:00 y 19:00 (`"configured": false`).

`GET https://wyroapi.com/v1/queue` la devuelve con los próximos 5 horarios libres. `GET https://wyroapi.com/v1/queue/next?count=5` devuelve hasta 50: `[{"scheduled_at": "2026-11-20T13:00:00.000Z", "local": "2026-11-20T10:00:00-03:00"}]`.

## Publicar a la cola

```
curl -X POST https://wyroapi.com/v1/posts -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "…", "platforms": ["linkedin"], "queue": true}'
```

Un horario está **ocupado** cuando ya hay un post programado del espacio exactamente a esa hora; la cola lo saltea. También saltea los que faltan menos de un minuto. Si no hay ninguno libre en el próximo año (o no hay horarios), la respuesta es `409 queue_empty`. En un [CSV](https://wyroapi.com/docs/importar-csv), escribe `queue` o `cola` en `scheduled_at`.

Un horario que cae en la hora que se salta al empezar el horario de verano se corre esa hora; uno en la hora que se repite al terminar toma la primera.

## MCP y panel

`wyro_publicar` acepta `a_la_cola: true`; `wyro_cuentas` con `ver_cola: true` también devuelve los próximos horarios libres. En el panel, la tarjeta **Cola** de Publicaciones edita los horarios.
