Erro "Invalid platform app" no início de sessão do Instagram: o que verificar
"Invalid platform app" aparece quando a janela de início de sessão do Instagram, https://www.instagram.com/oauth/authorize, não aceita a app indicada em client_id. Verifique primeiro esse valor: o Business Login for Instagram recebe o ID da app do Instagram, apresentado em Instagram, na configuração da API com início de sessão do Instagram, no painel da aplicação, e não o ID da app da Meta no topo do painel, que usam o Facebook Login e o Unified Login.
A app da Meta do easyCoexistence executa o Business Login for Instagram por si: escolha «New connection» e depois Instagram, inicie sessão com a conta Business ou Creator e aprove as permissões, e o Claude, o ChatGPT ou a sua própria plataforma podem publicar, responder a comentários e mensagens privadas e ler as estatísticas através da API oficial da Meta.
Recebe o ID da app do Instagram, encontrado nas definições de início de sessão empresarial, no Business Login for Instagram.
O Facebook Login for Business usa o ID da app da Meta; o Business Login for Instagram usa o ID da app do Instagram.
O redirect_uri tem de coincidir com um URI de redirecionamento OAuth guardado; o painel pode ter acrescentado uma barra final.
O tipo de app necessário para que uma app possa adicionar o produto Instagram.
O que a troca de código do Unified Login usa, com o segredo da app da Meta, em vez do ID e do segredo da app do Instagram.
O que significa "Invalid platform app"?
A janela de autorização do Instagram não reconhece a app do pedido como uma que autentica pessoas. A documentação da Meta não lista a mensagem em si, mas indica o que essa janela, https://www.instagram.com/oauth/authorize, aceita: uma app que tenha o produto Instagram com a configuração da API com início de sessão do Instagram, identificada pelo ID da app do Instagram. Um pedido que indique outro ID de app fica fora disso.
Que ID de app vai em client_id?
O ID da app do Instagram. Uma app da Meta que usa o Instagram Login apresenta dois IDs: o ID da app da Meta no topo do painel da aplicação, que o Facebook Login for Business usa, e o ID da app do Instagram, que o Business Login for Instagram recebe como client_id. O segredo da app fica emparelhado com ele na troca do token. O guia de início de sessão da Meta indica o caminho até ele:
Como se constrói o URL de autorização?
Com os quatro parâmetros obrigatórios e um state opcional, tal como a referência da Meta os indica. O Embed URL, no mesmo passo «Set up Instagram business login» do painel da aplicação, é uma versão pronta que já inclui o ID da app do Instagram e os âmbitos.
https://www.instagram.com/oauth/authorize
?client_id=<INSTAGRAM_APP_ID>
&redirect_uri=https://app.example.com/instagram/callback
&response_type=code
&scope=instagram_business_basic,instagram_business_content_publish
&state=<CSRF_TOKEN>O que mais tem de coincidir no pedido?
Mais três parâmetros têm de estar corretos, cada um tal como descreve o guia de início de sessão da Meta:
redirect_uri: uma coincidência exata com um URI guardado em Definições de início de sessão empresarial, URIs de redirecionamento OAuth; o painel pode ter acrescentado uma barra final, por isso compare com a lista guardada.response_type: code.- scope:
instagram_business_basicmais as restantes permissões instagram_business_* que a app usa; os valores antigos business_* foram descontinuados a 27 de janeiro de 2025.
Que configuração da app o início de sessão do Instagram exige?
Apenas uma app que já tenha a configuração da API com início de sessão do Instagram. O guia de migração da Meta diz que as apps criadas de novo não podem configurar a API do Instagram com o Instagram Login, por isso uma app nova não tem ID de app do Instagram para enviar e autentica as pessoas através do Unified Login, com um URL de início de sessão que inclui um config_id. Numa app existente, o início de sessão empresarial configura-se no passo 3 da configuração da API com início de sessão do Instagram, com o URL de redirecionamento e os URIs de redirecionamento OAuth guardados.
O que acontece depois de o início de sessão funcionar?
O Instagram redireciona para o redirect_uri com um código, válido durante uma hora e utilizável uma só vez; retire o #_ que a Meta acrescenta no fim antes de o usar. O servidor troca-o em https://api.instagram.com/oauth/access_token com o ID e o segredo da app do Instagram, o mesmo redirect_uri e grant_type=authorization_code. Um código enviado duas vezes falha com Matching code was not found or was already used.
Precisa disto com o easyCoexistence?
Não. A app da Meta do easyCoexistence tem o Business Login for Instagram, por isso o titular da conta escolhe «New connection» e depois Instagram no painel, e aprova as permissões na própria janela do Instagram, enquanto o ID da app, o redirect URI e a troca do token ficam tratados por nós. As plataformas que ligam os seus clientes enviam-nos para um link de ligação alojado, obtido através da Partner API.
Erros comuns
- Copiar o ID no topo do painel da aplicação. Esse é o ID da app da Meta; o Business Login for Instagram recebe o ID da app do Instagram das suas definições de início de sessão empresarial.
- Retirar a barra final que o painel acrescentou a um redirect URI. A Meta exige uma coincidência exata com os URIs de redirecionamento OAuth guardados.
- Enviar valores de scope de exemplos antigos. business_basic e os restantes nomes business_* foram descontinuados a 27 de janeiro de 2025.
- Associar o ID da app do Instagram ao segredo da app da Meta na troca do token. O Instagram Login usa o ID e o segredo da app do Instagram em conjunto.
De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
O ID da app do Instagram é o mesmo que o ID da app da Meta?
Não. O Facebook Login for Business e o Unified Login usam o ID da app da Meta, enquanto o Business Login for Instagram usa o ID da app do Instagram apresentado nas suas próprias definições.
Como é que o Unified Login autentica as pessoas?
Com um URL de início de sessão que inclui um config_id da configuração no painel da aplicação, e uma troca de código que usa o ID e o segredo da app da Meta, e não os do Instagram.
O que significa error_reason=user_denied?
A pessoa cancelou o início de sessão. O Instagram redireciona com error=access_denied, error_reason=user_denied e error_description=The user denied your request, e a app deve tratar esse caso de forma adequada.
Preciso de uma app da Meta própria para ligar o Instagram ao easyCoexistence?
Não. A app da Meta do easyCoexistence detém as permissões do Instagram, por isso o titular da conta inicia sessão com o Instagram e aprova-as.
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