Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

creation_id

O único parâmetro que media_publish aceita além do token, por isso a publicação fica online quando essa chamada é feita.

24 hours

Quanto tempo um container se mantém sem ser publicado, pouco para o criar dias antes de uma hora agendada.

100

Publicações feitas pela API por conta numa janela móvel de 24 horas, contadas quando cada container é publicado.

Public URL

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_code do seu container tem de indicar FINISHED antes de media_publish ter 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.
Fazer isto com a EasyCoexistence

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