Token de acceso de WhatsApp: qué es y cuándo expira

Entiende qué es el token de acceso de tu canal de WhatsApp, por qué a veces aparece el error code 190 y cómo renovarlo reconectando el canal.

Jun 25, 2026

Qué es el token de acceso

Cada canal de WhatsApp que conectas en Omnifox guarda un token de acceso: una credencial que Meta nos entrega para enviar y recibir mensajes en tu nombre. Lo obtenemos automáticamente cuando conectas el número, sea por Coexistence o por Cloud API, y queda cifrado en la configuración del canal. Tú nunca tienes que copiarlo ni pegarlo a mano.

En corto: el token es la "llave" de tu número. Si caduca o se revoca, Omnifox sigue conectado pero Meta deja de aceptar los envíos.

Cuándo expira un token

Un token puede dejar de ser válido por varios motivos:

  1. Caducidad: los tokens de la sesión de Embedded Signup tienen una vida limitada. Los tokens de Usuario del Sistema pueden configurarse para no caducar nunca.
  2. Revocación: alguien cambió la contraseña de Facebook, quitó permisos a la app o desconectó el número desde el Business Manager de Meta.
  3. Cambios de permisos: si se retiran los permisos whatsapp_business_messaging o whatsapp_business_management, el token deja de servir.

El error code 190

Cuando un token caduca o se revoca, Meta responde a todos los envíos con un error de autenticación code 190 (OAuthException). Síntomas típicos:

  • No se envía ninguna plantilla ni mensaje del canal (no es un mensaje suelto: caen todos a la vez).
  • En Configuración → Canales el canal aparece con estado Error.
  • En la conversación ves un aviso de que el mensaje no se pudo entregar.

Importante: el code 190 también puede aparecer durante una caída temporal de Meta, aunque tu token siga siendo válido. Si TODOS los canales de TODAS las cuentas fallan a la vez y se recupera solo, suele ser una caída de Meta, no tu token. Revisa el estado de Meta antes de reconectar.

Cómo renovar el token

La forma correcta de renovar el token es reconectar el canal, lo que repite el proceso de conexión y guarda un token nuevo:

  1. Ve a Configuración → Canales y pulsa Conectar nuevo canal.
  2. Elige WhatsApp y escribe un nombre para el canal.
  3. Pulsa la misma tarjeta con la que conectaste la primera vez (Conectar con WhatsApp para Coexistence, o Migrar mi número / Crear número nuevo para Cloud API) y completa la ventana de Meta con la misma cuenta y el mismo número.
  4. Confirma que el estado del canal pasó a Conectado.

No existe un botón «Reconectar» dentro del canal, y aunque el botón diga «conectar nuevo canal» no se crea un duplicado: Omnifox reconoce el número por su Phone Number ID y actualiza el canal existente con el token nuevo.

Verificar que quedó bien

Tras reconectar, envía una prueba a un contacto con la ventana de 24 horas abierta o una plantilla aprobada. Si llega, el token nuevo está activo. El chequeo de estado del canal volverá a marcarlo en verde.

Si no funciona

  • Sigue en Error tras reconectar: comprueba que iniciaste sesión en la cuenta de Facebook correcta y que la app de Omnifox conserva los permisos en el Business Manager.
  • Solo fallan las plantillas, no los chats: eso no es code 190; revisa el estado de la plantilla en Meta.
  • Cuenta administrada por azur (Cloud API propia): un administrador puede cargar un token permanente de Usuario del Sistema en el modo manual del canal.

Consejos

  • Usa un Usuario del Sistema con token sin caducidad para los números críticos y evitarás renovaciones sorpresa.
  • Mantén a más de una persona como administrador del Business Manager para que nadie quede bloqueado.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp