Error 131005 de WhatsApp: acceso denegado, falta permiso
El error 131005 indica que al token de acceso le falta un permiso requerido por el endpoint de WhatsApp, porque nunca se concedió o se retiró después. La descripción de Meta es "Permission is either not granted or has been removed." La solución es inspeccionar el token con el depurador de tokens de acceso y conceder el permiso faltante o cambiar a un token que lo tenga.
El código de Meta para "Permission is either not granted or has been removed."
El permiso necesario para enviar cualquier tipo de mensaje a usuarios de WhatsApp.
business_management, whatsapp_business_management y whatsapp_business_messaging, asignados al generar un token de usuario del sistema.
¿Qué significa el error 131005 de WhatsApp?
Significa que el token se acepta como auténtico, pero no incluye el permiso que comprueba el endpoint.
La referencia de Cloud API de Meta incluye el código 131005 con el texto detallado "Permission is either not granted or has been removed." El error 10 de Graph API contiene la misma frase. La única diferencia es el rango: el 10 es un código genérico de Graph API, mientras que el 131005 pertenece a los códigos de WhatsApp que comienzan por 131.
Como las palabras son las mismas, el diagnóstico también lo es. Para ambos, Meta recomienda usar el depurador de tokens de acceso y confirmar que la aplicación tiene los permisos requeridos por el endpoint.
¿Qué permiso suele faltar?
Normalmente falta uno de los dos permisos de WhatsApp, y cuál sea depende de lo que haga la llamada.
La guía de permisos de Meta los divide por función. whatsapp_business_messaging es necesario para enviar cualquier tipo de mensaje y recibir webhooks de mensajes y estados. whatsapp_business_management es necesario para los metadatos de la cuenta, gestionar plantillas, listar números de teléfono, consultar analíticas y recibir webhooks de la cuenta.
Un token generado solo con el permiso de gestión puede leer la cuenta y listar plantillas, pero fallará en cuanto intente enviar un mensaje. Al generar un token de usuario del sistema, la guía de tokens de acceso de Meta indica que deben asignarse juntos business_management, whatsapp_business_management y whatsapp_business_messaging.
¿Cómo se corrige el error 131005?
Lee primero el token y cambia solo lo que falte.
Llama al endpoint debug_token o pega el token en el depurador de tokens de acceso. La propiedad scopes enumera todos los permisos concedidos. Compárala con la página de referencia del endpoint que falló.
Si falta un permiso, genera un token nuevo que lo incluya o pide al propietario del negocio que lo conceda de nuevo si el token procede de un flujo de socio. Si todos los permisos están presentes y el error continúa, comprueba que el usuario del sistema asociado al token tenga acceso a la cuenta de WhatsApp Business específica, ya que un token puede tener todos los alcances necesarios y aun así no estar asignado a ese recurso.
Errores comunes
- Suponer que el token caducó. La caducidad devuelve 190 o 0. Este código significa que el token funciona, pero carece de un permiso.
- Generar un token solo con el permiso de gestión y usarlo para enviar mensajes. Para enviar se necesita whatsapp_business_messaging.
- Comprobar los alcances y detenerse ahí. Un usuario del sistema también necesita acceso concedido a esa cuenta de WhatsApp Business específica.
EasyCoexistence incorpora cada número mediante Embedded Signup de Meta, donde el negocio concede a la aplicación sus permisos, y su conector MCP informa del estado del número para que un asistente pueda comprobarlo antes de enviar.
Preguntas frecuentes
¿Es el error 131005 igual que el 10?
Tienen la misma descripción en la referencia de Meta. El 131005 pertenece al rango de WhatsApp y el 10 al rango de Graph API.
¿Pueden retirar un permiso después de la configuración?
Sí. La descripción de Meta incluye explícitamente los permisos retirados, no solo los que nunca se concedieron.
¿El error 131005 afecta a la app de WhatsApp Business del teléfono?
No. Se refiere al token de la API. La app del teléfono sigue funcionando como antes.
¿Debo reintentar después del error 131005?
No. Reintentar con el mismo token produce el mismo resultado. Corrige primero el permiso.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el