Erros comuns do Instagram

A Graph API da Meta é mais opaca que a do LinkedIn — erros vêm crípticos. Aqui o que mais aparece e como resolver.

"User is not eligible to use this feature"

Causa: sua conta IG não está como Business ou Creator, ou não está vinculada a uma Página do Facebook.

Solução:

App do IG (mobile) → Configurações → Conta
Toca em Mudar pra conta profissional → escolhe Business ou Creator
Conecta a uma Página do FB (cria nova se não tem)
Volta no Fala Cheese → Conectar Instagram de novo

"Invalid OAuth access token"

Causa: token de acesso expirado. Tokens da Meta duram 60 dias com refresh, mas se você revogou no FB Settings ou trocou senha, o token morre.

Solução: /app/settings/connections → Reconectar Instagram. Refaz o OAuth, novo token vale por mais 60 dias.

"Aspect ratio is not supported"

Causa: imagem com aspect ratio fora dos limites do IG.

Limites:

Feed: entre 0.8 (4:5 vertical) e 1.91 (paisagem)
Carrossel: todos os slides precisam ter o mesmo aspect ratio
Reels: 9:16 obrigatório (1080x1920)

Solução: recorta a imagem antes de subir, ou usa um dos templates do Fala Cheese que já vêm em 1080x1080.

"Media URL must use HTTPS"

Causa: o Fala Cheese envia URL pública da imagem (R2 ou local) pra Meta processar. Em dev local sem HTTPS, falha.

Solução em dev:

Usa ngrok pra expor localhost:3000 como HTTPS
Ou configura R2 (Cloudflare) com certificado válido — recomendado pra produção

"The user has not authorized application"

Causa: o app do Fala Cheese foi removido do menu Apps and Websites dentro do FB.

Solução:

accounts.meta.com/business-portfolio → Apps connected
Se não tem Fala Cheese, vai direto pra /app/settings/connections e reconecta
Se tem mas inativo, remove e reconecta

"The post failed to publish because the duplicate API call"

Causa: você disparou 2 vezes o mesmo post (network flicker, refresh do composer no momento errado).

Solução: o post normalmente publica certo na primeira tentativa. Se duplicou, deleta o duplicado no IG mobile. Pra prevenir: não clica "Postar" 2x — espera o status mudar.

"Containers not ready"

Causa: API do Meta usa fluxo de container pra imagem/carrossel (cria container → adiciona mídia → publica). Se a mídia ainda tá sendo processada na ponta deles, o publish reclama.

Solução: o Fala Cheese tenta 3x com backoff de 5s. Se mesmo assim falha, é normal — re-tenta manualmente em 1-2 min.

Reels não tá saindo

Limitação atual: Reels via API não está habilitado no Fala Cheese MVP. Driver existe escondido, mas requer escopo extra que ainda não pedimos.

Workaround: gera vídeo no /app/library (8 estilos de slideshow), baixa MP4, sobe manual no IG mobile como Reel.

Carousel com vídeo dentro

Carrossel misto (imagem + vídeo no mesmo carrossel) não é suportado via API da Meta. Você precisa escolher: ou carrossel só de imagens, ou só de vídeos.

O composer do Fala Cheese assume só imagens no carrossel (PNG renderizado dos templates).

Hashtags zoadas

Se você usou mais de 5 hashtags ou hashtags banidas, o post sai mas com reach drasticamente menor. Não vem erro explícito — só nota o resultado.

Solução: máximo 5 hashtags. Evita as obviamente banidas (mudam de tempos em tempos; busca "lista hashtag banida 2026" pra ver atualizada).

"Permissions error" quando puxa Inbox

Causa: escopo instagram_manage_comments não foi aceito durante OAuth.

Solução: /app/settings/connections → Reconectar Instagram. No consent da Meta, aceita todos os escopos pedidos. Sem instagram_manage_comments, Inbox de IG fica vazio.