Publicações em carrossel no Instagram através da API
A API do Instagram publica um carrossel como uma só publicação com até 20 fotos e vídeos, segundo o guia de publicação da Meta, embora a sua referência de erros ainda indique 10. Cada item tem o seu próprio container, com is_carousel_item definido como true, e depois um container CAROUSEL lista-os como filhos e contém a legenda. Publicar esse container publica-os em conjunto, contando como uma das 100 publicações feitas pela API permitidas em 24 horas.
O easyCoexistence publica carrosséis de 2 a 10 fotos e vídeos com publish_instagram_post através do Claude, do ChatGPT ou do seu próprio código: uma chamada com os itens e a legenda publica a publicação, e esta conclui-se por si enquanto um vídeo ainda está a ser processado.
Fotos e vídeos que um carrossel pode conter, segundo o guia de publicação da Meta e o parâmetro children.
Subcódigo, dentro do código 100, cuja mensagem ainda diz que um carrossel precisa de 2 a 10 itens.
Quanto conta um carrossel no limite de 100 publicações feitas pela API em 24 horas.
Recorte predefinido das imagens do carrossel, que seguem a proporção da primeira imagem.
Estatísticas que a Meta devolve para as fotos e vídeos individuais dentro de um carrossel.
Como se publica um carrossel?
Em três etapas, todas através de POST /<IG_ID>/media e de 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: faça POST /<
IG_ID>/media_publishcomcreation_idigual ao ID do container do carrossel.
Quantos itens cabem num carrossel?
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 mistura dos dois. A referência de erros continua a dizer o antigo: a mensagem do código 100, subcódigo 2207028, diz que um carrossel precisa de pelo menos 2 e no máximo 10 itens, pelo que de 2 a 10 é a contagem 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 de vídeo.
Como são recortadas as imagens do carrossel?
Para a primeira. Todas as imagens de um carrossel são recortadas segundo a proporção da primeira imagem, sendo a predefinição um quadrado 1:1. Cada imagem tem de cumprir as regras habituais: JPEG, até 8 MB, entre 4:5 e 1.91:1. Coloque em primeiro lugar a imagem cuja forma pretende, ou faça com que todas tenham a mesma forma antes de publicar.
O que pertence ao carrossel e o que a cada item?
A maioria das definições ao nível da publicação fica no container do carrossel, e não nos itens.
- Legenda: apenas no container do carrossel; os itens não a aceitam.
- Localização: apenas no container do carrossel.
- Etiqueta de conteúdo gerado por IA:
is_ai_generatedvai no container do carrossel, e defini-lo num item devolve um erro. - Texto alternativo: suportado nos itens de imagem, até 1,000 caracteres cada.
Como um carrossel é lido de volta?
Como um único objeto multimédia com media_type CAROUSEL_ALBUM. GET /<IG_MEDIA_ID>/children lista as fotos e vídeos que contém, embora alguns campos, como permalink, não funcionem nos filhos. Os contadores de comentários e de gostos do carrossel excluem os seus filhos, e a Meta não devolve estatísticas para os itens individuais, apenas para a publicação do carrossel.
Como um carrossel conta para os limites?
Como uma publicação. Uma conta pode publicar 100 publicações através da API numa janela móvel de 24 horas, e um carrossel utiliza uma delas, qualquer que seja o número de itens. Cada item continua, porém, a ser um container, e uma conta pode criar 400 containers numa janela de 24 horas, pelo que uma série de carrosséis de dez itens atinge esse teto antes do limite de publicação.
Erros comuns
- Colocar a legenda num item. As legendas não são suportadas nos itens de carrossel; defina-a uma vez no container do carrossel.
- Adicionar um Reel como item. Os itens de carrossel são containers de imagem ou de vídeo, e um Reel não pode aparecer num carrossel.
- Misturar fotos na vertical e na horizontal sem verificar a primeira. Cada imagem assume a proporção da primeira imagem.
- Esperar estatísticas por diapositivo. A Meta não devolve nenhuma para os conteúdos dentro de um carrossel, apenas para a publicação.
Os carrosséis podem também ser agendados a partir da sua própria fila. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Um carrossel do Instagram pode ser agendado através da API?
Sim, através de uma fila, uma vez que a Meta publica um carrossel quando o seu container é publicado. O publish_instagram_post do easyCoexistence aceita scheduled_at, de 1 minuto a 90 dias de antecedência, para carrosséis de 2 a 10 itens.
Um carrossel pode ser marcado como gerado por IA?
Sim, com is_ai_generated no container do carrossel. Defini-lo num item devolve um erro.
Um carrossel pode incluir um Reel?
Não. Um Reel é sempre publicado sozinho, e os itens de carrossel são apenas containers de imagem ou de vídeo.
Porque é que o meu carrossel falha com 2207028?
A mensagem da Meta para esse erro diz que um carrossel precisa de pelo menos 2 e no máximo 10 itens. Uma contagem de 2 a 10 satisfaz essa mensagem e o limite de 20 do guia de publicação, pelo que ajuste os itens e crie de novo o container do carrossel.
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