Publicar Stories do Instagram pela API
A API do Instagram publica um Story a partir de uma imagem ou um vídeo em uma URL pública: crie um contêiner com media_type STORIES e depois publique o contêiner. As imagens são JPEG de até 8 MB, os vídeos têm de 3 a 60 segundos e até 100 MB, a Meta recomenda um quadro 9:16, e o Story desaparece após 24 horas, como no app.
O easyCoexistence publica Stories de imagem e vídeo com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código, e pode agendá-los na sua própria fila.
Maior vídeo de Story que a API publica; o menor tem 3 segundos, e o arquivo pode chegar a 100 MB.
Maior imagem de Story, que precisa ser JPEG.
Por quanto tempo um Story publicado fica no ar antes de expirar.
Valores de métrica de Story tão baixos voltam como código de erro 10, audiência insuficiente, em vez de um número.
Como um Story é publicado?
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 contêiner. Um Story em vídeo é processado primeiro, então o status_code do contêiner precisa estar em FINISHED antes de poder ser publicado.
A referência da Meta descreve a legenda para fotos, vídeos e carrosséis, não para Stories, então o texto destinado ao espectador deve ficar na própria imagem ou vídeo.
Quais são os requisitos de mídia do Story?
A Meta recomenda um quadro 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, de 23 a 60 quadros por segundo, até 1920 pixels de largura e 25 Mbps.
- Duração do vídeo: de 3 a 60 segundos, com arquivo de até 100 MB.
- Proporção do vídeo: qualquer valor de 0.1:1 a 10:1 é aceito.
O que um Story pode levar?
A própria imagem ou vídeo, e menções a outras contas: desde julho de 2025, o parâmetro user_tags marca contas públicas em Stories de imagem e vídeo, com as coordenadas x e y opcionais. A Meta não oferece suporte à publicação de adesivos pela API, então links, enquetes e localizações ficam no app.
O que acontece depois que um Story é publicado?
Ele permanece no ar por 24 horas e depois expira, como no app. A Meta lista os Stories ao vivo em uma edge de stories separada; a lista de mídias da conta, GET /<IG_ID>/media, não os inclui. Ao ser lido de volta, o media_type de um Story é IMAGE ou VIDEO, igual ao de qualquer outra mídia, então diferencie os Stories pelo lugar onde os encontrou, não pelo tipo.
Como chegam as respostas e menções?
Como mensagens diretas. Uma resposta a um Story chega à conta como DM no webhook de mensagens, com o ID e a URL do Story anexados, e abre a janela habitual de 24 horas para responder. Quando alguém menciona a conta no próprio Story, isso também chega como mensagem, com um anexo do tipo story_mention. A API de Menções da Meta não cobre Stories.
Quais métricas um Story informa?
Alcance, visualizações, compartilhamentos, respostas, seguidores, visitas ao perfil, atividade do perfil, navegação, cliques em links, republicações e interações totais, lidos pelo endpoint de insights de mídia. Eles ficam disponíveis apenas por 24 horas, e um valor abaixo de 5 retorna o código de erro 10, audiência insuficiente, em vez de um número. Respostas de pessoas na Europa e no Japão ficam fora da contagem, e um Story criado por uma conta de lá informa 0 respostas.
Erros comuns
- Planejar um adesivo de link. A API não publica adesivos, então um link precisa chegar às pessoas de outra forma, como por uma resposta em DM.
- Ler as métricas de Story no dia seguinte. Elas ficam disponíveis apenas por 24 horas, então colete-as enquanto o Story estiver no ar.
- Procurar um Story publicado na lista de mídias da conta. Stories ao vivo aparecem em uma edge de stories separada.
- Publicar um vídeo horizontal como Story. A Meta recomenda 9:16, e outros formatos podem mostrar espaço em branco ou sofrer cortes.
Respostas a um Story chegam como DMs, que podem ser encaminhadas ao seu endpoint ou receber resposta de uma automação. De US$ 9 a US$ 0.75 por número conectado por mês, caindo conforme 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
Posso adicionar um adesivo de link a um Story pela API?
Não. A Meta não oferece suporte à publicação de adesivos pela API, incluindo links, enquetes e localizações. Mencionar outra conta sem adesivo é suportado.
Onde um Story publicado aparece na API?
Na edge de stories separada da conta enquanto ele está no ar. GET /<IG_ID>/media não inclui Stories, e um Story é lido de volta como IMAGE ou VIDEO.
Um Story pode ter legenda pela API?
Não. A referência da Meta não descreve legenda para Stories, e o publish_instagram_post envia um Story sem legenda, então o texto destinado ao espectador vai na própria imagem ou vídeo.
Por quanto tempo os insights de Story ficam disponíveis?
Por 24 horas. A Meta disponibiliza as métricas de Story apenas por esse período, então leia-as enquanto o Story estiver no ar.
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