Como publicar no Instagram automaticamente
Como automatizar a publicação no Instagram sem depender de alguém clicando em "publicar" manualmente.
Por André LugPublicar no Instagram "automaticamente" costuma significar uma de duas coisas: disparar o post a partir de um evento do seu próprio sistema (um pedido pago, um vídeo processado, uma linha nova numa fila), ou colocar posts numa recorrência sem ninguém clicando em "publicar" toda semana. Os dois casos usam a mesma API — a diferença está em como você estrutura a chamada e em como lida com falha sem um humano no loop para reagir na hora.
Se você ainda não conectou a conta ou nunca publicou pela API, comece pelo passo a passo geral de como postar no Instagram via API. Este guia assume que a conexão já existe e foca no que muda quando é um pipeline, não uma pessoa.
O que muda quando não há humano clicando em publicar
Numa publicação manual, alguém revisa o conteúdo antes de apertar o botão. Num pipeline automatizado, essa revisão precisa acontecer antes da chamada de API — ou via um modo draft que segura o post para aprovação, ou porque o conteúdo já passou por alguma validação anterior no seu sistema. A Idempotency-Key também passa a ter um papel mais crítico: em vez de um valor aleatório, ela deve derivar do ID do job, do evento ou do item de fila que originou aquele post, para que uma nova tentativa automática do seu worker não publique o mesmo conteúdo duas vezes.
Publicar direto do seu pipeline
Quando o gatilho já é determinístico (por exemplo, um vídeo terminou de processar e precisa ir ao ar imediatamente), a chamada é a publicação direta de sempre, sem scheduled_at. O que muda é a origem da chave de idempotência, que aqui vem do identificador do job:
curl -X POST https://postgate.studio/api/posts \
-H "Authorization: Bearer $POSTGATE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: job-9f21c-instagram" \
-d '{
"post": { "body": "Novo episódio no ar." },
"profiles": ["pro_instagram123"],
"media": ["https://cdn.example.com/episode-42.mp4"]
}'Ou enfileirar em vez de publicar na hora
Quando a automação é uma recorrência (por exemplo, publicar todo dia útil às 9h com o conteúdo que estiver na fila), o padrão certo não é chamar POST /api/posts repetidamente a partir de um cron do seu lado — é criar um schedule recorrente uma única vez e deixar o PostGate materializar os posts no horário certo, no fuso horário certo. Isso remove uma classe inteira de bugs: cron do seu servidor que não roda, fuso horário calculado errado, ou o mesmo job disparando duas vezes depois de um restart.
O guia dedicado de agendamento cobre isso em detalhe: veja como agendar posts via API.
Lidando com falha sem um humano no loop
Sem alguém olhando o post depois de publicado, sua automação precisa tratar o array targets da resposta como a fonte de verdade, não o status agregado. Um post partial — publicado em alguns destinos e falho em outros — é um resultado terminal válido, não uma exceção a ser re-lançada. O caminho mais robusto para pipelines de verdade é assinar webhooks de mudança de estado em vez de fazer polling, para reagir a uma falha (por exemplo, uma conta que caiu em awaiting_reconnect) sem depender de checar manualmente.
