EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Posts em carrossel do Instagram pela API

A API do Instagram publica um carrossel como um único post de até 20 fotos e vídeos, conforme o guia de publicação da Meta, embora a referência de erros ainda diga 10. Cada item recebe seu próprio container com is_carousel_item definido como true, e depois um container CAROUSEL lista os itens como filhos e traz a legenda. Publicar esse container posta todos juntos, contando como um dos 100 posts publicados pela API permitidos em 24 horas.

O easyCoexistence publica carrosséis de 2 a 10 fotos e vídeos com publish_instagram_post, a partir do Claude, do ChatGPT ou do seu próprio código: uma chamada com os itens e a legenda publica o post, e ele se conclui por conta própria enquanto um vídeo ainda está sendo processado.

Up to 20

Fotos e vídeos que um carrossel pode ter, segundo o guia de publicação da Meta e o parâmetro children.

2207028

Subcódigo, sob o código 100, cuja mensagem ainda diz que um carrossel precisa de 2 a 10 itens.

1 post

Como um carrossel é contado no limite de 100 posts publicados pela API em 24 horas.

1:1

Corte padrão das imagens do carrossel, que seguem a proporção da primeira imagem.

0

Insights que a Meta retorna para as fotos e vídeos individuais dentro de um carrossel.

Como um carrossel é publicado?

Em três etapas, todas por POST /<IG_ID>/media e uma única chamada de publicação.

  • Itens: crie um container para cada foto (image_url) ou vídeo (media_type VIDEO e video_url), com is_carousel_item definido como true e sem legenda.
  • Carrossel: crie um container com media_type CAROUSEL, children com os IDs dos containers dos itens separados por vírgulas, e a legenda.
  • Publicação: POST /<IG_ID>/media_publish com creation_id definido como o ID do container do carrossel.

Quantos itens um carrossel pode ter?

Até 20. O guia de publicação da Meta e o parâmetro children de POST /<IG_ID>/media fixam o limite em 20 imagens, vídeos ou uma combinação dos dois. A referência de erros ainda traz a versão antiga: a mensagem do código 100, subcódigo 2207028, diz que um carrossel precisa de no mínimo 2 e no máximo 10 itens. Portanto, 2 a 10 é a quantidade que todas as partes da documentação da Meta aceitam. Os itens podem ser fotos ou vídeos, mas não Reels: um item de carrossel é sempre um container de imagem ou vídeo.

Como as imagens do carrossel são cortadas?

Pela primeira. Todas as imagens do carrossel são cortadas na proporção da primeira imagem, e o padrão é quadrado 1:1. Cada imagem ainda precisa seguir as regras habituais: JPEG, até 8 MB, entre 4:5 e 1.91:1. Coloque primeiro a imagem cujo formato você quer, ou deixe todas no mesmo formato antes de publicar.

O que pertence ao carrossel e o que pertence a cada item?

A maioria das configurações do post fica no container do carrossel, não nos itens.

  • Legenda: somente no container do carrossel; os itens não recebem uma.
  • Localização: somente no container do carrossel.
  • Rótulo de conteúdo gerado por IA: is_ai_generated vai no container do carrossel, e definir o campo em um item retorna um erro.
  • Texto alternativo: suportado em itens de imagem, até 1,000 caracteres cada.

Como um carrossel é lido de volta?

Como um único objeto de mídia com media_type CAROUSEL_ALBUM. GET /<IG_MEDIA_ID>/children lista as fotos e vídeos dentro dele, embora alguns campos, como permalink, não funcionem nos filhos. As contagens de comentários e curtidas do carrossel excluem seus filhos, e a Meta não retorna insights para os itens individuais, apenas para o post do carrossel.

Como um carrossel conta nos limites?

Como um post. Uma conta pode publicar 100 posts pela API em 24 horas móveis, e um carrossel usa um deles, não importa quantos itens tenha. Cada item ainda é um container, porém, e uma conta pode criar 400 containers em 24 horas contínuas, então uma sequência de carrosséis de dez itens atinge esse teto antes do limite de publicação.

Erros comuns

  • Colocar a legenda em um item. Legendas não são suportadas em itens de carrossel; defina-a uma vez no container do carrossel.
  • Adicionar um Reel como item. Itens de carrossel são containers de imagem ou vídeo, e um Reel não pode aparecer em um carrossel.
  • Misturar fotos em retrato e paisagem sem checar a primeira. Cada imagem assume a proporção da primeira imagem.
  • Esperar insights por slide. A Meta não retorna nenhum para a mídia dentro de um carrossel, apenas para o post.
Fazendo isso com o EasyCoexistence

Carrosséis também podem ser agendados pela fila própria. De US$ 9 a US$ 0.75 por número conectado por mês, caindo à medida que você adiciona números, 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

É possível agendar um carrossel do Instagram pela API?

Sim, por meio de uma fila, já que a Meta publica o carrossel quando o container dele é publicado. O publish_instagram_post do easyCoexistence aceita scheduled_at, de 1 minuto a 90 dias à frente, para carrosséis de 2 a 10 itens.

Um carrossel pode ser rotulado como gerado por IA?

Sim, com is_ai_generated no container do carrossel. Definir o campo em um item retorna um erro.

Um carrossel pode incluir um Reel?

Não. Um Reel é sempre publicado sozinho, e os itens de carrossel são containers simples de imagem ou vídeo.

Por que meu carrossel falha com 2207028?

A mensagem da Meta para esse código diz que um carrossel precisa de no mínimo 2 e no máximo 10 itens. Uma quantidade de 2 a 10 atende tanto essa mensagem quanto o limite de 20 do guia de publicação, então ajuste os itens e crie o container do carrossel de novo.

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