Glossário · Erros da Meta

Erro 190 no WhatsApp Business API

Token expirado

Mensagem da Meta
Access token has expired
Resposta HTTP
401
Família
Token e permissões

O erro 190 é devolvido quando o token de acesso usado nas chamadas à Graph API expirou ou foi invalidado. Enquanto ele não for renovado, nada funciona para aquela conta: nem envio, nem consulta, nem recebimento de status.

Por que este erro acontece

  • O token era de curta duração e venceu.
  • A senha do usuário dono do token foi alterada.
  • O acesso do aplicativo foi removido no Gerenciador de Negócios.
  • O usuário que autorizou saiu da empresa e teve o acesso revogado.

Como resolver

  1. Reconecte o canal na plataforma de atendimento para gerar um token novo.
  2. Prefira token de sistema, ligado ao Gerenciador de Negócios e não a uma pessoa.
  3. Confira no depurador de token da Meta a validade e as permissões antes de assumir que o problema é outro.

O que não adianta tentar

Reenviar a mensagem. Sem token válido nenhuma chamada passa.

O que a Skynet.Talk mostra na tela

A Meta devolve o código cru em inglês. A plataforma traduz para uma frase que diz a causa e a ação: "A autorização com a Meta expirou. Reconecte o canal para gerar um novo acesso." Código desconhecido cai no texto original com o número na frente, porque traduzir nunca pode engolir a informação.

Erros relacionados

Erro 131005 — Acesso negado

O token é válido, mas não tem permissão para aquela operação ou para aquele número.

Erro 10 — Aplicativo sem permissão para a ação

A permissão exigida pela ação não foi concedida ao aplicativo, ou foi removida.

Erro 0 — Falha de autenticação

A Meta não conseguiu autenticar o usuário do aplicativo na chamada.

Perguntas frequentes

Por que o erro apareceu do nada?
Quase sempre porque a pessoa que autorizou trocou a senha ou saiu da empresa. Token de sistema evita esse desligamento silencioso.
Perco mensagens enquanto o token está vencido?
As mensagens que os clientes enviam continuam registradas na Meta e chegam quando a conexão volta. O que falha nesse intervalo é o envio.

Este erro aparece no meio de um atendimento e some no log de quem integra direto com a Meta. Na Skynet.Talk ele vira uma frase em português na tela de quem atende. Veja o catálogo completo dos códigos ou entenda como a Meta cobra por mensagem.

Publicado por Skynet.Talk · catálogo revisado em 18 de agosto de 2026 · código conferido na documentação oficial da Meta.

Falar com vendas no WhatsApp