Publicação agendada e APIs de plataformas

Instagram API de publicação de conteúdo (Instagram API de publicação de conteúdo)

Data de verificação do perfil:2026-11-11 · Organizado com base na documentação oficial de desenvolvedor da plataforma e na central de ajuda do fabricante

Definição:Instagram Content Publishing API é a interface oficial fornecida pela Meta na plataforma Instagram, permitindo que aplicativos de terceiros autorizados publiquem imagens únicas, vídeos únicos, Momentos, histórias e postagens em carrossel de até 20 materiais em nome de contas profissionais Instagram (contas de comerciante ou criador). A função "Instagram publicação automática/publicação direta" em ferramentas de gerenciamento de mídia social geralmente chama esse conjunto de interfaces na parte inferior: primeiro crie um contêiner de mídia e, em seguida, chame o endpoint de publicação no horário agendado.

Instagram Diagrama do processo da API de publicação de conteúdo: criar contêineres de mídia, fazer upload ou extrair materiais, verificar o status do contêiner, chamar media_publish para publicar e marcar a cota de publicação de 24 horas e a expiração de 24 horas do contêiner — SocialKit Diagrama esquemático original, compilado de acordo com o Meta for Developers' Content Publishing Guide e o documento de referência IG User Media, e não representa nenhuma interface de produto.

"Como funciona?"

Conexão de autorização: Os usuários autorizam por Facebook Login para Negócios ou Negócios Login para Instagram, obtendo permissões de publicação (como instagram_content_publish ou instagram_business_content_publish). Somente Instagram contas profissionais podem publicar através da API.
Criar um recipiente de mídia: Enviar um pedido para /{IG_ID}/media, anexar a URL pública e cópia da imagem ou vídeo, e obter um ID do recipiente. Meta irá ativamente pegar o material deste URL, por isso o material deve ser colocado em um servidor acessível ao público quando publicar tentativas; vídeos grandes também podem ser carregados através do upload resumible do rupload.facebook.com.
Especifique o tipo de conteúdo: os recipientes de vídeo usam media_type para distinguir entre VIDEO, REELS ou STORIES; para os carrossels, primeiro criem sub-containers para cada ativo (is_carousel_item=true), depois combinem-nos em um recipiente de carrossel usando media_type=CAROUSEL e crianças.
Verifique o estado do contêiner: o processamento de vídeo leva tempo; você pode consultar o status_code do contêiner, que pode devolver IN_PROGRESS, FINIÇADO, ERROR, EXPIRED, ou PUBLIADO. É oficialmente recomendado consultar uma vez por minuto por um máximo de 5 minutos.
Publicar: Passar criation_id (container ID) para /{IG_ID}/media_publish, e devolver o ID de mídia oficial após o sucesso. O chamado "release agendado" da ferramenta de agendamento é completar este passo na hora agendada.
Verificação de quotas: Antes de publicar, você pode consultar /{IG_ID}/content_publishing_limit para ver quantas vezes a conta publicou nas últimas 24 horas; é oficialmente recomendado que as aplicações também implementem seus próprios controles de quotas, especialmente para aplicações que suportam a agendação.

Resumo das regras e restrições fundamentais

Projecto	"Regras na documentação oficial"	Impacto sobre os usuários da ferramenta de agendamento
Tipos de conta	Somente suporta a publicação de Instagram contas profissionais (conta de negociante ou criador)	As contas pessoais não podem ser lançadas automaticamente. A ferramenta só pode ser alterada para empurrar lembretes, que você pode completar manualmente no seu telefone móvel.
Quota de libertação	A diretriz de publicação de conteúdos afirma que um máximo de 100 lançamentos de interface podem ser publicados dentro de 24 horas após o rolamento, e o carrossel conta como 1 itens; o parágrafo do carrossel e a página de referência content_publishing_limit do mesmo guia ainda escrevem 50 itens.	Os dois números são inconsistentes. Prevalece o total de quotas devolvido pela interface; deve ser deixada uma margem quando se programa um grande número de vezes.
"Conteúdo de mídia"	Os contentores caducam se não forem publicados no 24 horas; cada conta pode criar um máximo de 400 recipientes de todos os laminadores 24 horas	Os recipientes devem ser publicados dentro de 24 horas após a criação; agendar muitos dias com antecedência requer a ferramenta para criar o recipiente mais perto do tempo de publicação, e métodos específicos variam de acordo com a ferramenta
"Especificações da imagem"	Somente suporta JPEG, o tamanho máximo é 8 MB, a razão de aspecto deve ser entre 4:5 e 1.91:1; JPEG estendido como MPO e JPS não são suportados	As imagens com razões fora de alcance não podem ser publicadas automaticamente e precisam ser recortadas ou mudadas para publicação de lembretes
Especificações das bobinas	MOV ou MP4, duração de 3 segundos a 15 minutos, máximo de 300 MB, recomendado 9:16	Vídeos com duração fora da gama não podem ser publicados automaticamente.
Histórias	Duração 3 a 60 segundos, max 100 MB	Histórias com mais de 60 segundos precisam ser editadas
Carusel	Até 20 imagens ou vídeos; todas as imagens são recortadas para a proporção de aspecto da primeira imagem (predefinido 1:1)	Carusels mistos-racio podem ser cortados; é melhor unificar a razão antes de publicar.
Função não suportada	As etiquetas e filtros de compras não são suportados; as contas com Autorização de Publicação de Página incompleta não podem ser publicadas.	Posts com recursos como etiquetas de compras devem usar a publicação de lembretes ou ser completados dentro da aplicação

