Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Publicar Stories do Instagram através da API

A API do Instagram publica um Story a partir de uma imagem ou de um vídeo num URL público: cria um contentor com media_type STORIES e depois publica-o. As imagens são JPEG até 8 MB, os vídeos têm entre 3 e 60 segundos e até 100 MB, a Meta recomenda um enquadramento 9:16, e o Story desaparece ao fim de 24 horas, tal como na aplicação.

A easyCoexistence publica Stories de imagem e de vídeo com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código, e pode agendá-los a partir da sua própria fila.

60 s

O vídeo de Story mais longo que a API publica; o mais curto tem 3 segundos, e o ficheiro pode chegar a 100 MB.

8 MB

A maior imagem de Story, que tem de ser um JPEG.

24 hours

Durante quanto tempo um Story publicado fica visível antes de expirar.

Under 5

Valores de métricas de Story tão baixos voltam como erro 10, audiência insuficiente, em vez de um número.

Como se publica um Story?

Com as mesmas duas chamadas de qualquer publicação. POST /<IG_ID>/media com media_type definido como STORIES e image_url ou video_url, depois POST /<IG_ID>/media_publish com o ID do contentor. Um Story em vídeo é processado primeiro, por isso o status_code do contentor tem de indicar FINISHED antes de poder ser publicado.

A referência da Meta descreve a legenda para fotografias, vídeos e carrosséis, não para Stories, por isso as palavras destinadas ao espectador devem ficar na própria imagem ou vídeo.

Quais são os requisitos multimédia dos Stories?

A Meta recomenda um enquadramento 9:16 para imagens e vídeos de Story, para evitar cortes ou espaço em branco.

  • Imagem: JPEG, até 8 MB, em sRGB; outros espaços de cor são convertidos.
  • Vídeo: MOV ou MP4 com vídeo H.264 ou HEVC e áudio AAC, 23 a 60 fotogramas por segundo, até 1920 píxeis de largura e 25 Mbps.
  • Duração do vídeo: 3 a 60 segundos, com um ficheiro até 100 MB.
  • Proporção do vídeo: é aceite qualquer valor entre 0.1:1 e 10:1.

O que pode conter um Story?

A própria imagem ou vídeo, e menções a outras contas: desde julho de 2025, o parâmetro user_tags identifica contas públicas em Stories de imagem e de vídeo, com as coordenadas x e y opcionais. A Meta não suporta a publicação de autocolantes pela API, por isso as ligações, sondagens e localizações ficam na aplicação.

O que acontece depois de um Story ser publicado?

Fica visível durante 24 horas e depois expira, tal como na aplicação. A Meta lista os Stories em direto numa lista separada, a stories edge; a lista de media da conta, GET /<IG_ID>/media, não os inclui. Ao ler de volta, o media_type de um Story é IMAGE ou VIDEO, como qualquer outro conteúdo, por isso distinga os Stories pelo sítio onde os encontrou e não pelo tipo.

Como chegam as respostas e as menções?

Como mensagens diretas. Uma resposta a um Story chega à conta como mensagem direta (DM) no webhook messages, com o ID e o URL do Story anexados, e abre a habitual janela de 24 horas para responder. Quando alguém menciona a conta no seu próprio Story, isso chega também como mensagem, com um anexo do tipo story_mention. A API de Menções da Meta não abrange Stories.

Que métricas reporta um Story?

Alcance, visualizações, partilhas, respostas, seguimentos, visitas ao perfil, atividade do perfil, navegação, cliques em ligações, reenvios e interações totais, lidos através do endpoint de insights de media. Estão disponíveis apenas durante 24 horas, e um valor inferior a 5 devolve o código de erro 10, audiência insuficiente, em vez de um número. As respostas de pessoas na Europa e no Japão ficam fora da contagem, e um Story criado por uma conta desses países reporta 0 respostas.

Erros comuns

  • Planear um autocolante de ligação. A API não publica autocolantes, por isso a ligação tem de chegar às pessoas de outra forma, por exemplo como resposta por DM.
  • Ler as métricas de um Story no dia seguinte. Estão disponíveis apenas durante 24 horas, por isso recolha-as enquanto o Story estiver visível.
  • Procurar um Story publicado na lista de media da conta. Os Stories em direto aparecem numa stories edge separada.
  • Publicar um vídeo horizontal como Story. A Meta recomenda 9:16, e outras formas podem mostrar espaço em branco ou ser cortadas.
Fazer isto com a EasyCoexistence

As respostas a um Story chegam como DM, que podem ser encaminhadas para o seu endpoint ou receber resposta de uma automação. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Posso adicionar um autocolante de ligação a um Story através da API?

Não. A Meta não suporta a publicação de autocolantes pela API, incluindo ligações, sondagens e localizações. Mencionar outra conta sem autocolante é possível.

Onde aparece um Story publicado na API?

Na stories edge separada da conta enquanto estiver em direto. O GET /<IG_ID>/media não inclui Stories, e um Story é lido como IMAGE ou VIDEO.

Um Story pode ter legenda através da API?

Não. A referência da Meta não descreve legenda para Stories, e publish_instagram_post envia um Story sem ela, por isso as palavras destinadas ao espectador devem ir na própria imagem ou vídeo.

Durante quanto tempo estão disponíveis os insights de um Story?

Durante 24 horas. A Meta só disponibiliza as métricas de um Story durante esse período, por isso leia-as enquanto o Story estiver visível.

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