# Error 10 de WhatsApp: permiso denegado — causa y solución

URL: https://wa.genuka.com/es/docs/errors/10
Language: Spanish

> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#authorization-errors)

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](https://developers.facebook.com/docs/graph-api/guides/error-handling)).

## ¿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 `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](https://wa.genuka.com/es/docs/errors/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](https://developers.facebook.com/community/threads/1372007877817645/)).
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](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/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:

```text
(#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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/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` |

```json title="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…"
  }
}
```

```json title="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

1. **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.
2. **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.
3. **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

1. **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](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api),
   y `health_status` en [Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status).
2. **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](https://www.facebook.com/business/help/2058515294227817)).
   Los detalles están en la página del [error 141010](https://wa.genuka.com/es/docs/errors/141010).
3. **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](https://wa.genuka.com/es/docs/guides/whatsapp-otp-nodejs).

### En un permiso que falta

* **Si el token es tuyo**: ábrelo en el
  [depurador de tokens de acceso](https://developers.facebook.com/tools/debug/accesstoken/),
  comprueba `whatsapp_business_management` y `whatsapp_business_messaging`, y vuelve a generarlo
  con ambos si falta alguno
  ([Meta, soporte de WhatsApp](https://developers.facebook.com/documentation/business-messaging/whatsapp/support#authentication-authorization)).
* **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](https://wa.genuka.com/es/docs/errors/141010): la empresa no ha superado la verificación del negocio de Meta.
* [200](https://wa.genuka.com/es/docs/errors/200): el token no tiene acceso a la cuenta, o falta un permiso (200 a 299).
* [3](https://wa.genuka.com/es/docs/errors/3): falta una capacidad o un permiso para este endpoint.
* [190](https://wa.genuka.com/es/docs/errors/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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Graph API, Handling errors](https://developers.facebook.com/docs/graph-api/guides/error-handling)
* [Meta — Authentication templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates)
* [Meta — Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status)
* [Meta — WhatsApp Business Account API](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
* [Meta — Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)
* [Meta — WhatsApp support, authentication and authorization errors](https://developers.facebook.com/documentation/business-messaging/whatsapp/support#authentication-authorization)
* [Meta — Verify your business in Meta Business Suite](https://www.facebook.com/business/help/2058515294227817)
* [Meta developer forum — error 10 on an authentication template](https://developers.facebook.com/community/threads/1372007877817645/)
