Insights de Stories através da API
O endpoint de insights de conteúdo multimédia do Instagram devolve estas métricas de um Story enquanto estiver no ar: alcance, visualizações, respostas, partilhas, navegação, seguimentos, profile_visits, profile_activity, reposts e total_interactions. navigation divide-se por story_navigation_action_type em TAP_FORWARD, TAP_BACK, TAP_EXIT e SWIPE_FORWARD. As métricas de Stories ficam disponíveis durante 24 horas, valores abaixo de 5 devolvem o erro 10, e com o Instagram Login não existe webhook story_insights.
O easyCoexistence lê os insights de um Story com get_social_insights enquanto está no ar, para que o Claude, o ChatGPT ou o seu próprio código possam perguntar como correram os Stories de hoje e obter alcance, visualizações, respostas, partilhas e navegação diretamente da Meta para a conta ligada.
Durante quanto tempo as métricas de Stories ficam disponíveis pela API.
Devolvido em vez de um valor quando uma métrica de Story é inferior a 5: não há visualizadores suficientes para a multimédia mostrar insights.
A única configuração que o guia de insights da Meta dá ao webhook story_insights; não é suportada com o Instagram Login.
O valor de respostas de um Story criado por uma conta na Europa ou no Japão.
Quando a Meta acrescentou link_clicks para Stories, contando toques em links como os autocolantes de ligação, só para o Facebook Login.
Que métricas devolve um Story?
As que a referência de insights de multimédia da Meta lista para media_product_type STORY, lidas com GET /<STORY_MEDIA_ID>/insights enquanto o Story estiver no ar. Com o Instagram Login, o pedido vai para graph.instagram.com com um token que tenha instagram_business_basic e instagram_business_manage_insights, e period é sempre lifetime:
Como se lê a navegação por ação?
Peça navigation sozinha com breakdown=story_navigation_action_type. O total vem em total_value.value e cada ação em total_value.breakdowns[].results, que somam esse total: TAP_FORWARD (Avançar), TAP_BACK (Recuar), TAP_EXIT (Sair) e SWIPE_FORWARD (Story seguinte). A resposta de exemplo da Meta escreve os valores em minúsculas:
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
?metric=navigation
&breakdown=story_navigation_action_type
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "navigation",
"period": "lifetime",
"values": [{ "value": 25 }],
"total_value": {
"value": 25,
"breakdowns": [
{
"dimension_keys": ["story_navigation_action_type"],
"results": [
{ "dimension_values": ["tap_forward"], "value": 19 },
{ "dimension_values": ["tap_back"], "value": 4 },
{ "dimension_values": ["tap_exit"], "value": 1 },
{ "dimension_values": ["swipe_forward"], "value": 1 }
]
}
]
},
"id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
}
]
}Durante quanto tempo ficam disponíveis as métricas de Stories?
24 horas. A Meta disponibiliza as métricas de multimédia de Stories só durante 24 horas, a vida própria do Story, embora os dados por trás delas possam atrasar até 48 horas. Leia-as de forma programada enquanto o Story estiver no ar e guarde os últimos valores obtidos. A Meta indica que os dados podem continuar a chegar depois de o Story expirar, se for acrescentado a um destaque, e que as chamadas à API, os webhooks e a aplicação podem então mostrar resultados diferentes.
Porque devolve uma métrica de Story o erro 10?
Porque o seu valor é inferior a 5. A Meta devolve o código de erro 10 com a mensagem (#10) Not enough viewers for the media to show insights em vez de um número pequeno, por isso um Story visto por poucas pessoas pode falhar enquanto outro mais visto funciona. Trate-o como uma contagem baixa e não como uma avaria, e não o repita num ciclo.
Porque é que as respostas de um Story são 0?
Regras regionais. As respostas de pessoas na Europa, desde 1 de dezembro de 2020, e no Japão, desde 14 de abril de 2021, ficam de fora da métrica de respostas, e um Story criado por uma conta numa dessas regiões devolve 0. A referência da Meta define as respostas como IG Comments no objeto de multimédia do Story.
Existe um webhook story_insights?
Não com o Instagram Login. A tabela de campos da Meta marca story_insights como indisponível ali, a referência de insights de multimédia diz que o webhook de insights não é suportado com o Instagram Login, e o guia de insights lista story_insights apenas para o Facebook Login. Com o Facebook Login, o campo dispara quando um Story expira, traz só as primeiras 24 horas de métricas e devolve as contagens abaixo de 5 como -1.
Quais métricas de Stories foram retiradas ou limitadas?
Alguns nomes ainda aparecem em código antigo ou no changelog da Meta:
- impressions: obsoleta para conteúdos criados após 2 de julho de 2024, por isso um Story atual apresenta visualizações.
taps_forward,taps_backe exits: retiradas em 11 de dezembro de 2023; navigation, desagregada porstory_navigation_action_type, apresenta as mesmas ações.link_clicks: toques em links como os autocolantes de ligação, acrescentados em 22 de junho de 2026 só para o Facebook Login.total_views: visualizações em todas as superfícies, incluindo multimédia promovida, disponível apenas com o Facebook Login.
Como é que get_social_insights lê um Story?
Com o ID de multimédia do Story como object_id, que publish_instagram_post devolve como media_id quando publica o Story, e as métricas como lista. Peça navigation numa chamada separada com params definido como breakdown story_navigation_action_type, pois uma desagregação que uma métrica pedida não suporta faz falhar a chamada inteira. Os erros da Meta, incluindo o erro 10, chegam tal como a Meta os escreveu.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Erros comuns
- Ler as métricas de um Story no dia seguinte. A Meta só as disponibiliza durante 24 horas, por isso recolha-as enquanto o Story estiver no ar.
- Repetir o erro 10 num ciclo. Significa um valor inferior a 5, ou seja, poucos visualizadores, e não muda até mais pessoas verem o Story.
- Pedir navigation com uma desagregação junto de outras métricas. story_navigation_action_type funciona só com navigation, e uma desagregação não suportada faz falhar a chamada inteira.
- Esperar por story_insights com o Instagram Login. A Meta não oferece esse webhook ali, por isso consulte o endpoint de insights antes de o Story expirar.
Os Stories são publicados com publish_instagram_post. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
As métricas de Stories mudam depois de um Story ser acrescentado a um destaque?
Podem mudar. A Meta diz que um Story acrescentado a um destaque pode continuar a receber dados depois de expirar, por isso a API, os webhooks e a aplicação podem discordar durante algum tempo.
O total_views funciona para Stories com o Instagram Login?
Não. O total_views, que conta visualizações em todas as superfícies incluindo multimédia promovida, é oferecido só com o Facebook Login; com o Instagram Login, peça visualizações.
A API consegue ler os cliques em autocolantes de ligação de um Story do Instagram?
Só com o Facebook Login. A Meta acrescentou link_clicks para Stories a 22 de junho de 2026, contando toques em links como os autocolantes de ligação, e não o oferece com o Instagram Login.
O que substituiu taps_forward, taps_back e exits?
navigation, desagregada por story_navigation_action_type em TAP_FORWARD, TAP_BACK, TAP_EXIT e SWIPE_FORWARD. As métricas antigas foram retiradas a 11 de dezembro de 2023.
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