Converta em Lote uma Pasta de PDFs em Flipbooks

Você tem uma pasta. Cinquenta PDFs de produtos parados nela. Cada um precisa virar um flipbook com um título decente, e você precisa dos links de compartilhamento numa planilha até o fim do dia. Fazer isso na mão — subir, nomear, esperar, copiar o link, colar, repetir — é o tipo de tarefa que devora uma tarde e a sua paciência.

Este guia mostra como converter PDF em flipbook em lote para uma pasta inteira com um único loop de shell, reunir todas as URLs resultantes em um CSV e seguir em frente mesmo que um arquivo esteja com defeito. Ele pressupõe que você já tem a CLI do FlipLink instalada e autenticada. Se ainda não tiver, comece primeiro por Primeiros Passos com a CLI do FlipLink — leva cerca de dois minutos.

O Bloco Básico: Um Arquivo de Cada Vez

Antes de percorrer cinquenta arquivos em um loop, acerte um arquivo só. O comando da CLI que transforma um PDF em flipbook é:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --name q3

--title é o que os leitores veem; --name é o rótulo interno. Adicione --json e o comando imprime a resposta bruta da API em vez de um resumo amigável — é desse JSON que vamos extrair o link de compartilhamento mais adiante:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --json

Essa única resposta carrega tudo o que você precisa: o ID do novo flipbook e a URL pública dele. Agora é só executar uma vez por arquivo.

O Loop: Converta Todos os PDFs de uma Pasta

Aqui está o núcleo da coisa. Jogue seus PDFs em uma pasta, entre nela com cd e rode um loop bash sobre *.pdf. Derivamos um título limpo de cada nome de arquivo — tiramos a extensão .pdf e trocamos traços/sublinhados por espaços:

#!/usr/bin/env bash
for f in *.pdf; do
  # Turn "spring-product-catalog.pdf" into "spring product catalog"
  name="$(basename "$f" .pdf | tr '_-' '  ')"
  echo "Converting: $f  ->  \"$name\""
  fliplink flipbook create "$f" --title "$name" --json
done

Isso percorre a pasta, converte cada PDF e imprime o resultado em JSON de todos eles. Funciona, mas a saída é uma muralha de JSON e um único arquivo com defeito ainda deixaria o resto rodar. Vamos resolver as duas coisas — primeiro a saída, depois o tratamento de erros.

Reunindo os Resultados em um CSV

O que você realmente quer no fim é uma planilha: uma linha por flipbook, com o ID e o link de compartilhamento. Passe cada resultado de --json por jq para extrair apenas esses dois campos e anexar uma linha ao CSV.

A resposta de criação contém o ID do flipbook e uma URL. Extraímos os dois, recorremos a um valor reserva caso algum campo esteja faltando e escrevemos uma linha de cabeçalho uma vez no topo:

#!/usr/bin/env bash
out="flipbooks.csv"
echo "file,id,url" > "$out"           # write the CSV header once

for f in *.pdf; do
  name="$(basename "$f" .pdf | tr '_-' '  ')"
  echo "Converting: $f"

  json="$(fliplink flipbook create "$f" --title "$name" --json)"

  # Pull ID + URL from the JSON; '// "?"' supplies a fallback if absent
  row="$(printf '%s' "$json" | jq -r '[.ID, .URL] | @csv' 2>/dev/null)"

  printf '%s,%s\n' "$f" "$row" >> "$out"
done

echo "Done. Results in $out"

jq -r '[.ID, .URL] | @csv' monta um fragmento de CSV devidamente entre aspas a partir dos dois campos, e @csv cuida de qualquer vírgula ou aspas dentro dos valores para você. Abra flipbooks.csv em qualquer planilha e pronto: você tem a sua lista de distribuição.

Se você preferir pegar o link canônico de compartilhamento separadamente, a CLI tem um comando dedicado para isso — fliplink flipbook share-link <flipbookId> — que você pode chamar com o ID que acabou de capturar.

🚀

Experimente o FlipLink Grátis

