# Error 141010 de WhatsApp: empresa no verificada — solución

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

> Error 141010 de WhatsApp "The Business has not passed business verification": por qué se rechazan tus plantillas de OTP y cómo desbloquearlas.

El error 141010 de WhatsApp significa que la empresa propietaria de la cuenta de WhatsApp no superó la verificación
de empresa de Meta. Aparece en el estado de salud de la cuenta, no en una respuesta de envío. La
consecuencia práctica: las plantillas de autenticación (códigos OTP) se rechazan, mientras que las plantillas de marketing y
de utilidad siguen funcionando con normalidad en la misma cuenta.

## ¿Qué significa el error 141010?

No lo encontrarás en la lista pública de códigos de error de la Cloud API de Meta. Viene del
campo `health_status` que Meta expone en la cuenta de WhatsApp, el número de teléfono y las plantillas. Para
cada entidad involucrada (número, cuenta, portafolio comercial, app), Meta puede adjuntar una lista `errors`
en la que cada elemento lleva un `error_code`, un `error_description` y un `possible_solution`
([Meta, Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status)).

En las cuentas conectadas a Genuka WA cuya empresa no está verificada, esto es lo que leemos:

```json title="Extracto de health_status"
{
  "error_code": 141010,
  "error_description": "The Business has not passed business verification"
}
```

La verificación de empresa se aplica al portafolio comercial de Meta propietario de la cuenta de WhatsApp. No
tiene nada que ver con el estatus de proveedor de Genuka: Genuka es Meta Tech Provider, y es tu
empresa la que debe estar verificada.

## ¿Cuándo ocurre el error 141010?

En cuanto se conecta un número bajo un portafolio no verificado. El Embedded Signup de Meta te permite
conectar un número sin verificación, y muchas empresas empiezan así. El código permanece silencioso
hasta el día en que creas una plantilla de autenticación:

| Lo que haces                                                                     | Empresa no verificada                                                                             | Empresa verificada                                                                 |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Crear una plantilla `MARKETING` o `UTILITY`                                      | Aceptada                                                                                          | Aceptada                                                                           |
| Crear una plantilla `AUTHENTICATION` (OTP)                                       | Rechazada: error [10](https://wa.genuka.com/es/docs/errors/10), "Application does not have permission for this action" | Aceptada cuando el límite pasó a 2.000                                             |
| Llegar a destinatarios únicos fuera de la ventana de servicio, por cada 24 horas | 250 para empezar                                                                                  | 2.000 cuando Meta aprueba la calidad de tus mensajes, y luego aumentos automáticos |

Los límites son de Meta: un portafolio nuevo empieza en 250, y la verificación es uno de los caminos hacia
2.000 ([Meta, Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)).

¿Por qué los códigos OTP? Meta reserva la categoría `AUTHENTICATION` para las empresas que completaron uno de sus
caminos de escalamiento, como la verificación de empresa, con un límite de mensajería de al menos 2.000
conversaciones iniciadas por la empresa al día; deben cumplirse ambas condiciones
([360dialog, Authentication messages](https://docs.360dialog.com/docs/resources/authentication-messages)).
Por lo tanto, la verificación sola no basta: después de un camino de escalamiento, Meta analiza la calidad de tus
mensajes y puede denegar el aumento, en cuyo caso tu límite se queda donde está
([Meta, Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)).
De 60 cuentas de clientes de Genuka WA auditadas en septiembre de 2026, ninguna de las 45 no verificadas tiene una
plantilla de autenticación; la única del conjunto pertenece a una cuenta verificada.

### ¿Dónde lo ves en Genuka WA?

| Canal                                                       | Lo que ves                                                                                                                 |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `POST /api/v1/templates` con `"category": "AUTHENTICATION"` | `403 meta_rejected`, `meta.code: 10`, mensaje "Application does not have permission for this action"                       |
| Meta Business Suite                                         | El estado de verificación del portafolio, en **Centro de seguridad** (en inglés, *Security Center*)                        |
| Servidor MCP de Genuka, herramienta `create_template`       | El error llega con una explicación de este caso para tu agente de IA — consulta [Agentes de IA](https://wa.genuka.com/es/docs/guides/ai-agents) |

La API de Genuka WA no transmite `health_status` por sí misma: no tienes un token de Meta con el que consultarlo,
y el estado de verificación es más fácil de leer en Meta Business Suite.

## ¿Cómo corrijo el error 141010?

1. **Revisa el estado actual.** En Meta Business Suite, abre **Centro de seguridad > Verificación del negocio**
   (en inglés, *Security Center > Business Verification*) en el portafolio propietario de la cuenta de WhatsApp
   ([Meta, Embedded Signup errors](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/errors)).
   Si llamas tú mismo a Graph, `GET /{WABA_ID}?fields=business_verification_status,health_status`
   devuelve ambos; Meta documenta valores como `VERIFIED`, `PENDING` y `NOT_VERIFIED` para el primero
   ([Meta, WhatsApp Business Account API](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)).
   Compara sin distinguir mayúsculas de minúsculas: cuando lo verificamos, la API devolvió `not_verified`, en minúsculas.
2. **Inicia la verificación.** La solicitas desde Meta Business Suite, en ese mismo portafolio
   ([Meta, Verify your business](https://www.facebook.com/business/help/2058515294227817)). Genuka
   no interviene: es un trámite entre tu empresa y Meta.
3. **Vuelve a crear la plantilla de autenticación.** Una vez que la empresa esté verificada y el límite haya pasado a
   2.000 (visible en el Administrador de WhatsApp (en inglés, *WhatsApp Manager*), **Account tools > Messaging limits**, o en el campo
   `whatsapp_business_manager_messaging_limit` del número), envía de nuevo la misma plantilla. Meta redacta
   el texto de las plantillas de autenticación: tú solo proporcionas la estructura.

**Node.js**

```ts
const response = await fetch("https://wa.genuka.com/api/v1/templates", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    connectionId: "con_1",
    name: "verification_code",
    language: "en_US",
    category: "AUTHENTICATION",
    messageSendTtlSeconds: 600,
    components: [
      { type: "BODY", add_security_recommendation: true },
      { type: "FOOTER", code_expiration_minutes: 10 },
      { type: "BUTTONS", buttons: [{ type: "OTP", otp_type: "COPY_CODE", text: "Copy code" }] },
    ],
  }),
});
const json = await response.json();

if (response.status === 403 && json.meta?.code === 10) {
  // Empresa no verificada (141010): no hay nada que corregir en tu código ni en tu clave.
  throw new Error("Se requiere la verificación de empresa de Meta para las plantillas de OTP");
}
if (!response.ok) throw new Error(`${response.status} ${json.error}: ${json.message ?? ""}`);
console.log(json.data.id, json.data.status);
```

**Python**

```python
import os
import requests

response = requests.post(
    "https://wa.genuka.com/api/v1/templates",
    headers={"Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}"},
    json={
        "connectionId": "con_1",
        "name": "verification_code",
        "language": "en_US",
        "category": "AUTHENTICATION",
        "messageSendTtlSeconds": 600,
        "components": [
            {"type": "BODY", "add_security_recommendation": True},
            {"type": "FOOTER", "code_expiration_minutes": 10},
            {"type": "BUTTONS", "buttons": [{"type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code"}]},
        ],
    },
    timeout=30,
)
body = response.json()

if response.status_code == 403 and (body.get("meta") or {}).get("code") == 10:
    # Empresa no verificada (141010): no hay nada que corregir en tu código ni en tu clave.
    raise RuntimeError("Se requiere la verificación de empresa de Meta para las plantillas de OTP")
response.raise_for_status()
print(body["data"]["id"], body["data"]["status"])
```

**PHP**

```php
<?php
$ch = curl_init("https://wa.genuka.com/api/v1/templates");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => "acme-crm/1.0 (+https://example.com)",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("GENUKA_WA_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "connectionId" => "con_1",
        "name" => "verification_code",
        "language" => "en_US",
        "category" => "AUTHENTICATION",
        "messageSendTtlSeconds" => 600,
        "components" => [
            ["type" => "BODY", "add_security_recommendation" => true],
            ["type" => "FOOTER", "code_expiration_minutes" => 10],
            ["type" => "BUTTONS", "buttons" => [["type" => "OTP", "otp_type" => "COPY_CODE", "text" => "Copy code"]]],
        ],
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($status === 403 && ($body["meta"]["code"] ?? null) === 10) {
    // Empresa no verificada (141010): no hay nada que corregir en tu código ni en tu clave.
    throw new RuntimeException("Se requiere la verificación de empresa de Meta para las plantillas de OTP");
}
echo $body["data"]["id"] ?? $body["error"];
```

**curl**

```bash
curl -X POST https://wa.genuka.com/api/v1/templates \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "con_1",
    "name": "verification_code",
    "language": "en_US",
    "category": "AUTHENTICATION",
    "messageSendTtlSeconds": 600,
    "components": [
      { "type": "BODY", "add_security_recommendation": true },
      { "type": "FOOTER", "code_expiration_minutes": 10 },
      { "type": "BUTTONS", "buttons": [ { "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" } ] }
    ]
  }'
# Empresa no verificada: 403 { "error": "meta_rejected", "meta": { "code": 10, … } }
```

### ¿Y si la empresa no puede verificarse de inmediato?

Meta describe otros dos caminos hacia 2.000 destinatarios al día: la verificación por parte del socio que
te incorporó, y 2.000 mensajes entregados fuera de las ventanas de servicio a destinatarios únicos en un período
móvil de 30 días, usando plantillas de alta calidad
([Meta, Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)).
Estos caminos elevan tu límite de mensajería. Según 360dialog, la condición para los OTP es haber completado un camino
de escalamiento, no la verificación en sí; pero ninguna de las cuentas no verificadas que auditamos tiene una
plantilla de autenticación. Mientras tanto, envía tus códigos por SMS o correo electrónico y reserva WhatsApp para tus
notificaciones: consulta [API de WhatsApp sin verificación de Meta](https://wa.genuka.com/es/docs/guides/without-meta-verification).

## ¿Cómo evito el error 141010?

* **Inicia la verificación en cuanto planees usar códigos OTP**, antes de escribir el flujo de inicio de sesión: es el
  único paso que no controlas.
* **Verifica el portafolio correcto.** El que es propietario de la cuenta de WhatsApp conectada, no otro
  portafolio de la misma empresa.
* **Prueba la creación de la plantilla `AUTHENTICATION` en la cuenta de producción**: una cuenta de prueba
  no verificada siempre fallará, haga lo que haga tu código.

## Códigos de error relacionados

* [10](https://wa.genuka.com/es/docs/errors/10): la respuesta que devuelve Meta al crear la plantilla de OTP.
* [200](https://wa.genuka.com/es/docs/errors/200): un verdadero problema de permisos o de acceso a la cuenta, que no debes confundir
  con este.
* `2388098`: durante el Embedded Signup, Meta limita cuántas cuentas de WhatsApp puede crear una empresa
  no verificada
  ([Meta, Embedded Signup errors](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/errors)).

## Preguntas frecuentes

### ¿Se pueden enviar mensajes de WhatsApp sin verificación de empresa?

Sí. Las plantillas de marketing y de utilidad, y las respuestas dentro de la ventana de servicio de 24 horas, funcionan sin
verificación, con un límite inicial de 250 destinatarios únicos por cada 24 horas. Solo los códigos OTP la exigen.

### ¿Por qué el error habla de un permiso de la aplicación?

Porque Meta responde a la creación de la plantilla con un error de permiso genérico, el código 10. La causa
real es la empresa: la misma cuenta crea plantillas de marketing sin ningún problema.

### ¿Por qué falta el 141010 en la lista de códigos de error de Meta?

Es un código de diagnóstico de `health_status`, que describe por qué una entidad está limitada, no un código devuelto
por una llamada a la API. La lista pública de Meta solo cubre estos últimos.

### ¿Tengo que volver a crear la plantilla después de la verificación?

Sí. Una plantilla rechazada al crearla no existe del lado de Meta: envíala de nuevo cuando la
empresa esté verificada y el límite de la cuenta haya pasado a 2.000.

## Fuentes

* [Meta — Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status)
* [Meta — Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)
* [Meta — WhatsApp Business Account API](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
* [Meta — Embedded Signup flow errors](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/errors)
* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Verify your business in Meta Business Suite](https://www.facebook.com/business/help/2058515294227817)
* [360dialog — Authentication messages](https://docs.360dialog.com/docs/resources/authentication-messages)
