EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Token de acesso da Página do Facebook: quanto tempo dura e o que o invalida

Um token de acesso de Página do Facebook de longa duração não tem data de expiração. Um app obtém um trocando o login da pessoa por um token de usuário de longa duração, válido por cerca de 60 dias, e lendo /me/accounts; a pessoa precisa de controle total da Página ou de acesso às tarefas. A Meta ainda invalida o token em certas condições, como a pessoa perder seu papel na Página.

A easyCoexistence obtém um token de Página de longa duração para cada Página que você conecta, o mantém criptografado, verifica a Página a cada 6 horas e envia um e-mail quando a Meta deixa de aceitá-lo.

No expiry

Tokens de acesso de Página de longa duração, gerados a partir de um token de usuário de longa duração, não têm data de expiração.

About 60 days

Por quanto tempo um token de acesso de usuário de longa duração geralmente dura; tokens de curta duração duram cerca de uma a duas horas.

492

Subcódigo de erro para um token de Página cuja pessoa não tem mais o papel adequado na Página.

90 days

Após esse tempo sem que o app use uma permissão, a pessoa precisa concedê-la novamente.

PROFILE_PLUS_FULL_CONTROL

Uma das tarefas de Página que a API da Meta pode atribuir, ao lado de CREATE_CONTENT, MODERATE, MESSAGING e ANALYZE.

Um token de acesso de Página do Facebook expira?

Depende do token de usuário de que ele veio. Os tokens padrão de usuário e de Página da Meta são de curta duração e expiram em horas, e um token de usuário de longa duração geralmente dura cerca de 60 dias. Um token de Página gerado a partir de um token de usuário de longa duração não tem data de expiração: a Meta diz que ele só expira ou é invalidado em certas condições. A Meta também alerta para não depender da duração dos tokens, que podem mudar sem aviso.

Como obter um token de acesso de Página de longa duração?

Em três chamadas, depois que a pessoa entra com o Facebook Login for Business. O app troca o código devolvido por um token de usuário de curta duração e depois o converte em um de longa duração em GET /oauth/access_token, com grant_type=fb_exchange_token e o app secret, chamada que a Meta recomenda fazer a partir de um servidor. GET /me/accounts com o token de usuário de longa duração devolve então cada Página que a pessoa autorizou, com seu ID, as tarefas da pessoa e um token de Página.

1Sign-inFacebook Login for Business returns a code
2User tokenThe code becomes a short-lived user token
3Long-livedfb_exchange_token trades it for about 60 days
4Page token/me/accounts returns one per Page, with no expiry

Quem pode conectar uma Página e obter seu token?

Quem é dono da Página ou pode executar tarefas nela. Nas configurações de Página do Facebook e no Meta Business Suite, isso significa controle total ou acesso mais restrito a tarefas como Content ou Messages, e a visão geral da API de Páginas da Meta acrescenta que uma pessoa com acesso de Administrador pode executar todas as tarefas. Os tokens de Página são exclusivos de cada Página, pessoa e app, então duas pessoas que conectem a mesma Página têm tokens diferentes. Os nomes da interface do Facebook correspondem às tarefas da API assim:

Full controlPROFILE_PLUS_FULL_CONTROL
ContentPROFILE_PLUS_CREATE_CONTENT: publish as the Page
MessagesPROFILE_PLUS_MESSAGING: send messages as the Page
Community activityPROFILE_PLUS_MODERATE: reply to and delete comments
InsightsPROFILE_PLUS_ANALYZE: view the Page's Insights
AdsPROFILE_PLUS_ADVERTISE: create ads

Qual tarefa cada ação exige?

A Meta verifica, em cada chamada, se a pessoa por trás do token tem uma tarefa que permita a ação, então conecte a partir de uma conta cujo acesso cubra o trabalho:

  • Posts de texto, link e foto: CREATE_CONTENT.
  • Posts de vídeo: tarefas equivalentes a administrador, segundo a visão geral da API de Vídeo da Meta.
  • IDs de comentários e respostas como a Página: MODERATE.
  • Respostas no Messenger e respostas privadas: MESSAGING.
  • Insights: ANALYZE.
  • Webhooks de feed: CREATE_CONTENT, MANAGE ou MODERATE; o campo messages: MESSAGING.

