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.
Fotos e vídeos que um carrossel pode ter, segundo o guia de publicação da Meta e o parâmetro children.
Subcódigo, sob o código 100, cuja mensagem ainda diz que um carrossel precisa de 2 a 10 itens.
Como um carrossel é contado no limite de 100 posts publicados pela API em 24 horas.
Corte padrão das imagens do carrossel, que seguem a proporção da primeira imagem.
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_typeVIDEO evideo_url), comis_carousel_itemdefinido como true e sem legenda. - Carrossel: crie um container com
media_typeCAROUSEL, children com os IDs dos containers dos itens separados por vírgulas, e a legenda. - Publicação: POST /<
IG_ID>/media_publishcomcreation_iddefinido 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_generatedvai 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.
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