Regras são extraídas das diretrizes de publicação de conteúdos do Meta for Developers (pagina marcada com atualizações 2026-10-20), referência de mídia do usuário do IG (2026-09-28 atualizações), e referência de limite de publicação de conteúdo do usuário do IG (2024-07-23 atualizações), acessada em 2026-11-11. Meta irá ajustar versões e limites; consulte a documentação mais recente antes da integração ou compra.

Utilização comum

Publicação automática agendada: A ferramenta de agendamento de mídia social publica postagens de imagens, Reels, Histórias e carusels para você em horários agendados sem necessidade de abrir manualmente Instagram.
"Operações de Multi-conta e Equipe: Agências ou equipes de marca gerenciam calendários de conteúdo e aprovaçãos para múltiplas contas profissionais em um backend, com publicação via API após aprovação."
Integração com o desenvolvedor: Construa seu próprio sistema de conteúdo, backend de comércio eletrônico ou serviço de publicação de API (como uma interface de publicação multiplataforma unificada) para empurrar conteúdo para Instagram através dele.
Anotação de conformidade: is_ai_generated pode ser usada para auto-divulgar conteúdo gerado por AI ao criar um recipiente; um rótulo de parceiro (companheirismo pago) também pode ser adicionado ao acessar através de Facebook Login.
Monitoramento do estado de lançamento: Através do estado do contentor e da interface de quota de lançamento, a ferramenta indica a causa de falha e evita exceder o limite.

Limitações e Precauções

As contas pessoais não podem ser lançadas automaticamente: esta é uma limitação da interface em si, não um defeito de uma determinada ferramenta. Se você quiser publicar automaticamente, você precisa mudar sua conta para uma conta de comerciante ou criador.
Nem todos os recursos do aplicativo podem ser publicados via API: A documentação Meta afirma que as etiquetas de compras e filtros não são suportados; o Buffer Help Center também lista que recursos como música para postagens e histórias, links de histórias, texto de história ou adesivos, etiquetas de produtos e hashtags não podem ser publicados automaticamente por ferramentas de terceiros; adicionar estes resultará em um lembrete para publicar.
Especificações são mais rigorosas do que o aplicativo: As imagens são aceitas apenas no formato JPEG com razões de aspecto limitadas de 4:5 a 1.91:1; as ferramentas de agendamento geralmente não podem publicar automaticamente se excederem esta faixa.
Os ativos devem ser rastreáveis pelo Meta: Ao usar URLs, os ativos devem ser colocados em endereços acessíveis ao público; os links de rede interna ou links que exigem login falharão.
Há quotas de postação: existe um limite no número de posts dentro de um período de 24 hora rolante, e os números na documentação oficial variam entre diferentes páginas (100 vs 50); para agendamento em massa, o valor real devolvido pela API deve prevalecer.
A autorização da conta afeta as funcionalidades disponíveis: Por exemplo, Buffer explica que ao conectar contas profissionais via login Instagram, adicionar localização, colaboradores e adicionar música aos Reels durante a auto-publicação não é suportado; você deve usar um método de conexão associado a uma página inicial Facebook.
Autorização e status da Página: Se a Página ligada requer Autorização de Publicação da Página ou autenticação de dois fatores e não estiver concluída, as solicitações de publicação falharão; Meta recomenda que esta seja completada com antecedência.

Conceitos errôneos comuns

Se a ferramenta de agendamento mostrar 'Enviado', significa que o post já está ao vivo em Instagram?

