wyro

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.