O Unified Login da Meta para o Instagram: o que é e o que muda para as apps em 2026
O Unified Login é a terceira configuração da API do Instagram da Meta e a que a empresa recomenda para novas integrações: um cliente inicia sessão com o Instagram ou através do Facebook Login, escolhe um portefólio empresarial e as contas do Instagram a partilhar, e a app recebe um único token de Business Integration System User. Novas funcionalidades da API do Instagram são lançadas apenas nesta configuração, enquanto as integrações existentes com Instagram Login continuam a funcionar, sem data de fim anunciada.
O easyCoexistence liga o Instagram através do Instagram Login: o proprietário inicia sessão com o Instagram e aprova cinco permissões, e o Claude, o ChatGPT ou a sua própria plataforma publica, agenda, responde a comentários e a mensagens diretas e lê estatísticas através da API oficial da Meta, com o token renovado e a conta verificada de 6 em 6 horas.
A Meta lança novas funcionalidades da API do Instagram apenas para a API do Instagram com Unified Login.
Para as integrações com Instagram Login, que continuam a funcionar, a Meta anunciará qualquer alteração no registo de alterações da Instagram Platform.
O guia de migração da Meta indica que as apps recém-criadas não podem configurar a API do Instagram com Instagram Login.
Abrange as contas que o cliente partilha e pertence ao portefólio empresarial do cliente, e não à pessoa que iniciou sessão.
Contas profissionais do Instagram que uma app pode convidar como testers do Instagram enquanto testa o Unified Login em modo de desenvolvimento.
O que é a API do Instagram com Unified Login?
Um único fluxo de início de sessão para dois tipos de cliente: as pessoas iniciam sessão com a sua conta do Instagram ou através do Facebook Login, e não é necessária nenhuma Página. Assente no Facebook Login for Business, pede ao cliente um portefólio empresarial, as contas do Instagram a partilhar e outros ativos extra, como uma conta de anúncios, e entrega depois à app um token para mensagens, publicação, moderação de comentários e, com permissões de anúncios, anúncios.
Em que se diferencia do Instagram Login?
Em quem inicia sessão, no que escolhe e no que a app guarda depois. O guia de migração da Meta compara as duas lado a lado; a terceira configuração, o Facebook Login, partilha com o Unified Login o host do Graph e as permissões instagram_*, mas exige que a conta esteja ligada a uma Página:
| Unified Login | Instagram Login | |
|---|---|---|
| Clients sign in with | Instagram, or Facebook Login | |
| Clients choose | A business portfolio, then the accounts to share | Nothing beyond the account signing in |
| App credentials | Meta app ID and app secret | Instagram app ID and app secret |
| Login link | A login URL with the configuration's config_id | An embed URL with the Instagram app ID and scopes |
| Access token | Business Integration System User, expiry set by the configuration | Instagram User, 60 days, refreshable |
| API host | Facebook Login's Graph host | graph.instagram.com |
| Account ID | GET /me/assigned_instagram_accounts | Returned with the token, or /me |
| Permissions | The instagram_* family | The instagram_business_* family |
| Business portfolio | Required | Not required |
O que só o Unified Login oferece?
A documentação da Meta apresenta estas opções em relação ao Instagram Login. A primeira e a última pertencem apenas ao Unified Login; as restantes são partilhadas com o Facebook Login, que exige uma Página:
- Novas funcionalidades da API do Instagram, que a Meta lança apenas para o Unified Login.
- Pesquisa de hashtags, marcação de produtos e anúncios de parceria, que a Meta indica como não suportados com o Instagram Login.
- A Audio API, a Collaboration API e o Business Discovery, documentados para o Facebook Login e para o Unified Login.
- Anúncios através da Marketing API e eventos através da Conversions API, com permissões de anúncios na configuração.
- Um token que pertence ao portefólio empresarial do cliente, pelo que continua a funcionar se a pessoa que iniciou sessão sair da empresa.
O que o Unified Login ainda não suporta?
Quatro coisas, que o guia de migração da Meta lista como em falta no lançamento. Uma app que dependa de alguma delas deve manter o Instagram Login por agora, como a Meta aconselha. Os clientes que iniciam sessão através do Facebook Login também têm de ativar eles próprios a opção Permitir acesso às mensagens na app do Instagram, visto que só o início de sessão no Instagram mostra esse passo:
- O Handover Protocol.
- Mudar uma conta pessoal para profissional durante o início de sessão; os clientes mudam primeiro na app do Instagram.
- Iniciar sessão através da app do Instagram: o início de sessão abre no navegador, pelo que os clientes precisam da palavra-passe do Instagram.
- O assistente de integração da API no painel da app.
Como é que uma app configura o Unified Login?
A partir de uma app que pertence a um portefólio empresarial, em Casos de uso, Gerir mensagens e conteúdos no Instagram, Personalizar e, depois, Configuração da API com Unified Login. O guia da Meta tem quatro passos, com o Acesso padrão atribuído às permissões da configuração assim que esta for guardada:
- Crie uma configuração com as permissões e os ativos a pedir, onde
instagram_basiceinstagram_manage_messagesestão sempre incluídas; guarde o URL de redirecionamento e copie o URL de início de sessão. - Gere tokens de teste convidando até 50 testers do Instagram, que aceitam em Permissões de website, Apps e websites, Convites para testers.
- Configure os webhooks no objeto Instagram da app da Meta e, depois, subscreva cada conta partilhada.
- Peça o Acesso avançado às permissões instagram_* através da App Review, com a app em modo Live.
Como mudam o token e as chamadas à API?
O código é trocado no servidor com o ID e o segredo da app da Meta, e não os do Instagram, por um token de Business Integration System User que pertence ao portefólio empresarial do cliente. Com esse token, /me devolve o utilizador de sistema, pelo que a app lê os IDs das contas a partir de GET /me/assigned_instagram_accounts e coloca um em cada caminho. O token deixa de funcionar se o cliente remover a app do portefólio ou mover a conta para outro.
O que deve fazer uma integração existente com Instagram Login?
Nada de urgente: a Meta diz que estas integrações continuam a funcionar e que qualquer alteração aparecerá no registo de alterações. Migrar traz as novas funcionalidades e custa uma revisão e uma nova ligação por cliente, nestes passos do guia de migração da Meta:
- Peça o Acesso avançado à correspondência instagram_* de cada permissão instagram_business_* em uso.
- Troque o URL de incorporação pelo URL de início de sessão da configuração, e as credenciais da app do Instagram pelas da app da Meta.
- Passe as chamadas para o ID da conta no host do Graph do Facebook Login; os IDs das mensagens chegam num formato diferente.
- Subscreva cada conta novamente, já que as subscrições do Instagram Login não transitam.
- Volte a ligar os clientes em pequenos grupos, mantendo cada token antigo até que uma chamada e um webhook funcionem.
Que permissões substituem quais?
O Unified Login usa as permissões instagram_* do Facebook Login for Business, e cada permissão instagram_business_* que uma app com Instagram Login tem hoje tem uma correspondência direta. Uma app que já tenha o Acesso avançado a elas, por exemplo de uma integração anterior com o Facebook Login, não o volta a pedir:
Que início de sessão utiliza o easyCoexistence?
O Instagram Login, dito com clareza. O easyCoexistence envia o proprietário para a página de autorização do próprio Instagram, com o seu ID de app do Instagram e cinco permissões instagram_business_*, troca o código no seu servidor por um token de 60 dias, lê a conta com GET /me e subscreve-a aos campos de webhook de comentários, mensagens e menções em graph.instagram.com. Com o Instagram Login, a Meta inclui as menções nas notificações de comentários. O easyCoexistence renova esse token antes de expirar e verifica a conta de 6 em 6 horas.
Erros comuns
- Enviar um token de Instagram User para uma integração com Unified Login. A Meta diz que esses tokens e o graph.instagram.com não funcionam aí, pelo que cada cliente tem de se voltar a ligar.
- Chamar /me para a conta do Instagram. Com um token do Unified Login, devolve o Business Integration System User; leia os IDs a partir de /me/assigned_instagram_accounts.
- Trocar o código com o ID e o segredo da app do Instagram. O Unified Login exige o ID e o segredo da app da Meta.
- Remover a ligação ao Instagram Login antes de a nova funcionar. A Meta aconselha a manter as duas até que uma chamada e um webhook funcionem, e avisa que os webhooks de mensagens podem chegar duplicados entretanto.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
O Instagram Login vai ser desativado?
A Meta não anunciou nenhuma data de fim. O seu guia de migração diz que as integrações existentes com Instagram Login continuam a funcionar e que qualquer alteração será anunciada no registo de alterações da Instagram Platform.
Os clientes têm de iniciar sessão através do Facebook Login?
Não. O Unified Login permite que iniciem sessão com a sua conta do Instagram, e nenhuma das opções precisa de uma Página; precisam, sim, de acesso ao portefólio empresarial que é proprietário da conta do Instagram.
O Unified Login precisa de App Review?
Para ligar clientes sem um papel na app, sim: Acesso avançado a cada permissão instagram_* na configuração, através da App Review, com a app em modo Live.
Quanto custa o easyCoexistence por uma conta do Instagram?
Cada conta do Instagram ligada é uma ligação, de US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
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