Erro 190 do Facebook: token de acesso inválido ou expirado
O erro 190 do Facebook significa que o token de acesso não é mais válido. A mensagem da Meta diz Invalid OAuth 2.0 Access Token, ou começa com Error validating access token, seguida do motivo, como Session has expired. A correção é obter um novo token, o que, para uma Página, normalmente significa que alguém com um papel na Página entre novamente. Um subcódigo, quando presente, indica o motivo.
O easyCoexistence chama cada Página conectada com o próprio token de Página e verifica a Página a cada 6 horas.
O código da Graph API para um token de acesso expirado; a ação recomendada pela Meta é obter um novo.
Subcódigo enviado quando a pessoa saiu da conta ou trocou a senha: The session is invalid because the user logged out.
Subcódigo para um token de Página cujo usuário não tem um papel adequado na Página.
Tokens de acesso de Página de longa duração não têm data de expiração; eles expiram ou são invalidados apenas em certas condições.
O Facebook não notifica um app quando um dos seus tokens de acesso se torna inválido.
O que o erro 190 significa em uma Página do Facebook?
A Meta não aceita mais o token de acesso na requisição. O guia de erros da Graph API lista o 190 como token de acesso expirado, com uma única correção: obter um novo token de acesso. As referências da Meta para fotos e vídeos de Página descrevem o código como Invalid OAuth 2.0 Access Token, e o guia de envio de mensagens do Messenger diz para gerar um novo token de acesso de Página.
O que significam os subcódigos?
Quando um subcódigo acompanha o erro, a tabela de subcódigos de autenticação da Meta indica por que 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, seguida da data.
- 467, Invalid Access Token: o token expirou, foi revogado ou é inválido de outra forma.
- 460, Password Changed: Error validating access token: The session is invalid because the user logged out. A pessoa saiu da conta ou trocou a senha, e precisa entrar de novo.
- 458, App Not Installed: Error validating access token: User {user-id} has not authorized application {app-id}. A pessoa precisa ser autenticada novamente.
- 459, User Checkpointed, e 464, Unconfirmed User: a pessoa precisa entrar em facebook.com para corrigir um problema.
- 492, Invalid Session: a pessoa por trás do token de Página não tem um papel adequado na Página.
Tokens de Página do Facebook expiram?
Não em um cronograma fixo, quando vêm de um token de usuário de longa duração. O guia da Meta sobre tokens de longa duração diz que esse token de usuário geralmente dura 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 da Meta acrescenta que tokens podem ser invalidados antes do prazo previsto por causa de eventos relacionados à segurança.
Como corrigir?
Obtenha um novo token, que para uma Página vem de um novo login. A Meta emite um token de Página apenas para uma pessoa com um papel na Página; então, se quem o conectou saiu ou perdeu esse papel, alguém que ainda administra a Página entra no lugar. Com o subcódigo 459 ou 464, a pessoa primeiro entra em facebook.com e resolve o que o Facebook pedir, depois entra novamente.
Como detectar antes que uma chamada falhe?
Verifique o token em um cronograma. O Facebook não avisa um app quando um token para de funcionar, então uma requisição regular com o token de Página, como ler o id e o nome da Página, encontra um 190 antes que uma publicação ou resposta do Messenger dependa dele. O endpoint debug_token da Meta também informa se um token é válido, quando expira e as permissões que ele tem.
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 recusado continua recusado, e só um novo token de um novo login limpa o erro.
- Presumir que um token de Página dura para sempre. Ele não tem data de expiração, mas a Meta ainda invalida tokens em certas condições, e o erro 190 é como isso aparece.
- Conectar a Página novamente com uma conta que não tem papel nela. A Meta entrega tokens de Página apenas a pessoas com um papel na Página.
- Guardar sua própria cópia do token de Página. Depois de um novo login, a cópia guardada ainda é a recusada, então busque o token atual.
Quando a Meta responde 190, durante uma verificação ou qualquer outra chamada, a conexão é marcada para reconexão imediatamente e você recebe um e-mail, e as ferramentas informam à sua IA que a Página precisa ser conectada novamente. Entrar pelo painel traz a mesma conexão de volta com um novo token. 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 que significa Error validating access token?
É o início da mensagem da Meta para o erro 190: o token na requisição não é mais válido. O restante da mensagem informa o motivo, como uma sessão expirada ou um logout.
Trocar minha senha do Facebook quebra o token de Página?
Sim. Um logout ou a troca de senha invalida o token, com o subcódigo 460, e alguém com um papel na Página precisa entrar novamente.
O que significa o subcódigo 492?
A pessoa cujo login gerou o token de Página não tem um papel adequado na Página. Alguém que administra a Página precisa conectá-la novamente.
Dá para renovar um token de Página depois do erro 190?
Não. A correção da Meta é um novo token de acesso, e, para uma Página, ele vem de alguém com um papel na Página que entra novamente.
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