# Error 100 de WhatsApp: Invalid parameter — causa y solución

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

> Error 100 de WhatsApp Cloud API (Invalid parameter): un parámetro desconocido, mal escrito o demasiado largo. Cómo leer details y corregir la solicitud.

El error 100 de WhatsApp significa que tu solicitud a la Cloud API contiene un parámetro que Meta no
reconoce, uno mal escrito o un valor que supera un límite de longitud. Suele ser un error de
contenido: volver a enviar la misma solicitud siempre fallará. La causa generalmente aparece en el
campo `details`; con el subcódigo 33, lo que está mal es el ID al que apuntas.

## ¿Qué significa el error 100?

Meta lo clasifica entre los "otros errores" de la Cloud API:

> "The request included one or more unsupported or misspelled parameters."
> — [Meta, códigos de error de la Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

La solución que sugiere Meta enumera cuatro comprobaciones: leer la referencia del endpoint para
ver los parámetros admitidos y cómo se escriben; en WhatsApp Flows con endpoint, proporcionar una
clave pública RSA válida de 2048 bits en formato PEM; asegurarte de que el `phone_number_id` que
registras coincida con el almacenado anteriormente; y respetar las restricciones de longitud de
cada tipo.

En la respuesta de Graph, `message` suele ser `(#100) Invalid parameter`, un título genérico. La
información útil está en otra parte: Meta describe `details` como el campo que puede indicar "which
parameter is invalid or what values are acceptable" (qué parámetro no es válido o qué valores se
aceptan) (misma página).

## ¿Cuándo aparece el error 100?

| Situación                                                                           | Qué devuelve Meta                                                                                                                                                                   | Fuente                                                                                                                                                             |
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Parámetro desconocido o mal escrito                                                 | `(#100) Invalid parameter`, con el parámetro problemático en `details`                                                                                                              | Meta                                                                                                                                                               |
| Valor que supera un límite de longitud                                              | El mismo código                                                                                                                                                                     | Meta                                                                                                                                                               |
| Clave pública de Flows que no es una clave RSA de 2048 bits en PEM                  | El mismo código                                                                                                                                                                     | Meta                                                                                                                                                               |
| Mensaje que no es de plantilla enviado a la Marketing Messages API                  | `details`: "Message must be a template message."                                                                                                                                    | [Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#marketing-messages-api-for-whatsapp-error-codes)              |
| ID de número de teléfono o de cuenta incorrecto, o un token sin acceso a ese activo | `error_subcode: 33` y "Unsupported post request. Object with ID '…' does not exist, cannot be loaded due to missing permissions, or does not support this operation", sin `details` | Reportes de desarrolladores: [Activepieces](https://community.activepieces.com/t/whatsapp-business-error/4324), [Fast2SMS](https://www.fast2sms.com/help/?p=17132) |
| Enviar desde un número a sí mismo                                                   | `(#100) Invalid parameter`, sin ningún detalle                                                                                                                                      | Observación de Genuka                                                                                                                                              |
| Eliminar una plantilla sin derechos sobre la cuenta de WhatsApp                     | `(#100) Need permission on either WhatsApp Business Account or owner/shared business`                                                                                               | Observación de Genuka                                                                                                                                              |

Las dos últimas filas provienen de nuestras propias llamadas. Para un envío a uno mismo, Meta en
realidad documenta un código específico, `131021` ("Sender and recipient phone number is the
same"), pero lo que recibimos fue un `100` sin más.

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

Genuka WA valida gran parte de la solicitud **antes** que Meta, y entonces responde sin que Meta
vea nada:

| Comprobación de Genuka                                                   | Respuesta                                                            |
| ------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| Mensaje sin campo de contenido, multimedia sin `assetId`, `id` ni `link` | `400 missing_content`, `400 invalid_media`                           |
| Plantilla con componentes mal formados                                   | `400 invalid_template` (se puede desactivar con `"validate": false`) |
| `to` igual al número que envía                                           | `400 recipient_is_sender`                                            |

Cuando el rechazo viene de Meta, Genuka transmite el código 100 sin reclasificarlo: la clase es
`unknown`, no reintentable.

```json title="400 — POST /api/v1/messages"
{
  "error": "send_unknown",
  "message": "…the details text, when Meta provides one…",
  "meta": {
    "errorClass": "unknown",
    "retryable": false,
    "code": 100,
    "details": "…",
    "traceId": "AbC…"
  }
}
```

En `POST /api/v1/templates`, el mismo rechazo vuelve como `422 meta_rejected` con el mismo objeto
`meta`. Genuka nunca valida el campo `raw` de `POST /api/v1/messages`: los errores vuelven
directamente de Meta ([Enviar mensajes](https://wa.genuka.com/es/docs/messages)).

En una campaña `MARKETING`, un `100` de la Marketing Messages API hace que Genuka reenvíe el
mensaje por el endpoint normal `/messages`; si este también lo rechaza, el destinatario pasa a
`failed`.

### ¿Y el subcódigo 33?

No es un error de contenido. Con `meta.code: 100` y `meta.subcode: 33`, y un mensaje que empieza por
"Unsupported post request" (o "get" para una lectura), Graph indica que el objeto de destino no
existe o que el token no tiene acceso a él. Las causas reportadas son un ID de número de teléfono o
de cuenta de WhatsApp incorrecto, un token que perdió el acceso a ese activo o un acceso de socio
que fue retirado ([Fast2SMS](https://www.fast2sms.com/help/?p=17132)). Con Genuka WA, consulta
`GET /api/v1/connections`: un número cuyo estado ya no es `connected` corresponde a la página del
[error 200](https://wa.genuka.com/es/docs/errors/200); un número eliminado del lado de Meta, a la página del
[error 33](https://wa.genuka.com/es/docs/errors/33).

## ¿Cómo corrijo el error 100?

1. **Lee `meta.details`.** Es la única parte de la respuesta que nombra el problema. Regístralo junto
   con `meta.traceId` y el encabezado `x-request-id`.
2. **Compara la solicitud con la referencia.** Para los envíos, la
   [referencia de la API](https://wa.genuka.com/es/docs/api#mensajes) y [Enviar mensajes](https://wa.genuka.com/es/docs/messages) enumeran cada
   campo aceptado y sus límites: 4.096 caracteres para un texto, 1.024 para el pie de una imagen, 20
   para el título de un botón, como máximo 3 botones de respuesta.
3. **Quita lo que agregaste "por si acaso".** Un campo de la Cloud API copiado en `raw` pero
   desconocido para el endpoint basta para provocar un `100`.
4. **Si `details` está vacío, reduce la solicitud.** Envía el mismo mensaje simplificado (un `text`
   simple al mismo número) y luego vuelve a agregar los elementos uno por uno. Si un mensaje mínimo
   también falla, comprueba que `to` no sea el número que envía y contacta al soporte de Genuka con
   `x-request-id` y `meta.traceId`.

**Node.js**

```ts
const response = await fetch("https://wa.genuka.com/api/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ connectionId: "con_1", to: "+237690000001", text: "Tu paquete está en camino." }),
});
const json = await response.json();

if (!response.ok) {
  // Todo lo necesario para diagnosticar, sin volver a enviar la solicitud.
  console.error({
    status: response.status,
    error: json.error,
    metaCode: json.meta?.code,
    details: json.meta?.details ?? json.message,
    traceId: json.meta?.traceId,
    requestId: response.headers.get("x-request-id"),
  });
}
```

**Python**

```python
import os
import requests

response = requests.post(
    "https://wa.genuka.com/api/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}"},
    json={"connectionId": "con_1", "to": "+237690000001", "text": "Tu paquete está en camino."},
    timeout=30,
)
if not response.ok:
    body = response.json()
    meta = body.get("meta") or {}
    print({
        "status": response.status_code,
        "error": body.get("error"),
        "meta_code": meta.get("code"),
        "details": meta.get("details") or body.get("message"),
        "trace_id": meta.get("traceId"),
        "request_id": response.headers.get("x-request-id"),
    })
```

**PHP**

```php
<?php
$ch = curl_init("https://wa.genuka.com/api/v1/messages");
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",
        "to" => "+237690000001",
        "text" => "Tu paquete está en camino.",
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($status >= 400) {
    error_log(json_encode([
        "status" => $status,
        "error" => $body["error"] ?? null,
        "meta_code" => $body["meta"]["code"] ?? null,
        "details" => $body["meta"]["details"] ?? ($body["message"] ?? null),
        "trace_id" => $body["meta"]["traceId"] ?? null,
    ]));
}
```

**curl**

```bash
curl -s -X POST https://wa.genuka.com/api/v1/messages \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "connectionId": "con_1", "to": "+237690000001", "text": "Tu paquete está en camino." }' \
  | jq '{error, code: .meta.code, details: .meta.details, traceId: .meta.traceId}'
```

## ¿Cómo evito el error 100?

* **Mantén activada la validación de Genuka.** En `POST /api/v1/templates`, solo pasa
  `"validate": false` para un componente que Meta acepta y nuestro validador rechaza.
* **Prefiere los campos tipados a `raw`.** Los campos tipados se revisan en su forma antes del envío
  (campos obligatorios, multimedia sin `id` ni enlace); los límites de longitud y de cantidad los
  sigue aplicando Meta, y `raw` no se revisa en absoluto.
* **Prueba cada nuevo tipo de mensaje en un número de prueba** antes de conectarlo a un envío
  masivo: un `100` es el mismo para todos los destinatarios.

## Códigos de error relacionados

* `131008`: falta un parámetro obligatorio.
* `131009`: el parámetro existe, pero su valor no es válido.
* `131021`: el remitente y el destinatario son el mismo número.
* [132000](https://wa.genuka.com/es/docs/errors/132000): la cantidad de variables enviadas no coincide con la plantilla.
* [33](https://wa.genuka.com/es/docs/errors/33): número eliminado (código 33), que no debe confundirse con el subcódigo
  33 del código 100, que señala un objeto que no se encuentra o al que no se puede acceder (número
  eliminado o acceso perdido).
* [200](https://wa.genuka.com/es/docs/errors/200): se retiró el acceso a la cuenta de WhatsApp, o falta un permiso.

## Preguntas frecuentes

### ¿Por qué `details` a veces está vacío?

Meta no siempre lo completa. Enviar desde un número a sí mismo, por ejemplo, vuelve como
`(#100) Invalid parameter` sin nada más, y por eso Genuka WA lo comprueba antes.

### ¿Debo reintentar una solicitud rechazada con 100?

No. El problema es el contenido, o el ID de destino con el subcódigo 33: la misma solicitud
producirá el mismo error. Corrígela primero.

### ¿Qué diferencia hay entre el error 100 y el error 131009?

Meta describe el 100 como un parámetro no admitido o mal escrito, y el 131009 como un parámetro
conocido cuyo valor no es válido. Ambos se corrigen leyendo `details`.

### Genuka WA aceptó mi solicitud, ¿por qué Meta la rechaza?

Genuka revisa la forma de la solicitud; Meta revisa además lo que solo ella conoce, como los
parámetros propios de cada endpoint o el estado de la cuenta. El `traceId` que se transmite en
`meta` es lo que pide el soporte de Meta.

## Fuentes

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Error codes, Marketing Messages API for WhatsApp](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#marketing-messages-api-for-whatsapp-error-codes)
* [Activepieces community — code 100, error\_subcode 33](https://community.activepieces.com/t/whatsapp-business-error/4324)
* [Fast2SMS — Unsupported POST/GET request, object does not exist](https://www.fast2sms.com/help/?p=17132)
