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.
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. |
media_urls |
não | URLs públicas separadas por |. |
first_comment |
não | Primeiro comentário 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.
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.