Error 10 de WhatsApp: permiso no concedido o retirado
El código de error 10 indica que el token de la app carece de un permiso que necesita el endpoint, porque nunca se concedió o porque fue retirado. La descripción de Meta es "Permission is either not granted or has been removed." Meta también señala dos causas de WhatsApp: un número no incluido en la lista de permitidos en Flows with Endpoint y no cumplir los requisitos de elegibilidad de una API.
El código de Meta para "Permission is either not granted or has been removed."
El nombre que la guía de gestión de errores de Graph API da al código 10.
Lo que necesita una app asociada para cada permiso que usa en las cuentas de clientes.
¿Qué significa el código de error 10 de WhatsApp?
Significa que el token llegó a Meta y fue reconocido, pero no incluye el permiso que requiere la llamada.
La referencia de Cloud API de Meta muestra para el código 10 el texto de detalles "Permission is either not granted or has been removed." La guía de gestión de errores de Graph API lo denomina API Permission Denied e indica que se debe gestionar el permiso que falta.
La palabra retirado es importante. Un permiso puede concederse durante la configuración y retirarse después, por ejemplo, cuando alguien revoca el acceso de la app en Business Settings. Por eso, una integración que funcionó durante meses puede empezar a devolver 10 sin cambios en su propio código.
¿Qué otras causas señala Meta para el error 10?
Hay dos específicas de WhatsApp, y ambas son fáciles de pasar por alto porque no tienen que ver con los permisos solicitados.
Para WhatsApp Flows with Endpoint, Meta indica que se debe comprobar que el número de teléfono usado para configurar la clave pública del negocio esté incluido en la lista de permitidos. Un número fuera de esa lista produce este código incluso cuando el token incluye todos los permisos.
Meta también indica que una cuenta que no cumple los requisitos de elegibilidad de la API que está usando recibe este código. En ese caso, ningún cambio en el token ayudará, porque el bloqueo depende de la elegibilidad de la cuenta y no de la credencial.
¿Cómo se corrige el error 10?
Empieza con el depurador de tokens de acceso, que Meta menciona como primera comprobación.
Si la lista de permisos no incluye el permiso que necesita el endpoint, haz que el negocio lo conceda de nuevo. Para una app asociada, eso también implica confirmar el acceso avanzado para ese permiso, ya que la guía de permisos de Meta lo exige para las cuentas de clientes.
Si la lista de permisos está completa, revisa las dos causas específicas de WhatsApp. En una llamada de Flows, comprueba la lista de permitidos para el número que configuró la clave pública. En cualquier otro caso, lee los requisitos de elegibilidad de la API que estás usando y confirma que la cuenta los cumple antes de cambiar ninguna credencial.
Errores comunes
- Suponer que la integración dejó de funcionar por un despliegue. Un permiso retirado en Business Settings produce este código sin ningún cambio de código.
- Regenerar el token cuando la causa es la elegibilidad. Una credencial no puede hacer elegible a una cuenta que no lo es.
- Ignorar la lista de permitidos de Flows. En Flows with Endpoint, un número que está fuera de ella devuelve 10 incluso con todos los permisos.
EasyCoexistence sigue supervisando cada número conectado después de la incorporación, así que una conexión que pierde acceso aparece en el panel en vez de detectarse primero por envíos fallidos.
Preguntas frecuentes
¿El error 10 es igual que el error 131005?
Comparten la misma descripción en la referencia de Meta. El código 10 es el código de Graph API y 131005 pertenece al rango de WhatsApp. Ambos se comprueban de la misma manera.
¿Puede aparecer el error 10 en un número que funcionaba ayer?
Sí. La descripción de Meta incluye permisos que fueron retirados, por lo que un acceso concedido anteriormente puede revocarse después.
¿El error 10 significa que mi token caducó?
No. Un token caducado corresponde al código 190 o 0. El código 10 significa que el token es válido, pero carece de un permiso.
¿Cómo puedo ver qué permisos se concedieron?
Llama a debug_token o abre el depurador de tokens de acceso. La propiedad scopes enumera todos los permisos del token.
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