Agendando publicações no Instagram pela API
As publicações do Instagram são agendadas pela API mantendo cada uma em uma fila e publicando-a no horário escolhido, já que a chamada media_publish da Meta não recebe data. O publish_instagram_post da easyCoexistence recebe scheduled_at, um horário ISO 8601 com fuso, de 1 minuto a 90 dias à frente, e sua fila publica a foto, o carrossel, o Reel ou o Story nesse momento, dentro do limite de 100 publicações pela API em 24 horas.
O único parâmetro que media_publish recebe além do token, então a publicação vai ao ar quando essa chamada é feita.
Por quanto tempo um container de mídia dura sem ser publicado, curto demais para criá-lo dias antes do horário agendado.
Publicações feitas pela API por conta em 24 horas móveis, contadas quando cada container é publicado.
Onde a mídia deve estar no momento da tentativa de publicação, já que a Meta busca o arquivo por conta própria.
Como funciona o agendamento pela API do Instagram?
Segurando a publicação até o seu horário. Publicar exige duas chamadas: POST /<IG_ID>/media cria um container a partir da mídia, e POST /<IG_ID>/media_publish com o ID desse container põe a publicação no ar. Nenhuma das duas recebe data ou hora de publicação, então uma publicação agendada é aquela que o app mantém em sua própria fila e publica no momento escolhido.
Como agendar uma publicação pelo MCP?
Peça em linguagem simples. Com o conector da easyCoexistence adicionado ao Claude ou ao ChatGPT e a conta do Instagram conectada, uma instrução como "Agende este carrossel para sexta às 9h com esta legenda" basta: o assistente chama publish_instagram_post com scheduled_at, uma data e hora ISO 8601 com fuso, de 1 minuto a 90 dias à frente. A easyCoexistence copia a mídia no momento do agendamento, mantém a publicação na fila e a publica então. Podem ser agendadas fotos, carrosséis de 2 a 10 itens, Reels e Stories, com a mídia em uma URL HTTPS pública e as imagens em JPEG.
O que precisa ser verdade quando a publicação sair?
O mesmo que vale para uma publicação feita na hora:
- A mídia está em uma URL pública que a Meta consegue buscar durante a tentativa de publicação; a fila da easyCoexistence serve sua própria cópia, feita no momento do agendamento.
- As imagens são JPEG: a API do Instagram não publica outro formato de imagem, e formatos JPEG estendidos como MPO e JPS são recusados.
- Um vídeo terminou de ser processado: o
status_codedo container precisa estar FINISHED antes quemedia_publishtenha sucesso. - A conta tem espaço dentro do seu limite: 100 publicações pela API em 24 horas móveis, com um carrossel contando uma vez.
Por que o container não pode ser criado antecipadamente?
Porque ele expira. Um container de mídia que não é publicado em 24 horas fica como EXPIRED e precisa ser criado de novo, e uma conta pode criar 400 containers em 24 horas móveis. Uma fila que guarda publicações por dias ou semanas mantém a URL da mídia e a legenda, e cria o container perto do horário de publicação.
Publicações agendadas contam no limite diário?
Sim, no dia em que são publicadas. A Meta aplica o limite de 100 publicações pela API em 24 horas móveis na chamada media_publish, e recomenda que apps que permitem agendar publicações no futuro também apliquem esse limite. GET /<IG_ID>/content_publishing_limit informa quota_usage, o número de publicações que a conta fez pela API nas últimas 24 horas.
Erros comuns
- Agendar mídia a partir de um link que não abre. A easyCoexistence copia o arquivo no momento do agendamento e recusa uma página web, um arquivo inexistente, o tipo errado ou um arquivo acima de 30 MB para imagem ou 1 GB para vídeo.
- Criar o container no momento do agendamento. Containers expiram em 24 horas, então um criado uma semana antes já não existe na hora da publicação.
- Colocar na fila imagens em PNG ou HEIC. A API do Instagram publica apenas JPEG, então converta-as antes de agendar.
- Agendar mais publicações em um dia do que o limite permite. A Meta recusa publicações além de 100 em 24 horas móveis no momento da publicação; a easyCoexistence repete a tentativa mais tarde e, se a Meta ainda recusar, marca a publicação como falha e envia e-mail ao responsável.
A API do Instagram não tem horário de publicação próprio, então a easyCoexistence mantém a fila: peça ao Claude, ao ChatGPT ou ao seu próprio agente de IA para publicar uma foto, carrossel, Reel ou Story em uma data e hora, e a easyCoexistence a publica então pela API oficial da Meta. US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O que acontece se uma publicação agendada no Instagram falhar?
Se a Meta recusar por passar do limite diário, a easyCoexistence repete a tentativa mais tarde; se a Meta ainda recusar, ou recusar por qualquer outro motivo, a publicação é marcada como falha e o responsável recebe um e-mail.
Posso alterar uma publicação agendada no Instagram?
Sim, até ela sair: update_scheduled_post altera o horário ou a legenda, e cancel_scheduled_post a remove. Para trocar a mídia, cancele a publicação e agende-a de novo.
Reels e Stories podem ser agendados?
Sim. Fotos, carrosséis, Reels e Stories podem ser todos agendados, e cada um segue as mesmas regras de publicação de uma publicação feita na hora.
Com quanta antecedência uma publicação do Instagram pode ser agendada?
De 1 minuto a 90 dias à frente com a easyCoexistence, informados em scheduled_at como uma data e hora ISO 8601 com fuso.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em