Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

New features

A Meta lança novas funcionalidades da API do Instagram apenas para a API do Instagram com Unified Login.

No end date

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.

New apps

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.

1 token

Abrange as contas que o cliente partilha e pertence ao portefólio empresarial do cliente, e não à pessoa que iniciou sessão.

50 testers

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 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ó 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_basic e instagram_manage_messages estã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:

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

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.
Fazer isto com a EasyCoexistence

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