⚠️ Atenção: grave no app correto

As funcionalidades de Instagram (Inbox de comentários e métricas de posts) ficam no CloudVarejo Support, não no CloudVarejo Core. Grave sempre no endereço abaixo:

https://app.support.cloud-varejo.com

O Core é o painel de configuração de canais (WhatsApp, Meta). O Support é a caixa de entrada de atendimento + posts + métricas — é onde a Meta precisa ver as permissões Instagram funcionando.

📋 Visão Geral — O que precisa ser (re)gravado

Permissões a regravar

  • instagram_business_manage_comments
    Vídeo 1 — ≈ 3–4 min
  • instagram_business_manage_insights
    Vídeo 2 — ≈ 1–2 min

Ordem recomendada de gravação

  1. Prepare o ambiente (checklist abaixo)
  2. Grave o Vídeo 2 primeiro (Insights — mais simples, aquece)
  3. Grave o Vídeo 1 (Comments — mais longo, 3 ações críticas)
  4. Revise os dois antes de enviar à Meta

☑️ Checklist Geral de Ambiente — Antes de apertar REC

  • Canal Instagram conectado no CloudVarejo Support via Instagram Business Login — token começa com IGAA, NÃO com EAA
  • Webhook comments ativo no canal (visível em Configurações → Canais → detalhes do canal)
  • Conta Instagram pessoal de teste pronta para comentar (celular ou aba separada com sessão diferente)
  • Pelo menos 1 post publicado e visível na conta Instagram Business conectada
  • Usuário logado com papel SUPERVISOR ou OWNER (necessário para Posts + Métricas)
  • Nenhuma chave de API, token, senha ou dado sensível visível na tela durante a gravação
  • Notificações do sistema desligadas (não-perturbe / modo foco ativo)
  • Resolução de tela mínima 1280×720, zoom do browser em 100%
1
Vídeo 1 — Gerenciar Comentários do Instagram
instagram_business_manage_comments
⏱ 3–4 min

O que a Meta precisa ver neste vídeo

  • Conversa do tipo INSTAGRAM_COMMENT na Caixa de Entrada, com badge COMENTÁRIO e banner Mensagem pública
  • Card PUBLICAÇÃO na barra lateral (miniatura do post, legenda, permalink)
  • Ação Responder: resposta aparece abaixo do post no Instagram
  • Ação Ocultar (escudo/olho): comentário some da visão pública — ESTAVA FALTANDO NA GRAVAÇÃO ANTERIOR
  • Ação Excluir: comentário removido permanentemente — ESTAVA FALTANDO NA GRAVAÇÃO ANTERIOR

☑️ Pré-requisitos — Antes de apertar REC

  • Abrir https://app.support.cloud-varejo.com e fazer login como SUPERVISOR
  • Canal Instagram Business conectado (tipo INSTAGRAM_DM, token IGAA…, webhook comments ativo)
  • Post publicado e visível no perfil Instagram Business
  • Conta Instagram pessoal de teste pronta num segundo dispositivo/aba — você vai comentar 3× durante a gravação
  • Caixa de entrada limpa (sem conversas em cima que atrapalhem)
  • Card PUBLICAÇÃO visível na sidebar (não minimizado)

🎬 Passo a Passo de Cenas

Cena 1 · 0:00–0:20
Login e Dashboard
  • Abra https://app.support.cloud-varejo.com — mostre a barra de endereço por 2 segundos
  • Digite as credenciais e faça login (MOSTRAR tela de login)
  • Dashboard carrega — mostre o ícone Caixa de Entrada na barra lateral esquerda
Cena 2 · 0:20–0:45
Confirmar Canal Instagram Business (IGAA token)
  • Clique em Configurações → Canais na barra lateral
  • MOSTRAR o canal Instagram com tipo INSTAGRAM_DM e status ativo
  • NARRAR "Este canal está conectado via Instagram Business Login" — aponte para o status ativo
  • ⚠️ NÃO mostre o token ou chave de API — role a tela para cima se houver campos sensíveis visíveis
Cena 3 · 0:45–1:15
Postar comentário de teste (conta pessoal)
  • Mude para o segundo dispositivo/aba com a conta Instagram pessoal de teste
  • Navegue até o perfil da conta Instagram Business conectada
  • Localize qualquer post publicado e poste: "Olá, gostaria de mais informações sobre este produto!"
  • MOSTRAR o comentário aparecendo abaixo do post
Cena 4 · 1:15–1:45
Comentário aparece na Caixa de Entrada
  • Volte ao CloudVarejo Support e abra a Caixa de Entrada
  • MOSTRAR a nova conversa no topo da lista
  • MOSTRAR o badge COMENTÁRIO no card da conversa — mostre claramente, faça zoom se necessário
  • MOSTRAR o nome do usuário Instagram do comentador no card
Cena 5 · 1:45–2:15
Abrir conversa — Mostrar contexto do post
  • Clique na conversa para abri-la
  • MOSTRAR o banner Mensagem pública no topo da conversa
  • MOSTRAR o card PUBLICAÇÃO na barra lateral direita: miniatura da imagem, legenda e permalink do post original
  • Role a barra lateral se necessário para que os três elementos fiquem visíveis ao mesmo tempo
  • NARRAR "Aqui o agente vê de qual post é o comentário, sem sair do dashboard"
Cena 6 · 2:15–2:45
Ação RESPONDER (Reply)
  • No compositor de mensagens na parte inferior, digite: "Olá! Estamos à disposição. Pode nos enviar uma DM para mais detalhes."
  • Clique em Enviar
  • MOSTRAR a resposta aparecendo no thread da conversa
  • Mude para a conta Instagram pessoal de teste e MOSTRAR a resposta abaixo do post original
Cena 7 · 2:45–3:15
Ação OCULTAR — CRÍTICO — estava faltando
  • Volte ao CloudVarejo Support, ainda na mesma conversa
  • Passe o cursor (ou toque) sobre a bolha do comentário original na conversa
  • MOSTRAR as opções de ação aparecendo (ícone de escudo/olho)
  • Clique em Ocultar — o clique deve ser explicitamente visível na gravação. Não pule, não acelere.
  • MOSTRAR o indicador de "ocultado" aparecendo na bolha do comentário no dashboard
  • Abra uma aba anônima / incógnito e acesse o post no Instagram — MOSTRAR que o comentário não aparece mais para usuários deslogados
  • NARRAR "O comentário foi ocultado — o autor ainda o vê, mas outros usuários não"
Cena 8 · 3:15–3:45
Ação EXCLUIR — CRÍTICO — estava faltando
  • Mude para a conta Instagram pessoal de teste e poste um segundo comentário: "Segundo comentário de teste"
  • Volte ao CloudVarejo Support — MOSTRAR o novo comentário aparecendo na mesma conversa
  • Passe o cursor sobre a bolha do segundo comentário
  • Clique em Excluir — confirme o prompt se aparecer (MOSTRAR o clique claramente)
  • Mude para o Instagram e MOSTRAR que o comentário foi removido permanentemente do post
  • NARRAR "Comentário excluído permanentemente via API do Instagram"

🚫 Erros a Evitar (lições das gravações rejeitadas)

  • ❌A ação Ocultar não apareceu na gravação anterior — o clique deve ser explicitamente visível na tela. Não pule, não acelere este momento.
  • ❌A ação Excluir estava completamente ausente — sem ela, a Meta não consegue verificar a permissão DELETE /{comment_id}. Esta cena é obrigatória.
  • ❌Não mostrar o badge COMENTÁRIO claramente — a Meta precisa ver que é uma conversa de tipo INSTAGRAM_COMMENT, não uma DM comum.
  • ❌Não mostrar o card PUBLICAÇÃO na sidebar — a Meta verifica que o contexto do post é exibido ao agente.
  • ❌Mostrar token IGAA, chave de API, senha ou qualquer dado interno na tela — feche ou role para longe de campos sensíveis antes de gravar.
  • ❌Usar um canal com token EAA (Facebook Login legado) — a permissão revisada é do Instagram Business Login (IGAA). Verifique o token antes de gravar.
2
Vídeo 2 — Métricas de Publicações do Instagram
instagram_business_manage_insights
⏱ 1–2 min

O que a Meta precisa ver neste vídeo

  • Supervisor abre Posts → aba Publicações no CloudVarejo Support
  • Seleciona o canal Instagram Business Login (token IGAA)
  • Clica no botão Métricas de um post publicado
  • Painel de métricas exibe números reais: Alcance, Salvamentos, Compartilhamentos, Interações Totais
  • NÃO aparece a mensagem de erro "Detalhes da publicação indisponíveis"