Converta seu PDF em segundos. Sem cadastro, sem cartão de crédito — basta enviar o arquivo.

Drop your PDF here or click to browse

Máx 40MB

Os planos pagos a partir de $39 aumentam esse limite para 150 MB.

Não Deixe um Arquivo com Defeito Derrubar o Lote

Pastas são bagunçadas. Um PDF pode estar corrompido, grande demais ou estourar a cota do seu plano. O loop padrão registraria a falha como uma linha e seguiria em frente alegremente — mas você não saberia quais de fato deram certo.

A CLI te dá um sinal claro por meio dos códigos de saída dela:

• 0 — sucesso
• 1 — um erro de requisição ou HTTP (rede, upload grande demais, autenticação)
• 2 — um erro de aplicação (a API retornou Result: ERROR, por exemplo, cota excedida)

Verifique o código de saída depois de cada chamada. Registre os que deram certo no seu CSV, as falhas em uma lista separada, e mantenha o lote rodando de qualquer jeito:

#!/usr/bin/env bash
out="flipbooks.csv"
fail="failed.txt"
echo "file,id,url" > "$out"
: > "$fail"                            # truncate the failure log

ok=0; bad=0
for f in *.pdf; do
  name="$(basename "$f" .pdf | tr '_-' '  ')"
  echo "Converting: $f"

  if json="$(fliplink flipbook create "$f" --title "$name" --json)"; then
    row="$(printf '%s' "$json" | jq -r '[.ID, .URL] | @csv' 2>/dev/null)"
    printf '%s,%s\n' "$f" "$row" >> "$out"
    ok=$((ok + 1))
  else
    code=$?                            # 1 = request error, 2 = application error
    echo "$f (exit $code)" >> "$fail"
    bad=$((bad + 1))
  fi
done

echo "Converted $ok, failed $bad. See $out and $fail."

Como a CLI sai com código diferente de zero em caso de falha, o ramo if só roda em um sucesso de verdade, então o seu CSV nunca enche de linhas vazias. No fim você recebe uma contagem e um failed.txt listando exatamente quais arquivos investigar — rode de novo apenas esses depois de corrigi-los.

Uma Observação sobre Atribuição de Pasta

Uma pergunta comum em seguida: “O loop pode jogar tudo dentro de uma pasta específica do FlipLink?” Não existe uma flag --folder em fliplink flipbook create — não tente usar, ela não existe.

Algumas coisas para saber sobre como as pastas do FlipLink funcionam: elas são criadas sob demanda e somem de novo quando ficam vazias, então não há nada para criar previamente. Para colocar um flipbook em uma pasta, use a saída de emergência da CLI — o comando api — que consegue alcançar qualquer endpoint, inclusive os que não têm um subcomando dedicado:

fliplink api PUT /api/assign-to-folder/<flipbookId> --data '{"Folder":"Marketing/Q2"}'

Encaixe essa chamada no ramo de sucesso do loop, passando o ID que você capturou da resposta de criação. Se você não tiver certeza dos nomes exatos dos campos de algum endpoint, consulte a referência da API ao vivo em vez de adivinhar — todos os parâmetros estão documentados lá, com um console Try-It.

Para Fechar

Uma pasta de PDFs, um loop de shell e um CSV de links de compartilhamento esperando no fim — é esse o trabalho todo. O mesmo padrão escala de cinco arquivos para quinhentos, e a verificação do código de saída garante que um único arquivo com defeito nunca atrapalhe a execução. Para mais sobre os fluxos de trabalho roteirizados do FlipLink, a documentação da CLI cobre todos os comandos, e Operações em Massa explica como isso se encaixa em um pipeline de publicação maior — perfeito para manter catálogos de produtos atualizados em lotes.

Leitura Complementar

• Primeiros Passos com a CLI do FlipLink
• Roteirizando a CLI do FlipLink com jq
• Documentação da CLI
• Operações em Massa
• Caso de Uso: Catálogos de Produtos
• Referência da API