Não necessariamente. Para as mensagens que lhe lembram de publicar, se a ferramenta mostrar que foi enviada, isso significa apenas que o lembrete foi empurrado para o seu telemóvel, e você ainda precisa completar a publicação na aplicação Instagram. Somente através da publicação automática da API de publicação de conteúdo, a ferramenta irá obter diretamente o ID de mídia publicado.

Se eu usar uma ferramenta de agendamento pago, minha conta pessoal também pode publicar automaticamente?

Não. A API de publicação de conteúdo só suporta contas profissionais, e se você paga ou não não altera isso. As contas pessoais só podem usar a publicação de lembretes em ferramentas como Buffer.

Desde que você possa enviar Reels, você pode usar a música em sua biblioteca de música?

Não necessariamente. Se funções como música podem ser lançadas automaticamente depende da interface da plataforma e do método de conexão. Buffer indica que a música para posts e histórias precisa ser postada como um lembrete, e automaticamente adicionar música para Reels requer conexão através da associação da página inicial Facebook.

A quota de publicação é reset em 0 pontos fixos todos os dias?

Não. O documento oficial escreve sobre um período de rolamento de 24 horas (período de movimento), não uma reset baseado em dias naturais; você pode usar content_publishing_limit para consultar o uso das últimas 24 horas.

Exemplo

A operação de uma marca de roupa organiza um post de carrossel de um grupo de 5 imagens para sexta-feira 20:00 na ferramenta de agendamento. Antes de chegar ao ponto, a ferramenta cria sub-containers para cada imagem e depois combina-os em um recipiente de carrossel. Após confirmar que o estado é FINIÇADO, o ponto final de publicação é chamado. O post vai on-line e é contado como 1 itens na quota de publicação hora da conta 24. Na mesma semana, ela também arranjou um post com uma etiqueta de produto. Como a interface não suporta etiquetas de compras, a ferramenta mudou-o para um post de lembrete, que foi empurrado para o seu telefone móvel na época. Ela acrescentou a etiqueta na aplicação Instagram e a posteou. Este exemplo está escrito de acordo com as regras do fluxo de documentação Meta e Buffer Centro de Ajuda e é para ilustração apenas.

Ferramentas que suportam a auto-publicação Instagram

A maioria das ferramentas de agendamento de liberação no diretório SocialKit suporta liberação automática para a conta profissional Instagram por meio da interface oficial. Existem também APIs de lançamento unificado para desenvolvedores como Ayrshare e Upload-Post. Cada ferramenta possui suporte diferente para detalhes como publicação de lembretes, música, localização, colaboradores, primeiros comentários, etc. Consulte a documentação de ajuda de cada produto.

Vá para Diretório de ferramentas SocialKit Ver todos os produtos e critérios de filtro.

Perguntas frequentes

Por que o meu post Instagram foi automaticamente alterado para "remender para publicar" na ferramenta de agendamento?

Razões comuns incluem: a conta é uma conta pessoal; a relação de aspecto de imagem ou vídeo excede o limite da API; a duração dos rebotes não é entre 3 segundos e 15 minutos; ou o post inclui recursos não suportados para auto-publicação pela API, como música, links de história, adesivos ou etiquetas de produtos. O Buffer Help Center lista estas condições como condições para a mudança automática para publicação de lembretes.

Instagram Preciso pagar pela API de publicação de conteúdo?

A documentação de publicação de conteúdo da Meta não lista os termos de cobrança por chamada; os desenvolvedores precisam criar aplicativos e obter níveis de acesso e permissões correspondentes. Quando usuários comuns utilizam a ferramenta de agendamento, o custo depende do pacote da própria ferramenta.

Quantas mensagens uma conta pode enviar automaticamente através da ferramenta todos os dias?

A diretriz de publicação de conteúdo Meta diz rolar 24 horas 100 itens (o carrossel conta como 1 itens), mas o parágrafo do carrossel e a página de referência de cota do mesmo guia ainda dizem 50 itens. O quota_total real retornado pela interface content_publishing_limit prevalecerá.

Os Reels auto-publicados serão tratados como vídeos regulares?

Ao consultar media_type para os Reels publicados via API, retorna VIDEO; você deve verificar o campo media_product_type para determinar se é um Reel; esta é uma discrepância de campo de dados, e a documentação Meta não indica que afeta a distribuição de Reels.

Fonte de informação

A página acima foi acessada em 2026-11-11. A interface da plataforma e as funções do produto podem ser ajustadas, consulte a documentação oficial.