Error 10 de WhatsApp: permiso denegado — causa y solución
Error 10 de WhatsApp: un permiso que falta, una plantilla OTP en una empresa no verificada, o "Paid Message Account" cuando el número pasó a otra cuenta de WhatsApp Business.
El error 10 de WhatsApp significa que un permiso que necesita la llamada nunca se otorgó o fue
retirado. En la Cloud API, el caso más frecuente confunde a todos: crear una plantilla
AUTHENTICATION (OTP) para una empresa que Meta no ha verificado devuelve "Application does not
have permission for this action". El problema es la empresa, no la aplicación. En un envío, el
código 10 tiene otra cara: "Viewer cannot access the provided Paid Message Account" significa que el
número se movió a otra cuenta de WhatsApp Business y hay que volver a conectarlo.
¿Qué significa el error 10?
Meta lo incluye entre los errores de autorización:
"Permission is either not granted or has been removed." — Meta, códigos de error de la Cloud API
La solución que sugiere Meta abarca tres pistas: comprobar en el depurador de tokens de acceso que la aplicación recibió los permisos que exige el endpoint; en WhatsApp Flows con endpoint, comprobar que el número de teléfono usado para configurar la clave pública de la empresa esté en la lista de permitidos; y revisar los requisitos de elegibilidad de la API que llamas, porque una cuenta que no es elegible recibe exactamente este código. La documentación general de Graph llama al código 10 "API Permission Denied" (Meta, gestión de errores de la Graph API).
¿Cuándo aparece el error 10?
| Situación | Qué ves | Quién puede corregirlo |
|---|---|---|
Crear una plantilla AUTHENTICATION para una empresa no verificada | "Application does not have permission for this action" | La empresa: verificación del negocio en Meta y luego un límite de mensajes elevado a 2.000 |
Token sin whatsapp_business_management o whatsapp_business_messaging | El mismo mensaje, en cualquier endpoint | El propietario del token |
| Función reservada a cuentas elegibles | Código 10 en el endpoint de esa función | Depende de los requisitos de Meta para esa API |
| WhatsApp Flows con endpoint, número no incluido en la lista de permitidos | Código 10 al configurar la clave pública | El propietario de la aplicación |
| Enviar desde un número movido a otra cuenta de WhatsApp Business | "Viewer cannot access the provided Paid Message Account …" en cada envío | El propietario del número: volver a conectarlo |
El caso de la plantilla OTP
Es el que cuesta horas. En las cuentas conectadas a Genuka WA, vemos que:
- crear una plantilla
AUTHENTICATIONfalla con "Application does not have permission for this action" cuando la empresa no ha superado la verificación del negocio de Meta; - las plantillas
MARKETINGyUTILITYde la misma cuenta se crean con normalidad; - el estado de salud de la cuenta muestra el error 141010, "The Business has not passed business verification".
Un desarrollador reportó la misma respuesta en el foro de Meta, con error_subcode: 2388185 y el
mensaje para el usuario "This WhatsApp Business account does not have permission to create message
template"
(foro de desarrolladores de Meta).
El mensaje culpa a la aplicación. Ningún ajuste de token ni de permisos cambia nada.
Tampoco puedes rodearlo con una plantilla de utilidad: cuando una aplicación ofrece a sus usuarios contraseñas de un solo uso o códigos de verificación por WhatsApp, Meta exige una plantilla de autenticación (Meta, Authentication templates).
El número que cambió de cuenta
Meta permite mover un número de teléfono de una cuenta de WhatsApp Business (WABA) a otra, por ejemplo cuando el comerciante reorganiza su portafolio de Meta. Ningún webhook se lo avisa a la aplicación que enviaba en su nombre. Meta factura cada mensaje a la WABA del número: el envío nombra la cuenta anterior, que ya no está compartida con Genuka WA, y cada mensaje vuelve con:
(#10) Viewer cannot access the provided Paid Message Account 1559700625642290El número es el ID de la WABA anterior. El token, los permisos y la plantilla no son el problema, y reintentar no cambia nada.
Genuka WA lo detecta de dos maneras. En el primer envío rechazado, leemos
GET /{PHONE_NUMBER_ID}?fields=health_status: la entidad WABA de la respuesta es la cuenta donde
está el número hoy (Meta, Health status).
GET /api/v1/numbers/{id}/health hace la misma lectura a pedido. Si esa cuenta no es la que
conocemos, el número pasa a disconnected con setupIssue: "waba_moved", y el panel lo muestra
como "Reconexión necesaria".
¿Dónde lo ves en Genuka WA?
Genuka WA clasifica el código 10 en la clase config: token, permiso o registro, nada que un
reintento pueda arreglar.
| Canal | Qué recibes |
|---|---|
POST /api/v1/templates | 403, "error": "meta_rejected", meta.code: 10 |
POST /api/v1/messages | 409, "error": "send_config", meta.code: 10; "reason": "waba_moved" cuando el número cambió de cuenta |
GET /api/v1/numbers/{id}/health | genukaStatus: "disconnected", setupIssue: "waba_moved", currentWabaId: la cuenta donde está el número |
Campaña MARKETING | Si la Marketing Messages API rechaza con este código, Genuka reenvía el mensaje por el endpoint normal /messages; si este también lo rechaza, el destinatario pasa a failed |
{
"error": "meta_rejected",
"message": "Application does not have permission for this action",
"meta": {
"errorClass": "config",
"retryable": false,
"code": 10,
"traceId": "AbC…"
}
}{
"error": "send_config",
"message": "This number changed WhatsApp Business account. It now belongs to WhatsApp Business account 2222464398692076, not 1559700625642290, and the new account is not shared with Genuka WA. Reconnect the number (Embedded Signup) to share its new account, then send again. Meta's wording: \"(#10) Viewer cannot access the provided Paid Message Account 1559700625642290\".",
"meta": {
"errorClass": "config",
"retryable": false,
"code": 10,
"traceId": "AbC…"
},
"reason": "waba_moved",
"wabaId": "1559700625642290",
"currentWabaId": "2222464398692076",
"docUrl": "https://wa.genuka.com/en/docs/errors/10"
}¿Cómo corrijo el error 10?
En un número que cambió de cuenta
Confirma el cambio. GET /api/v1/numbers/{id}/health devuelve setupIssue: "waba_moved" y
currentWabaId. El mensaje de error del envío incluye ambos ID.
Vuelve a conectar el número. Ejecuta de nuevo el Embedded Signup con este número y elige su nueva cuenta de WhatsApp Business: desde Números > Agregar un número si el número es tuyo, o enviando tu enlace de conexión al cliente. Así se comparte la nueva cuenta con Genuka WA y se actualiza el número. No se pierde nada: los mensajes, las estadísticas y los ajustes siguen vinculados al número.
Revisa las plantillas. Una plantilla pertenece a una WABA. Las plantillas de la cuenta anterior no siguen al número: sincroniza las plantillas y vuelve a crear las que falten en la nueva cuenta.
En una plantilla de autenticación
Confirma la causa. En Meta Business Suite, Centro de seguridad > Verificación del negocio
muestra el estado de verificación del portafolio comercial dueño de la cuenta de WhatsApp. Si
llamas tú mismo a Graph, GET /{WABA_ID}?fields=business_verification_status,health_status
responde en una sola solicitud: business_verification_status se describe en la
referencia de la cuenta de WhatsApp Business,
y health_status en Health status.
Haz verificar la empresa. El trámite comienza en Meta Business Suite, en el portafolio comercial dueño de la cuenta de WhatsApp (Meta, Verifica tu negocio). Los detalles están en la página del error 141010.
Vuelve a crear la plantilla una vez que la empresa esté verificada y el límite haya subido a
2.000 (Administrador de WhatsApp, en inglés WhatsApp Manager: Account tools > Messaging limits). El mismo
POST /api/v1/templates, con "category": "AUTHENTICATION": consulta la guía
Códigos OTP desde Node.js.
En un permiso que falta
- Si el token es tuyo: ábrelo en el
depurador de tokens de acceso,
comprueba
whatsapp_business_managementywhatsapp_business_messaging, y vuelve a generarlo con ambos si falta alguno (Meta, soporte de WhatsApp). - Si usas Genuka WA: no tienes ningún token de Meta que corregir. Un código 10 fuera de una
plantilla de autenticación y fuera de "Paid Message Account" le corresponde a Genuka: contacta
al soporte con el encabezado
x-request-idymeta.traceId.
¿Cómo evito el error 10?
- Haz verificar la empresa antes de planificar OTP por WhatsApp. Es un requisito de Meta, no una opción de Genuka.
- Prueba el flujo de autenticación en una cuenta verificada antes de anunciar la función: una cuenta de prueba no verificada siempre fallará.
- Conserva ambos permisos de WhatsApp en cualquier token que generes tú mismo.
Códigos de error relacionados
- 141010: la empresa no ha superado la verificación del negocio de Meta.
- 200: el token no tiene acceso a la cuenta, o falta un permiso (200 a 299).
- 3: falta una capacidad o un permiso para este endpoint.
- 190: el token expiró.
Preguntas frecuentes
¿Por qué Meta culpa a la aplicación si mi token está bien?
Porque el mensaje es genérico. En una plantilla AUTHENTICATION lo vemos cuando la empresa no está
verificada, aunque el token y sus permisos sean correctos: las plantillas de marketing y de
utilidad de la misma cuenta se crean sin problema.
¿Puedo enviar códigos OTP con una plantilla de utilidad mientras tanto?
No. Meta exige una plantilla de autenticación para los códigos de un solo uso. Hasta que termine la verificación, envía tus códigos por otro canal, SMS o correo electrónico.
¿Debo regenerar mi clave API de Genuka?
No. Tu clave de Genuka no interviene en los permisos de Meta. Un problema con la clave produce un
401 de Genuka, nunca un código 10.
¿El código 10 también bloquea mis envíos?
No en el caso de la plantilla OTP: solo se rechaza la creación de plantillas AUTHENTICATION. Tus
plantillas aprobadas de marketing y de utilidad siguen saliendo. En cambio, "Paid Message Account"
bloquea todos los envíos del número hasta que se vuelva a conectar.
¿Por qué mi número pasó a "disconnected" si no hice nada?
Porque el número salió de la cuenta de WhatsApp Business con la que estaba conectado. Meta no
avisa a nadie del cambio: lo vemos en el primer envío rechazado o al leer el estado de salud del
número. Volver a conectar el número lo devuelve a connected.
Fuentes
- Meta — Error codes
- Meta — Graph API, Handling errors
- Meta — Authentication templates
- Meta — Health status
- Meta — WhatsApp Business Account API
- Meta — Messaging limits
- Meta — WhatsApp support, authentication and authorization errors
- Meta — Verify your business in Meta Business Suite
- Meta developer forum — error 10 on an authentication template
Error 3 de WhatsApp: falta una capacidad o un permiso
Error 3 de la Cloud API de WhatsApp (Capability or permissions issue): en qué se diferencia de los errores 0, 10, 190 y 200, y cómo corregirlo.
Error 190 de WhatsApp: token de acceso vencido — causa y solución
Error 190 de la Cloud API de WhatsApp (token de acceso vencido): qué token venció, cómo reemplazarlo de forma definitiva y por qué los usuarios de Genuka WA nunca manejan tokens de Meta.