Instagram

O que essa tela faz

Conecta a conta comercial do Instagram (@marcosmene1) via OAuth e mostra as métricas dos últimos 7 dias — perfil, gauges de seguidores/alcance/views/engajados/visitas, audiência (gênero, idade, top cidades, top países) e os posts com melhor desempenho. As métricas de audiência exigem uma segunda camada de segurança (Face ID/revalidação Apple, FaceGate) antes de aparecer.

Campo a campo

• Status da conexão — "Conectado como @[username]" (com botão Desconectar) ou "Instagram

ainda não conectado" (com botão Conectar).

• Avisos de retorno — depois do fluxo OAuth, a página pode mostrar "Instagram conectado com

sucesso." ou "Não deu pra conectar: [motivo]" conforme o parâmetro de retorno na URL.

• Perfil — foto, @usuário, nome, biografia, contagem de "seguindo" e "posts".
• Gauges de métricas (velocímetros) — Seguidores (total), Alcance (7 dias), Views (7 dias),

Engajados (7 dias), Visitas (ao perfil).

• Audiência — Gênero e Idade (barras, % sobre o total), Top cidades e Top países (ranking);

se a conta tiver menos de 100 seguidores ou faltar a permissão instagram_insights, mostra o aviso "Dados de audiência indisponíveis".

• Top posts — grade de miniaturas com curtidas/comentários/interações totais, cada uma

abrindo o post original no Instagram.

• Métricas com erro (não-crítico) — painel recolhível listando quais métricas específicas

falharam ao carregar, sem travar o resto da tela.

Ações disponíveis

• "Conectar Instagram" — abre /api/instagram/oauth/iniciar (fluxo OAuth da Meta).
• "Desconectar" — apaga o token e os dados de conexão salvos (ig_access_token,

ig_account_id, ig_username, ig_connected_at, ig_token_expires_at), voltando ao estado "não conectado".

• "Atualizar métricas" — recarrega os dados chamando /api/instagram/metricas de novo.
• Clicar num "Top post" — abre o post original no Instagram, em nova aba.

Dúvidas frequentes

P: Desconectei sem querer. Perdi as métricas históricas? R: Não — desconectar só remove o token de acesso; ao reconectar, as métricas voltam a carregar (o que a API do Instagram ainda mantiver disponível).

P: A seção de Audiência não aparece nem com erro. R: Ela só é exibida quando o FaceGate (segunda confirmação de identidade via Apple) é validado — se você não passou por essa etapa, o conteúdo fica bloqueado por segurança.

P: Aparece "N métrica(s) com erro (não-crítico)". R: Algumas métricas específicas falharam ao vir da API do Instagram, mas isso não impede o resto da tela de funcionar; clique para expandir e ver qual métrica e o motivo.

Erros comuns