O que invalida um token de acesso de Página?

A Meta informa um token que não aceita mais com o código de erro 190, ou 102 para uma sessão, e um subcódigo de autenticação que explica o motivo. Uma pessoa também pode invalidar os tokens de usuário de um app removendo-o em Business Integrations nas configurações do Facebook, e uma permissão que o app não usou por 90 dias precisa ser concedida novamente. Os subcódigos que a Meta lista:

  • 458: a pessoa não fez login no app.
  • 459 ou 464: a pessoa precisa fazer login em facebook.com para resolver um problema com a conta.
  • 460: a senha da pessoa foi alterada.
  • 463 ou 467: o token expirou, foi revogado ou está inválido de outra forma.
  • 492: a pessoa por trás de um token de Página não tem mais o papel adequado na Página.

O que a easyCoexistence faz para manter uma Página conectada?

Ela obtém o token de cada Página a partir de um token de usuário de longa duração no login, então não há expiração para renovar em um cronograma, e o armazena criptografado. A cada 6 horas, verifica cada Página conectada com uma chamada leve à Graph API. Quando a Meta recusa o token com o erro 190 ou 102, nessa verificação ou em qualquer chamada de ferramenta, a Página é marcada como precisando de reconexão, o dono recebe um e-mail e uma plataforma parceira recebe channel.disconnected. Entrar de novo com uma conta que administra a Página a restaura.

Você pode usar o próprio token da Página?

Não o token em si. get_social_credentials devolve o ID da Página e a base da Graph API em graph.facebook.com, mas nunca o token da Página (termos da Meta); o token não expira enquanto a Página permanecer conectada, embora a Meta ainda possa invalidá-lo. As ferramentas MCP fazem as chamadas como a Página sem expor o token; o token e as assinaturas de webhook ficam com a easyCoexistence.

Erros comuns

  • Solicitar o token de longa duração a partir de um navegador. A troca carrega o app secret, então a Meta diz que essa chamada deve ser feita a partir de um servidor, nunca no lado do cliente.
  • Tentar estender um token expirado. A Meta não transforma um token expirado em um de longa duração; a pessoa precisa passar pelo login de novo.
  • Conectar por meio de alguém prestes a sair da empresa. O token da Página depende do acesso dessa pessoa e para de funcionar quando ela perde o papel, então conecte a partir de uma conta que vai continuar.
  • Armazenar tokens em uma coluna de tamanho fixo. A Meta muda o tamanho dos tokens com o tempo e recomenda um tipo de tamanho variável, sem máximo definido.
Fazendo isso com o EasyCoexistence

Sua IA trabalha com ele pelas ferramentas MCP, que acrescentam o token para você, e get_social_credentials dá ao seu próprio código o ID da Página e a base da API. 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

As permissões do Facebook expiram se o app parar de usá-las?

Sim. Depois de 90 dias sem que o app use uma permissão, a pessoa precisa concedê-la novamente.

Um token do Facebook expirado pode se tornar de longa duração?

Não. A Meta não transforma um token expirado em um de longa duração, então a pessoa precisa passar pelo login de novo antes que um novo token de Página de longa duração possa ser lido.

O que significa o erro 190 para uma Página do Facebook?

Que a Meta não aceita mais o token. O subcódigo explica o motivo, como 460 após uma troca de senha ou 492 quando a pessoa perdeu o papel na Página.

A easyCoexistence renova os tokens de Página do Facebook?

Não, porque não há nada para renovar em um cronograma: os tokens de Página que ela guarda não têm data de expiração. Em vez disso, verifica cada Página a cada 6 horas e envia um e-mail se alguma precisar ser reconectada.

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