Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

Up to 20

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

2207028

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

1 post

Quanto conta um carrossel no limite de 100 publicações feitas pela API em 24 horas.

1:1

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

0

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_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: faça POST /<IG_ID>/media_publish com creation_id igual 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_generated vai 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.
Fazer isto com a EasyCoexistence

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