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.
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:
- 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.
- 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.
- Mudança de permissões: se as permissões
whatsapp_business_messagingouwhatsapp_business_managementforem 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:
- Vá em Configurações → Canais e clique em Conectar novo canal.
- Escolha WhatsApp e escreva um nome para o canal.
- 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.
- 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
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.