Genuka WA docs

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ónQué vesQuié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_messagingEl mismo mensaje, en cualquier endpointEl propietario del token
Función reservada a cuentas elegiblesCódigo 10 en el endpoint de esa funciónDepende de los requisitos de Meta para esa API
WhatsApp Flows con endpoint, número no incluido en la lista de permitidosCódigo 10 al configurar la clave públicaEl 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íoEl 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 AUTHENTICATION falla con "Application does not have permission for this action" cuando la empresa no ha superado la verificación del negocio de Meta;
  • las plantillas MARKETING y UTILITY de 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 1559700625642290

El 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.

CanalQué recibes
POST /api/v1/templates403, "error": "meta_rejected", meta.code: 10
POST /api/v1/messages409, "error": "send_config", meta.code: 10; "reason": "waba_moved" cuando el número cambió de cuenta
GET /api/v1/numbers/{id}/healthgenukaStatus: "disconnected", setupIssue: "waba_moved", currentWabaId: la cuenta donde está el número
Campaña MARKETINGSi 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
403 — POST /api/v1/templates (categoría AUTHENTICATION)
{
  "error": "meta_rejected",
  "message": "Application does not have permission for this action",
  "meta": {
    "errorClass": "config",
    "retryable": false,
    "code": 10,
    "traceId": "AbC…"
  }
}
409 — POST /api/v1/messages (número movido a otra cuenta)
{
  "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_management y whatsapp_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-id y meta.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

En esta página