Unified Login da Meta para o Instagram: o que é e o que muda para apps em 2026
Unified Login é a terceira forma de configuração da Instagram API da Meta e a que ela recomenda para novas integrações: o cliente entra com o Instagram ou pelo Facebook Login, escolhe um portfólio de negócios e as contas do Instagram a compartilhar, e o app recebe um único token de Business Integration System User. Novos recursos da Instagram API são lançados somente nessa forma, enquanto as integrações atuais com Instagram Login seguem funcionando, sem data de encerramento anunciada.
O easyCoexistence usa o Instagram Login, não o Unified Login: o dono aprova cinco permissões, e o Claude, o ChatGPT ou outro cliente MCP passam a publicar, responder a comentários e DMs e ler métricas.
A Meta lança novos recursos da Instagram API somente para a Instagram API com Unified Login.
As integrações com Instagram Login seguem funcionando; a Meta anunciará qualquer mudança no changelog da Instagram Platform.
O guia de migração da Meta diz que apps recém-criados não podem configurar a Instagram API com Instagram Login.
Cobre as contas que o cliente compartilha e pertence ao portfólio de negócios do cliente, e não à pessoa que fez o login.
Contas profissionais do Instagram que um app pode convidar como Instagram Testers durante o teste do Unified Login no modo Development.
O que é a Instagram API com Unified Login?
Um único fluxo de login para dois tipos de cliente: as pessoas entram com a conta do Instagram ou pelo Facebook Login, e não é preciso nenhuma Página. Construído sobre o Facebook Login para Empresas, ele pede ao cliente um portfólio de negócios, as contas do Instagram a compartilhar e outros ativos extras, como uma conta de anúncios, e então entrega ao 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 faz o login, no que escolhe e no que o app guarda depois. O guia de migração da Meta coloca as duas formas lado a lado; a terceira forma, o Facebook Login, compartilha o host do Graph e as permissões instagram_* do Unified Login, mas exige que a conta esteja vinculada 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ó está disponível com o Unified Login?
A documentação da Meta oferece estes recursos em relação ao Instagram Login. O primeiro e o último pertencem somente ao Unified Login; os demais ele compartilha com o Facebook Login, que exige uma Página:
- Novos recursos da Instagram API, que a Meta lança somente para o Unified Login.
- Busca por hashtag, marcação de produtos e anúncios de parceria, que a Meta marca como não suportados com o Instagram Login.
- A Audio API, a Collaboration API e o Business Discovery, documentados para o Facebook Login e o Unified Login.
- Anúncios pela Marketing API e eventos pela Conversions API, com permissões de anúncios na configuração.
- Um token que pertence ao portfólio de negócios do cliente, então continua funcionando se a pessoa que fez o login sair da empresa.
O que o Unified Login ainda não suporta?
Quatro itens, que o guia de migração da Meta lista como ausentes no lançamento. Um app que depende de algum deles deve permanecer no Instagram Login por enquanto, como a Meta recomenda. Clientes que entram pelo Facebook Login também ativam sozinhos a opção Permitir acesso a mensagens no app do Instagram, já que só o login pelo Instagram exibe essa etapa:
- O Handover Protocol.
- Trocar uma conta pessoal para profissional durante o login; os clientes fazem a troca primeiro no app do Instagram.
- Entrar pelo app do Instagram: o login abre no navegador, então os clientes precisam da senha do Instagram.
- O auxiliar de integração da API no App Dashboard.
Como um app configura o Unified Login?
A partir de um app de um portfólio de negócios, em Use cases, Manage messaging & content on Instagram, Customize, depois API setup with Unified login. O guia da Meta tem quatro etapas, com Standard Access concedido às permissões da configuração assim que ela for salva:
- Crie uma configuração, com as permissões e os ativos a solicitar, em que
instagram_basiceinstagram_manage_messagesestão sempre incluídas; salve a URL de redirecionamento e copie a URL de login. - Gere tokens de teste convidando até 50 Instagram Testers, que aceitam em Website permissions, Apps and websites, Tester Invites.
- Configure os webhooks no objeto Instagram do app da Meta e depois assine cada conta compartilhada.
- Solicite Advanced Access às permissões instagram_* pelo App Review, com o app em modo Live.
Como o token e as chamadas da API mudam?
O código é trocado no servidor com o ID e o secret do app da Meta, e não os do Instagram, por um token de Business Integration System User que pertence ao portfólio de negócios do cliente. Com esse token, /me retorna o usuário de sistema, então o app lê os IDs das contas em GET /me/assigned_instagram_accounts e coloca um em cada caminho. O token deixa de funcionar se o cliente remover o app do portfólio ou mover a conta para outro.
O que uma integração existente com Instagram Login deve fazer?
Nada urgente: a Meta diz que essas integrações continuam funcionando e que qualquer mudança aparecerá no changelog. A migração traz os novos recursos e custa uma revisão e uma reconexão por cliente, nestas etapas do guia de migração da Meta:
- Solicite Advanced Access à correspondência instagram_* de cada permissão instagram_business_* em uso.
- Troque a URL de embed pela URL de login da configuração, e as credenciais do app do Instagram pelas do app da Meta.
- Mova as chamadas para o ID da conta no host do Graph do Facebook Login; os IDs de mensagens vêm em outro formato.
- Assine cada conta novamente, já que as assinaturas do Instagram Login não são transferidas.
- Reconecte os clientes em pequenos grupos, mantendo cada token antigo até que uma chamada e um webhook funcionem.
Quais permissões substituem quais?
O Unified Login usa as permissões instagram_* do Facebook Login para Empresas, e cada permissão instagram_business_* que um app do Instagram Login tem hoje possui uma correspondente direta. Um app que já tem Advanced Access a elas, por exemplo por uma integração anterior com Facebook Login, não as solicita de novo:
Qual login o easyCoexistence usa?
Instagram Login, dito com clareza. O easyCoexistence envia o dono à própria página de autorização do Instagram com o ID do app do Instagram e cinco permissões instagram_business_*, troca o código no servidor por um token de 60 dias, lê a conta com GET /me e a inscreve nos campos de webhook comments, messages e mentions em graph.instagram.com. Com o Instagram Login, a Meta inclui menções nas notificações de comentários. O easyCoexistence renova esse token antes de expirar e verifica a conta a cada 6 horas.
Erros comuns
- Enviar um token de Instagram User a uma integração com Unified Login. A Meta diz que esses tokens e graph.instagram.com não funcionam ali, então cada cliente conecta de novo.
- Chamar /me para a conta do Instagram. Com um token do Unified Login, ele retorna o usuário de sistema da integração comercial; leia os IDs em /me/assigned_instagram_accounts.
- Trocar o código com o ID e o secret do app do Instagram. O Unified Login exige o ID e o secret do app da Meta.
- Remover a conexão com o Instagram Login antes de a nova funcionar. A Meta recomenda manter as duas até que uma chamada e um webhook funcionem, e avisa que webhooks de mensagens podem chegar duplicados nesse período.
O easyCoexistence conecta o Instagram pelo Instagram Login: o dono entra com o Instagram e aprova cinco permissões, e o Claude, o ChatGPT ou sua própria plataforma publicam, agendam, respondem a comentários e mensagens diretas (DMs) e leem métricas pela API oficial da Meta, com o token renovado e a conta verificada a cada 6 horas. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O Instagram Login está sendo desativado?
A Meta não anunciou data de encerramento. O guia de migração diz que as integrações atuais com Instagram Login continuam funcionando e que qualquer mudança será anunciada no changelog da Instagram Platform.
Os clientes precisam entrar pelo Facebook Login?
Não. O Unified Login permite que entrem com a conta do Instagram, e nenhuma das duas opções exige uma Página; eles precisam, porém, de acesso ao portfólio de negócios que é dono da conta do Instagram.
O Unified Login precisa de App Review?
Para conectar clientes sem um papel no app, sim: Advanced Access a cada permissão instagram_* da configuração, pelo App Review, com o app em modo Live.
Quanto custa o easyCoexistence para uma conta do Instagram?
Cada conta do Instagram conectada é uma conexão, de US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em