# Fila

Defina seus horários da semana uma vez e envie posts com `"queue": true` em vez de `scheduled_at`: o Wyro agenda cada um no próximo horário livre e devolve o horário escolhido em `scheduled_at` (e `"queued": true`).

## Configurar

```
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`: nome IANA (padrão `America/Argentina/Buenos_Aires`). O horário de verão é levado em conta: 10:00 continua sendo 10:00 local o ano todo.
- `slots`: itens `{"day": "mon", "time": "10:00"}`, ou `{"days": [...], "times": [...]}` para cada dia × cada horário. Dias: `mon` a `sun`; horários em 24 h. Até 100 horários.
- Até você salvar uma, a fila é de segunda a sexta às 10:00 e 19:00 (`"configured": false`).

`GET https://wyroapi.com/v1/queue` devolve a fila com os próximos 5 horários livres. `GET https://wyroapi.com/v1/queue/next?count=5` devolve até 50: `[{"scheduled_at": "2026-11-20T13:00:00.000Z", "local": "2026-11-20T10:00:00-03:00"}]`.

## Publicar na fila

```
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}'
```

Um horário está **ocupado** quando já existe um post agendado do espaço exatamente nesse momento; a fila pula. Horários a menos de um minuto também são pulados. Se não houver horário livre no próximo ano (ou nenhum configurado), a resposta é `409 queue_empty`. Em um [CSV](https://wyroapi.com/pt/docs/importar-csv), escreva `queue` ou `fila` em `scheduled_at`.

Um horário que cai na hora pulada quando começa o horário de verão avança essa hora; um na hora repetida quando termina pega a primeira.

## MCP e painel

`wyro_publicar` aceita `a_la_cola: true`; `wyro_cuentas` com `ver_cola: true` também devolve os próximos horários livres. No painel, o cartão **Fila** em Publicações edita os horários.
