Token de acesso do WhatsApp: o que é e quando expira

Entenda o que é o token de acesso do seu canal de WhatsApp, por que às vezes aparece o erro code 190 e como renová-lo reconectando o canal.

Jun 25, 2026

O que é o token de acesso

Cada canal de WhatsApp que você conecta no Omnifox guarda um token de acesso: uma credencial que a Meta nos entrega para enviar e receber mensagens em seu nome. Nós o obtemos automaticamente quando você conecta o número, seja por Coexistence ou por Cloud API, e ele fica criptografado nas configurações do canal. Você nunca precisa copiá-lo nem colá-lo manualmente.

Em resumo: o token é a "chave" do seu número. Se ele expira ou é revogado, o Omnifox continua conectado, mas a Meta para de aceitar seus envios.

Quando um token expira

Um token pode deixar de ser válido por vários motivos:

  1. Expiração: os tokens da sessão de Embedded Signup têm vida útil limitada. Os tokens de Usuário do Sistema podem ser configurados para nunca expirar.
  2. Revogação: alguém trocou a senha do Facebook, removeu permissões do app ou desconectou o número no Gerenciador de Negócios da Meta.
  3. Mudança de permissões: se as permissões whatsapp_business_messaging ou whatsapp_business_management forem retiradas, o token deixa de funcionar.

O erro code 190

Quando um token expira ou é revogado, a Meta responde a todos os envios com um erro de autenticação: code 190 (OAuthException). Sintomas típicos:

  • Nenhum template ou mensagem do canal é enviado (não é uma mensagem isolada: todas falham ao mesmo tempo).
  • Em Configurações → Canais o canal aparece com status Erro.
  • Na conversa você vê um aviso de que a mensagem não pôde ser entregue.

Importante: o code 190 também pode aparecer durante uma queda temporária da Meta, mesmo com o token ainda válido. Se TODOS os canais de TODAS as contas falham ao mesmo tempo e se recuperam sozinhos, normalmente é uma queda da Meta, não o seu token. Verifique o status da Meta antes de reconectar.

Como renovar o token

A forma correta de renovar o token é reconectar o canal, o que repete o processo de conexão e salva um token novo:

  1. Vá em Configurações → Canais e clique em Conectar novo canal.
  2. Escolha WhatsApp e escreva um nome para o canal.
  3. Clique no mesmo cartão que usou da primeira vez (Conectar com WhatsApp para Coexistence, ou Migrar meu número / Criar número novo para Cloud API) e conclua a janela da Meta com a mesma conta e o mesmo número.
  4. Confirme que o status do canal mudou para Conectado.

Não existe botão «Reconectar» dentro do canal, e mesmo o botão dizendo «conectar novo canal» não se cria um duplicado: o Omnifox reconhece o número pelo Phone Number ID e atualiza o canal existente com o token novo.

Verificar se deu certo

Depois de reconectar, envie um teste para um contato com a janela de 24 horas aberta, ou envie um template aprovado. Se chegar, o novo token está ativo. A verificação de status do canal voltará a ficar verde.

Se não funcionar

  • Continua em Erro após reconectar: confirme que entrou na conta certa do Facebook e que o app do Omnifox ainda tem as permissões no Gerenciador de Negócios.
  • Só os templates falham, os chats funcionam: isso não é code 190; verifique o status do template na Meta.
  • Conta gerida pelo provedor (Cloud API própria): um administrador pode carregar um token permanente de Usuário do Sistema no modo manual do canal.

Dicas

  • Use um token de Usuário do Sistema sem expiração para os números críticos e evite renovações inesperadas.
  • Mantenha mais de uma pessoa como administradora do Gerenciador de Negócios para que ninguém fique bloqueado.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp