Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Erro 190 do Facebook: token de acesso inválido ou expirado

O erro 190 do Facebook significa que o token de acesso deixou de ser válido. A mensagem da Meta diz Invalid OAuth 2.0 Access Token, ou começa por Error validating access token, seguida do motivo, como Session has expired. A solução é obter um novo token, o que, numa Página, costuma significar que alguém com um papel na Página volta a iniciar sessão. Quando existe, o subcódigo indica o motivo.

A easyCoexistence chama cada Página ligada com o seu próprio token de Página e verifica a Página de 6 em 6 horas.

190

O código da Graph API para um token de acesso expirado; a ação recomendada pela Meta é obter um novo.

460

Subcódigo enviado quando a pessoa termina sessão ou altera a palavra-passe: The session is invalid because the user logged out.

492

Subcódigo para um token de Página cujo utilizador não tem um papel adequado na Página.

No expiry

Os tokens de acesso de Página de longa duração não têm data de expiração; expiram ou são invalidados apenas em certas condições.

No notice

O Facebook não notifica uma aplicação quando um dos seus tokens de acesso deixa de ser válido.

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

A Meta deixa de aceitar o token de acesso no pedido. O guia de erros da Graph API lista o 190 como token de acesso expirado, com uma única solução: obter um novo token de acesso. As referências da Meta para fotos e vídeos de Páginas descrevem o código como Invalid OAuth 2.0 Access Token, e o guia para enviar mensagens do Messenger diz para gerar um novo token de acesso da Página.

O que significam os subcódigos?

Quando o erro vem acompanhado de um subcódigo, a tabela de subcódigos de autenticação da Meta indica porque o token foi recusado, e o guia de depuração de tokens mostra a mensagem que acompanha alguns deles:

  • 463, Expired: o token expirou. A mensagem diz Error validating access token: Session has expired on, seguido da data.
  • 467, Invalid Access Token: o token expirou, foi revogado ou é inválido por outro motivo.
  • 460, Password Changed: Error validating access token: The session is invalid because the user logged out. A pessoa terminou sessão ou alterou a palavra-passe e tem de iniciar sessão novamente.
  • 458, App Not Installed: Error validating access token: User {user-id} has not authorized application {app-id}. A pessoa tem de ser autenticada novamente.
  • 459, User Checkpointed, e 464, Unconfirmed User: a pessoa tem de iniciar sessão em facebook.com para resolver um problema.
  • 492, Invalid Session: a pessoa por trás do token da Página não tem um papel adequado na Página.

Os tokens de Página do Facebook expiram?

Não segundo um calendário, quando vêm de um token de utilizador de longa duração. O guia da Meta para tokens de longa duração diz que esse token de utilizador dura, em geral, cerca de 60 dias, enquanto os tokens de acesso de Página de longa duração não têm data de expiração e expiram ou são invalidados apenas em certas condições. O guia de depuração de tokens acrescenta que os tokens podem ser invalidados antes da data prevista por eventos relacionados com segurança.

Como se corrige?

Obtendo um novo token, que, numa Página, vem de um novo início de sessão. A Meta emite um token de Página apenas a uma pessoa com um papel na Página; por isso, se quem a ligou saiu ou perdeu esse papel, tem de iniciar sessão alguém que ainda gere a Página. Com o subcódigo 459 ou 464, a pessoa começa por iniciar sessão em facebook.com e resolve o que o Facebook pede; depois inicia sessão novamente.

Como detetar o problema antes de uma chamada falhar?

Verificar o token com regularidade. O Facebook não avisa uma aplicação quando um token deixa de funcionar, por isso um pedido regular com o token da Página, como ler o id e o nome da Página, encontra um 190 antes de uma publicação ou uma resposta no Messenger depender dele. O endpoint debug_token da Meta também indica se um token é válido, quando expira e as permissões que tem.

A quick check of a Page token
curl "https://graph.facebook.com/<PAGE_ID>?fields=id,name&access_token=<PAGE_ACCESS_TOKEN>"

# Valid: the Page comes back
{"id": "<PAGE_ID>", "name": "<PAGE_NAME>"}

# Rejected: code 190, with a subcode when Meta gives one
{"error": {"type": "OAuthException", "code": 190, "error_subcode": 460, "message": "..."}}

Erros comuns

  • Repetir a chamada. Um token rejeitado continua rejeitado, e só um novo token de um novo início de sessão elimina o erro.
  • Presumir que um token de Página dura para sempre. Não tem data de expiração, mas a Meta continua a invalidar tokens em certas condições, e o erro 190 é a forma como isso se manifesta.
  • Voltar a ligar a Página com uma conta sem papel nela. A Meta só dá tokens de Página a pessoas com um papel na Página.
  • Manter uma cópia própria do token da Página. Depois de um novo início de sessão, a cópia guardada continua a ser a rejeitada; por isso, é preciso obter o token atual.
Fazer isto com a EasyCoexistence

Quando a Meta responde 190, durante uma verificação ou qualquer outra chamada, a ligação fica marcada de imediato para nova ligação e é enviado um e-mail; as ferramentas indicam à sua IA que a Página precisa de ser ligada novamente. Iniciar sessão no painel restabelece a mesma ligação com um novo token. A partir de US$ 9 por ligação por mês, descendo até US$ 0.75 à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

O que significa Error validating access token?

É o início da mensagem da Meta para o erro 190: o token no pedido já não é válido. O resto da mensagem indica o motivo, como uma sessão expirada ou um término de sessão.

Alterar a palavra-passe do Facebook invalida o token da Página?

Sim. Um término de sessão ou uma alteração de palavra-passe invalida-o, com o subcódigo 460, e alguém com um papel na Página tem de iniciar sessão novamente.

O que significa o subcódigo 492?

A pessoa cujo início de sessão produziu o token da Página não tem um papel adequado na Página. Alguém que gere a Página tem de a ligar novamente.

Um token de Página pode ser renovado depois do erro 190?

Não. A solução da Meta é um novo token de acesso e, numa Página, esse token vem de alguém com um papel na Página que volta a iniciar sessão.

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