☑️ Pré-requisitos — Antes de apertar REC

  • Abrir https://app.support.cloud-varejo.com e fazer login como SUPERVISOR ou OWNER
  • Canal Instagram Business Login ativo (token IGAA…) — NÃO use canal com token EAA
  • Pelo menos 1 post com status PUBLICADO na conta Instagram Business conectada
  • Confirme que as métricas carregam antes de gravar — abra o painel de métricas de teste e verifique que aparecem números reais (não a mensagem de erro)

🎬 Passo a Passo de Cenas

Cena 1 · 0:00–0:20
Login e navegar para Posts
  • Abra https://app.support.cloud-varejo.com — mostre a barra de endereço
  • Faça login com conta de SUPERVISOR
  • Na barra lateral esquerda, clique em Posts
Cena 2 · 0:20–0:35
Selecionar canal Instagram Business Login
  • Na página de Posts, use o seletor de canal para escolher o canal Instagram Business conectado
  • MOSTRAR que o canal selecionado é o Instagram (ícone + nome da conta)
  • A aba Publicações carrega a lista de posts publicados
Cena 3 · 0:35–0:50
Localizar post publicado
  • MOSTRAR a lista de posts com pelo menos um com status PUBLICADO
  • Aponte para o post — mostre a miniatura e a legenda
Cena 4 · 0:50–1:20
Clicar em Métricas — Painel com números reais
  • Clique no botão Métricas (ou ícone de gráfico) na linha do post publicado
  • MOSTRAR o painel de métricas se expandindo
  • MOSTRAR números reais em: Alcance, Salvamentos, Compartilhamentos, Interações
  • CRÍTICO NÃO deve aparecer: "Detalhes da publicação indisponíveis até a aprovação das permissões"
  • NARRAR "Aqui estão os dados reais de alcance e engajamento da publicação, carregados via Graph API do Instagram"
Cena 5 · 1:20–1:35
Confirmar — Encerrar gravação
  • Percorra lentamente o painel de métricas para que todos os valores fiquem visíveis
  • Se tiver um post de vídeo disponível, clique em Métricas nele também e mostre que Views de vídeo aparece
  • Encerre a gravação com o painel de métricas visível

🚫 Erros a Evitar

  • ❌Mostrar o painel com a mensagem "Detalhes da publicação indisponíveis" — verifique que a API retorna métricas reais antes de gravar. Se aparecer esse erro, o fix de métricas (instagramInsightsService.ts) precisa estar deployado em produção.
  • ❌Usar canal com token EAA (Facebook Login legado) — a permissão revisada é instagram_business_manage_insights que usa token IGAA. Cheque o canal antes de gravar.
  • ❌Não selecionar o canal no seletor de canal — sem isso, posts de outras redes podem aparecer e confundir o revisor da Meta.
  • ❌Mostrar métricas zeradas sem narrar — se os números forem 0 (post novo), diga explicitamente que está exibindo dados reais da API (não um erro ou fallback).
  • ❌Mostrar qualquer token, chave de API ou dado interno na tela durante a gravação.
💡 Dicas Gerais de Gravação

Antes de enviar à Meta

  • Assista os vídeos completos antes de submeter
  • Confirme que cada ação (Ocultar, Excluir, Métricas) está visivelmente clicada
  • Confirme que nenhuma informação sensível apareceu na tela
  • Resolução mínima 1280×720, áudio ou narração recomendada

Verificar canal antes de gravar

Acesse Configurações → Canais no Support App e confirme:

  • Tipo: INSTAGRAM_DM
  • Status: ativo (verde)
  • Token iniciando com IGAA (não EAA)

⚠️ Fix de métricas — confirme antes do Vídeo 2

O fix de métricas (instagramInsightsService.ts) que corrige os campos por tipo de mídia (IMAGE, VIDEO, CAROUSEL_ALBUM) precisa estar em produção antes de gravar. Para confirmar: abra qualquer post publicado, clique em Métricas, e verifique que aparecem números reais (não "indisponíveis"). Se não aparecer, chame o time técnico antes de gravar.