Consultar alcance e evidências oficiais

Pré-requisitos

1. Instagram conectado e instagram_manage_insights concedida.
2. Conta elegível e métricas disponíveis pela versão da API.
3. Acesso à marca para consultar o diagnóstico.

Passo a passo no produto atual

1. Selecione a marca e abra Diagnóstico.
2. Consulte o diagnóstico salvo e sua data de leitura.
3. Quando autorizado, atualizar leitura e análise consulta o alcance; a análise com IA pode consumir créditos e é separada da consulta de perfil.
4. Confira alcance, período, fonte e limitações apresentados, sem preencher ausências com estimativas.

Erros e como proceder

1. Permissão ausente: alcance não é consultado.
2. Erro ou métrica indisponível: informe a limitação, não interprete como alcance zero.
3. Token revogado: reconecte a conta.

Limites e validação

1. Leitura de reach está implementada; apresentação e respostas positivas têm testes locais, mas leitura real com esse grant ainda não foi comprovada.
2. Não oferece todas as métricas de Instagram ou atribuição de vendas.
3. Curtidas e comentários em mídias não substituem Insights.

Consentimento e dados tratados

Somente dados autorizados são consultados. Atualizar análise é uma ação explícita e não publica nem altera o Instagram.

Alcance diário retornado pela Meta, data da consulta e evidências do diagnóstico, armazenados por marca.

Caso de uso para revisores Meta

Proposta condicionada à validação: instagram_manage_insights permite exibir alcance diário oficial dos últimos sete dias com fonte e data, apoiando diagnóstico comercial da conta autorizada. Métricas indisponíveis permanecem desconhecidas. Não submeter como pronto antes da leitura positiva real.

Roteiro de demonstração

1. Mostrar conta de teste com o grant correspondente.
2. Atualizar consulta e apresentar alcance real, período e fonte.
3. Mostrar como a interface identifica falta de acesso ou erro de métrica.

O que falta

Confirmar grant, resposta real e acesso do revisor antes de apresentar a permissão como validada.

Não grave segredos, credenciais ou dados de clientes. Funções planejadas não devem ser demonstradas como existentes.