Agendar publicações no Instagram através da API
As publicações do Instagram são agendadas pela API mantendo cada uma numa fila e publicando-a à hora escolhida, já que a chamada media_publish da Meta não aceita data. A publish_instagram_post do easyCoexistence recebe scheduled_at, uma data e hora ISO 8601 com fuso horário, de 1 minuto a 90 dias à frente, e a sua fila publica a fotografia, o carrossel, o Reel ou a Story nessa altura, dentro do limite de 100 publicações pela API em 24 horas.
O único parâmetro que media_publish aceita além do token, por isso a publicação fica online quando essa chamada é feita.
Quanto tempo um container se mantém sem ser publicado, pouco para o criar dias antes de uma hora agendada.
Publicações feitas pela API por conta numa janela móvel de 24 horas, contadas quando cada container é publicado.
Onde o ficheiro tem de estar no momento da tentativa de publicação, já que a Meta o vai buscar por si.
Como funciona o agendamento através da API do Instagram?
Mantendo a publicação em espera até à sua hora. A publicação faz-se em duas chamadas: POST /<IG_ID>/media cria um container a partir do ficheiro, e POST /<IG_ID>/media_publish com o ID desse container põe a publicação online. Nenhuma das chamadas aceita uma data ou hora de publicação, por isso uma publicação agendada é aquela que a aplicação guarda na sua própria fila e publica no momento escolhido.
Como agendar uma publicação através do MCP?
Peça-o com palavras simples. Com o conector do easyCoexistence adicionado ao Claude ou ao ChatGPT e a conta do Instagram ligada, basta um pedido como "Agende este carrossel para sexta-feira às 9h com esta legenda": o assistente chama publish_instagram_post com scheduled_at, uma data e hora ISO 8601 com fuso horário, de 1 minuto a 90 dias à frente. O easyCoexistence copia o ficheiro no momento do agendamento, mantém a publicação na fila e publica-a nessa altura. Podem ser agendadas fotografias, carrosséis de 2 a 10 itens, Reels e Stories, com o ficheiro num URL HTTPS público e as imagens em JPEG.
O que tem de ser verdade quando a publicação sai?
O mesmo que para uma publicação feita de imediato:
- O ficheiro está num URL público que a Meta consegue buscar durante a tentativa de publicação; a fila do easyCoexistence serve a sua própria cópia, feita quando a publicação foi agendada.
- As imagens são JPEG: a API do Instagram não publica outro formato de imagem, e formatos JPEG alargados, como MPO e JPS, são recusados.
- Um vídeo terminou o processamento: o
status_codedo seu container tem de indicar FINISHED antes demedia_publishter sucesso. - A conta tem margem dentro do limite: 100 publicações feitas pela API em 24 horas móveis, contando um carrossel uma só vez.
Porque é que o container não pode ser criado com antecedência?
Porque expira. Um container que não seja publicado em 24 horas fica com o estado EXPIRED e tem de ser criado de novo, e uma conta pode criar 400 containers em 24 horas móveis. Uma fila que guarda publicações durante dias ou semanas mantém o URL do ficheiro e a legenda, e cria o container perto da hora de publicação.
As publicações agendadas contam para o limite diário?
Sim, no dia em que são publicadas. A Meta aplica o limite de 100 publicações feitas pela API em 24 horas móveis na chamada media_publish, e recomenda que as aplicações que deixam agendar publicações no futuro também o façam. GET /<IG_ID>/content_publishing_limit indica quota_usage, o número de publicações que a conta fez pela API nas últimas 24 horas.
Erros comuns
- Agendar um ficheiro a partir de uma ligação que não abre. O easyCoexistence copia o ficheiro no momento do agendamento e recusa uma página web, um ficheiro em falta, o tipo errado ou um de mais de 30 MB para imagens ou 1 GB para vídeos.
- Criar o container no momento do agendamento. Os containers expiram ao fim de 24 horas, por isso um criado uma semana antes já não existe na hora da publicação.
- Pôr imagens PNG ou HEIC na fila. A API do Instagram publica só JPEG, por isso converta-as antes de agendar.
- Agendar mais publicações num dia do que o limite permite. A Meta recusa publicações acima de 100 em 24 horas móveis quando são publicadas; o easyCoexistence tenta de novo mais tarde e, se a Meta continuar a recusar, marca a publicação como falhada e envia um e-mail ao titular.
A API do Instagram não tem hora de publicação própria, por isso o easyCoexistence mantém a fila: peça ao Claude, ao ChatGPT ou ao seu próprio agente de IA para publicar uma fotografia, um carrossel, um Reel ou uma Story numa data e hora, e o easyCoexistence publica-a nessa altura através da API oficial da Meta. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
O que acontece se uma publicação agendada no Instagram falhar?
Se a Meta a recusar por ultrapassar o limite diário, o easyCoexistence tenta de novo mais tarde; se a Meta continuar a recusar, ou a recusar por outro motivo, a publicação é marcada como falhada e é enviado um e-mail ao titular.
Posso alterar uma publicação agendada no Instagram?
Sim, até ser publicada: update_scheduled_post altera a hora ou a legenda, e cancel_scheduled_post remove-a. Para alterar o ficheiro, cancele a publicação e agende-a de novo.
Podem ser agendados Reels e Stories?
Sim. Fotografias, carrosséis, Reels e Stories podem ser todos agendados, e cada um segue as mesmas regras de publicação de uma publicação feita de imediato.
Com quanta antecedência se pode agendar uma publicação no Instagram?
De 1 minuto a 90 dias à frente com o easyCoexistence, indicado em scheduled_at como uma data e hora ISO 8601 com fuso horário.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em