EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

New features

A Meta lança novos recursos da Instagram API somente para a Instagram API com Unified Login.

No end date

As integrações com Instagram Login seguem funcionando; a Meta anunciará qualquer mudança no changelog da Instagram Platform.

New apps

O guia de migração da Meta diz que apps recém-criados não podem configurar a Instagram API com Instagram Login.

1 token

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.

50 testers

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 LoginInstagram Login
Clients sign in withInstagram, or Facebook LoginInstagram
Clients chooseA business portfolio, then the accounts to shareNothing beyond the account signing in
App credentialsMeta app ID and app secretInstagram app ID and app secret
Login linkA login URL with the configuration's config_idAn embed URL with the Instagram app ID and scopes
Access tokenBusiness Integration System User, expiry set by the configurationInstagram User, 60 days, refreshable
API hostFacebook Login's Graph hostgraph.instagram.com
Account IDGET /me/assigned_instagram_accountsReturned with the token, or /me
PermissionsThe instagram_* familyThe instagram_business_* family
Business portfolioRequiredNot 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_basic e instagram_manage_messages estã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:

instagram_business_basicinstagram_basic
instagram_business_content_publishinstagram_content_publish
instagram_business_manage_commentsinstagram_manage_comments
instagram_business_manage_insightsinstagram_manage_insights
instagram_business_manage_messagesinstagram_manage_messages

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.
Fazendo isso com o EasyCoexistence

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