Token de acesso à Página do Facebook: quanto tempo dura e o que o invalida
Um token de acesso à Página do Facebook de longa duração não tem data de expiração. Uma aplicação obtém-no ao trocar o início de sessão de uma pessoa por um token de utilizador de longa duração, que dura cerca de 60 dias, e ao ler /me/accounts; a pessoa tem de ter controlo total da Página ou acesso às tarefas. A Meta continua a invalidar o token em certas condições, como a pessoa perder a sua função na Página.
A easyCoexistence obtém um token de Página de longa duração para cada Página que liga, mantém-no cifrado, verifica a Página de 6 em 6 horas e envia-lhe um e-mail quando a Meta deixa de o aceitar.
Os tokens de acesso de Página de longa duração, gerados a partir de um token de utilizador de longa duração, não têm data de expiração.
Duração geral de um token de acesso de utilizador de longa duração; os tokens de curta duração duram cerca de uma a duas horas.
Subcódigo de erro para um token de Página cuja pessoa já não tem a função adequada na Página.
Passado este tempo sem a aplicação usar uma permissão, a pessoa tem de a conceder novamente.
Uma das tarefas de Página que a API da Meta pode atribuir, além de CREATE_CONTENT, MODERATE, MESSAGING e ANALYZE.
O token de acesso a uma Página do Facebook expira?
Depende do token de utilizador de que provém. Os tokens por predefinição da Meta, de utilizador e de Página, são de curta duração e expiram em horas, e um token de utilizador de longa duração dura, em geral, cerca de 60 dias. Um token de Página gerado a partir de um token de utilizador de longa duração não tem data de expiração: a Meta diz que só expira ou é invalidado em certas condições. A Meta também avisa para não contar com a duração dos tokens, que pode mudar sem aviso.
Como se obtém um token de acesso de Página de longa duração?
Em três chamadas, depois de a pessoa iniciar sessão com o Facebook Login for Business. A aplicação troca o código devolvido por um token de utilizador de curta duração e, em seguida, troca esse por um de longa duração em GET /oauth/access_token com grant_type=fb_exchange_token e o segredo da aplicação, uma chamada que a Meta recomenda fazer a partir de um servidor. GET /me/accounts com o token de utilizador de longa duração devolve então cada Página que a pessoa autorizou, com o respetivo ID, as tarefas da pessoa e um token de Página.
Quem pode ligar uma Página e obter o seu token?
Alguém que seja proprietário da Página ou que possa executar tarefas nela. Nas definições da Página do Facebook e no Meta Business Suite, isso significa controlo total ou um acesso mais restrito a tarefas, como Conteúdo ou Mensagens, 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 únicos para cada Página, pessoa e aplicação, por isso duas pessoas que liguem a mesma Página têm tokens diferentes. Os nomes da interface do Facebook correspondem às tarefas da API assim:
Que tarefa exige cada ação?
A Meta verifica, em cada chamada, se a pessoa por trás do token tem uma tarefa que permita a ação; por isso, ligue a partir de uma conta cujo acesso cubra o trabalho:
- Publicações de texto, de ligação e de fotografia:
CREATE_CONTENT. - Publicações de vídeo: tarefas equivalentes às de administrador, segundo a visão geral da API de Vídeo da Meta.
- IDs de comentários e respostas enquanto Página: MODERATE.
- Respostas no Messenger e respostas privadas: MESSAGING.
- Métricas: ANALYZE.
- Webhooks do feed:
CREATE_CONTENT, MANAGE ou MODERATE; o campo messages: MESSAGING.
O que invalida um token de acesso de Página?
A Meta comunica um token que já não aceita com o código de erro 190, ou 102 para uma sessão, e um subcódigo de autenticação que indica a causa. Uma pessoa pode também invalidar os tokens de utilizador de uma aplicação ao removê-la em Business Integrations nas definições do Facebook, e uma permissão que a aplicação não tenha usado durante 90 dias tem de ser concedida novamente. Os subcódigos que a Meta lista:
- 458: a pessoa não iniciou sessão na aplicação.
- 459 ou 464: a pessoa tem de iniciar sessão em facebook.com para resolver um problema com a sua conta.
- 460: a palavra-passe da pessoa foi alterada.
- 463 ou 467: o token expirou, foi revogado ou é inválido de outra forma.
- 492: a pessoa por trás de um token de Página já não tem a função adequada na Página.
O que faz a easyCoexistence para manter uma Página ligada?
Obtém o token de cada Página a partir de um token de utilizador de longa duração no início de sessão, por isso não há expiração para renovar em calendário, e guarda-o cifrado. De 6 em 6 horas verifica cada Página ligada com uma chamada leve ao Graph. Quando a Meta recusa o token com o erro 190 ou 102, nessa verificação ou em qualquer chamada de ferramenta, a Página fica marcada como a precisar de nova ligação, o seu proprietário recebe um e-mail e uma plataforma parceira recebe channel.disconnected. Iniciar sessão de novo a partir de uma conta que administra a Página restabelece-a.
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 API Graph em graph.facebook.com, mas nunca o token da Página (termos da Meta); o token não expira enquanto a Página estiver ligada, embora a Meta ainda o possa invalidar. As ferramentas MCP fazem as chamadas como a Página sem expor o token; o token e as subscrições de webhooks ficam com a easyCoexistence.
Erros comuns
- Pedir o token de longa duração a partir de um browser. A troca leva o segredo da aplicação, por isso a Meta recomenda fazer essa chamada a partir de um servidor, nunca do lado do cliente.
- Tentar prolongar um token expirado. A Meta não transforma um token expirado num de longa duração; a pessoa tem de passar novamente pelo início de sessão.
- Ligar através de alguém que está prestes a sair da empresa. O token da Página assenta no acesso dessa pessoa e deixa de funcionar quando ela perde a função; por isso, ligue a partir de uma conta que se mantenha.
- Guardar os tokens numa coluna de comprimento fixo. A Meta altera o comprimento dos tokens com o tempo e recomenda um tipo de comprimento variável, sem máximo definido.
A sua IA trabalha com ele através das ferramentas MCP, que acrescentam o token por si, e get_social_credentials entrega ao seu próprio código o ID da Página e a base da API. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
As permissões do Facebook expiram se a aplicação deixar de as usar?
Sim. Passados 90 dias sem a aplicação usar uma permissão, a pessoa tem de a conceder novamente.
Um token do Facebook expirado pode ser tornado de longa duração?
Não. A Meta não transforma um token expirado num de longa duração, por isso a pessoa tem de passar novamente pelo início de sessão antes de se poder ler um novo token de Página de longa duração.
O que significa o erro 190 para uma Página do Facebook?
Que a Meta já não aceita o token. O subcódigo indica a causa, como o 460 após uma alteração da palavra-passe ou o 492 quando a pessoa perdeu a função na Página.
A easyCoexistence renova os tokens de Página do Facebook?
Não, porque não há nada a renovar em calendário: os tokens de Página que guarda não têm data de expiração. Em vez disso, verifica cada Página de 6 em 6 horas e envia-lhe um e-mail se for preciso voltar a ligar uma delas.
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