# Importar CSV

`POST https://wyroapi.com/v1/posts/bulk` cria um post por linha de um CSV, cada um pelo mesmo caminho de `POST /v1/posts` (validação, freio a duplicados, fila). Envie o arquivo com `Content-Type: text/csv`, ou JSON `{"csv": "…"}`. Até **200 linhas** e **1 MB**. [Baixe o modelo](https://wyroapi.com/csv/posts-template.csv).

## Colunas

| Coluna | Obrigatória | Descrição |
| --- | --- | --- |
| `text` | sim | Texto do post. |
| `platforms` | uma das duas | Redes separadas por `\|`: `instagram\|linkedin`. |
| `account_ids` | uma das duas | Ids de conta separados por `\|`. |
| `scheduled_at` | não | ISO 8601 com fuso (`2026-12-01T10:00:00-03:00`). Vazio: publica agora. `queue` (ou `fila`): o próximo horário livre da [fila](https://wyroapi.com/pt/docs/fila). |
| `media_urls` | não | URLs públicas separadas por `\|`. |
| `first_comment` | não | [Primeiro comentário](https://wyroapi.com/pt/docs/textos-por-rede) onde a rede aceita. |

CSV padrão: campos com vírgulas, aspas ou quebras de linha vão entre aspas duplas, e uma aspa dentro se escreve duas vezes (`""`). A primeira linha é o cabeçalho; um BOM UTF-8 (Excel) não tem problema. Colunas desconhecidas dão erro, para um erro de digitação não passar despercebido.

```csv
text,platforms,scheduled_at,media_urls,first_comment
"Lanzamos algo nuevo",instagram|linkedin,2026-12-01T10:00:00-03:00,https://example.com/a.jpg,"Link: https://example.com"
"Texto con comas, ""comillas"" y
dos líneas",linkedin|x,2026-12-02T19:00:00-03:00,,
"Al próximo horario libre",facebook,queue,,
```

## 1. Teste (dry run)

```
curl -X POST "https://wyroapi.com/v1/posts/bulk?dry_run=true" -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: text/csv" \
  --data-binary @posts.csv
```

Revisa cada linha e não cria nada: `{ "dry_run": true, "total", "valid", "failed", "rows": [...] }`. Cada linha traz `row`, `line` (no arquivo), `status` (`valid` ou `error`), as redes, `scheduled_at` (o horário da fila que pegaria) e, se houver erro, `error.code`, `error.message` e `error.details`. Também detecta duplicados dentro do mesmo arquivo.

## 2. Criar

```
curl -X POST "https://wyroapi.com/v1/posts/bulk" -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: text/csv" \
  -H "Idempotency-Key: 2f6c1d0a-campaign-december" \
  --data-binary @posts.csv
```

As linhas são independentes: uma que falha não para as outras. Cada linha devolve `post_id` e `preview_url`, ou o erro. Com `Idempotency-Key`, a linha N usa a chave `<chave>:row:N`: reenviar o mesmo arquivo com a mesma chave não cria nada duas vezes e devolve os mesmos resultados.

Um arquivo que não é CSV válido, não tem coluna `text` ou é grande demais falha inteiro (`validation_error` ou `bulk_too_large`) antes de rodar qualquer linha. Com uma chave de teste, toda linha é simulada.

## No painel

Publicações → **Importar CSV**: escolha o arquivo, revise a prévia com os erros de cada linha e confirme.
