Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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

O erro 190 do Instagram significa que o token de acesso enviado com o pedido expirou, foi revogado ou é inválido de outra forma. Com o Instagram Login, um token de longa duração vale 60 dias e pode ser renovado por mais 60 depois de ter pelo menos 24 horas. Um token já expirado não pode ser renovado: o titular da conta tem de voltar a iniciar sessão.

O easyCoexistence mantém o acesso ao Instagram atualizado: renova-o antes de expirar, verifica a conta de 6 em 6 horas e envia-lhe um email quando é preciso voltar a ligá-la.

190

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

60 days

Duração de um token de acesso de utilizador do Instagram de longa duração, e quanto cada renovação o prolonga.

24 hours

Idade mínima que um token de longa duração deve ter para poder ser renovado, enquanto ainda não tiver expirado.

460

Subcódigo para uma sessão terminada por alteração da palavra-passe, após a qual a pessoa tem de voltar a iniciar sessão.

O que significa o erro 190 no Instagram?

O token de acesso enviado no pedido já não é aceite. O guia de erros da Graph API da Meta indica o 190 como token de acesso expirado, com uma única solução: obter um novo token de acesso. Quando vem acompanhado de um subcódigo, a tabela de subcódigos de autenticação do guia explica o motivo:

  • 463: o token expirou.
  • 467: o token é inválido, seja por expiração, revogação ou outro motivo que o torne inutilizável.
  • 460: a palavra-passe foi alterada, o que termina a sessão; a pessoa tem de voltar a iniciar sessão.

Quanto tempo dura um token do Instagram?

Com o Instagram Login, ao iniciar sessão obtém-se um token de curta duração, que a aplicação troca, do lado do servidor, por um de longa duração válido por 60 dias. Um token de longa duração pode ser renovado por mais 60 dias desde que tenha pelo menos 24 horas, não tenha expirado e a pessoa tenha concedido instagram_business_basic. Um token que passe 60 dias sem renovação expira e já não pode ser renovado.

Refreshing a long-lived Instagram token
curl "https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=<LONG_LIVED_TOKEN>"

{
  "access_token": "<NEW_LONG_LIVED_TOKEN>",
  "token_type": "bearer",
  "expires_in": 5183944
}

O que mais torna um token inválido?

A expiração é o caso comum, mas não o único. A alteração da palavra-passe termina a sessão associada ao token, comunicada com o subcódigo 460, e a pessoa pode remover o acesso da aplicação à sua conta, após o que as chamadas falham até voltar a autorizá-la. Ambas as situações podem acontecer em qualquer dia, por isso vale a pena verificar o token periodicamente e não apenas quando uma chamada falha.

Como se resolve?

Obtenha um novo token. A renovação só funciona num token ainda válido, por isso, quando aparece o erro 190, já é tarde para a usar. O titular da conta volta a iniciar sessão com o Instagram, o que emite um novo token de curta duração para a aplicação trocar por um de longa duração. A partir daí, renove-o periodicamente, bem antes dos 60 dias.

Erros comuns

  • Esperar que o token falhe antes de o renovar. Um token expirado não pode ser renovado, por isso renove-o enquanto ainda é válido.
  • Renovar cedo demais. Um token de longa duração com menos de 24 horas ainda não pode ser renovado, por isso agende a primeira renovação para depois desse prazo.
  • Guardar cópias do token em vários sítios. Renovar uma cópia não renova as outras, que acabam por falhar com o erro 190.
  • Repetir a chamada. Um token rejeitado continua rejeitado, e só um novo corrige o erro.
Fazer isto com a EasyCoexistence

Se a Meta rejeitar o token durante uma chamada, a ligação fica marcada para voltar a ligar de imediato e o email é enviado. As ferramentas MCP acrescentam o token atual a cada chamada, por isso não há nenhuma cópia para guardar. Entre US$ 9 e US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

O que significam os subcódigos 463 e 467 com o erro 190?

O subcódigo 463 indica que o token expirou, e o 467 que é inválido, por exemplo por ter sido revogado. Em ambos os casos, o titular da conta volta a iniciar sessão com o Instagram para obter um novo token.

Um token do Instagram expirado pode ser renovado?

Não. A renovação exige um token que não tenha expirado, por isso, depois da expiração, o titular da conta tem de voltar a iniciar sessão com o Instagram.

Alterar a palavra-passe do Instagram invalida o token?

Pode invalidar. A Meta comunica a sessão terminada por alteração da palavra-passe com o subcódigo 460, e a pessoa tem então de voltar a iniciar sessão.

Tenho de voltar a ligar a conta depois do erro 190?

Só se o token atual da conta tiver sido rejeitado. Se a chamada usou uma cópia antiga guardada, basta obter o token atual; caso contrário, o titular da conta volta a iniciar sessão com o Instagram.

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