# Error 33 de WhatsApp: número de teléfono eliminado — causa y solución

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

> Error 33 de la Cloud API de WhatsApp: el número de WhatsApp Business de destino fue eliminado, o el ID ya no es el correcto. Cómo diagnosticarlo y volver a conectarlo.

El error 33 de WhatsApp significa, según Meta, que el número de teléfono de WhatsApp Business al que apunta la solicitud
fue eliminado. El ID de número de teléfono que usas ya no apunta a un número activo.
Revisa ese ID; si el número realmente se eliminó, hay que volver a conectarlo. Enviar de nuevo la misma
solicitud no cambiará nada.

## ¿Qué significa el error 33?

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

> "The business phone number has been deleted." — solución sugerida: "Verify that the business phone
> number is correct."
> — [Meta, códigos de error de la Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

Por lo tanto, la solución de Meta cubre dos causas: un número que realmente se eliminó, o un ID que no es el
correcto.

### ¿Eliminado, con el registro anulado o en proceso de eliminación?

Tres estados parecidos producen tres códigos distintos:

| Estado del número                                                | Código devuelto                                                           | Qué hacer                                                 |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------- |
| Eliminado de la cuenta de WhatsApp                               | **33**                                                                    | Revisa el ID y luego agrega y vuelve a conectar el número |
| Con el registro anulado en la Cloud API, pero todavía presente   | `133010`: "Phone number not registered on the WhatsApp Business Platform" | Vuelve a registrarlo                                      |
| Eliminado hace unos minutos y en proceso de volver a registrarse | `133015`: la eliminación no ha terminado                                  | Espera 5 minutos antes de reintentar                      |

Los textos provienen de la misma página de Meta. Meta también indica que anular el registro de un número no
lo elimina ni borra su historial de mensajes
([Meta, Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)).

## ¿Error 33 o subcódigo 33?

Primero revisa qué campo lleva el 33. Graph también puede responder con el código `100` y
`error_subcode: 33`, una respuesta que no dice nada sobre un número eliminado:

```json title="Código 100, subcódigo 33"
{
  "error": {
    "message": "Unsupported post request. Object with ID '123456789012345' does not exist, cannot be loaded due to missing permissions, or does not support this operation.",
    "type": "GraphMethodException",
    "code": 100,
    "error_subcode": 33
  }
}
```

Esta respuesta se reportó en el
[foro de Activepieces](https://community.activepieces.com/t/whatsapp-business-error/4324). Indica que el objeto de destino
no existe, o que el token no tiene acceso a él. Las causas reportadas son un ID incorrecto, un token que
perdió el acceso a ese activo, o un acceso de socio que se retiró
([Fast2SMS](https://www.fast2sms.com/help/?p=17132)). Un número eliminado puede producirla, y también
un acceso retirado: no concluyas que el número se eliminó antes de revisar el acceso; consulta el
[error 100](https://wa.genuka.com/es/docs/errors/100) y el [error 200](https://wa.genuka.com/es/docs/errors/200).

## ¿Cuándo ocurre el error 33?

* **El número se eliminó en el Administrador de WhatsApp** (en inglés, *WhatsApp Manager*) por alguien de la empresa, mientras una integración
  todavía lo usaba.
* **El ID es incorrecto o está desactualizado**: copiado de otra cuenta, conservado en una configuración después de un cambio
  de número, o confundido con el número de teléfono que se muestra.

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

Genuka WA guarda el ID del número al conectarlo; el `connectionId` que pasas apunta a él. Si
la empresa elimina más tarde el número en el Administrador de WhatsApp, las llamadas sobre esa conexión se rechazan:
con `meta.code: 33`, o con `meta.code: 100` y `meta.subcode: 33`, la respuesta descrita arriba.

Genuka no coloca el 33 en una clase dedicada: la clase sigue el estado HTTP que devolvió Meta,
normalmente `unknown`, y no se puede reintentar.

| Canal                              | Lo que recibes                                                                       |
| ---------------------------------- | ------------------------------------------------------------------------------------ |
| `POST /api/v1/messages`            | `400 send_unknown` (o `409 send_config` si Meta responde 401 o 403), `meta.code: 33` |
| `GET /api/v1/numbers/{id}/health`  | `422 meta_error` (o `403` si Meta responde 401 o 403), con el mismo objeto `meta`    |
| `GET /api/v1/numbers?refresh=true` | El número vuelve con `"refreshed": false` y un `refreshError`                        |
| Campaña                            | Cada destinatario pasa a `failed`, con el mensaje de Meta                            |

## ¿Cómo corrijo el error 33?

### Si pasas por Genuka WA

1. **Confirma que el número ya no responde.** `GET /api/v1/numbers/{id}/health` consulta a Meta para ese
   número en particular: un rechazo `meta_error` cuyo `meta.code` o `meta.subcode` sea 33 lo confirma en una sola
   llamada. Lee también su estado en `GET /api/v1/connections`: si ya no está en `connected`, es posible que se haya
   retirado el acceso en lugar de eliminarse el número; consulta el [error 200](https://wa.genuka.com/es/docs/errors/200).

2. **Haz que revisen el número en el Administrador de WhatsApp**, pestaña **Números de teléfono** (en inglés, *Phone numbers*), alguien con acceso a
   la cuenta de WhatsApp de la empresa. Si sigue en la lista, el ID guardado ya no es el correcto: contacta al
   soporte de Genuka con `x-request-id` y `meta.traceId`.

3. **Si se eliminó, vuelve a conectarlo.** La empresa vuelve a pasar por el
   [enlace de conexión](https://wa.genuka.com/es/docs/onboarding), que agrega el número mediante el Embedded Signup de Meta y
   lo registra en la Cloud API. Luego vuelve a leer `GET /api/v1/connections` y usa el `connectionId`
   que aparece allí para este número, en lugar del que tenías guardado.

   Si Meta le dio al número un identificador nuevo, volver a conectarlo crea una conexión nueva, que necesita un espacio
   libre en tu plan. Si todos los espacios están ocupados, primero libera el anterior desde la página del cliente en el
   panel (**Liberar el cupo**): ya no envía, pero sigue ocupando un espacio, y la
   reconexión se rechazaría con `plan_limit_numbers`.

Si Meta le dio al número un identificador nuevo, los mensajes, las plantillas y las estadísticas que Genuka WA ya
registró siguen vinculados a la conexión anterior.

### Si llamas directamente a la Cloud API

Lista los números de la cuenta con `GET /{WABA_ID}/phone_numbers` y compara su `id` con el que
usas. Si el número desapareció, vuelve a agregarlo en el Administrador de WhatsApp, verifícalo y luego regístralo con
`POST /{PHONE_NUMBER_ID}/register`
([Meta, Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)).
Justo después de una eliminación, espera unos minutos: Meta responde `133015` hasta que haya terminado.

## ¿Cómo evito el error 33?

* **Detén los envíos antes de eliminar un número.** Avisa a las personas que gestionan el Administrador de WhatsApp: eliminar un
  número detiene de inmediato todas las integraciones que lo usan.
* **Haz referencia a la conexión, no al número de teléfono.** Guarda el `connectionId` de Genuka WA, o el ID de
  número de teléfono de Meta, en lugar del número que se muestra, que no es un identificador de la API.
* **Revisa el estado antes de una campaña grande.** Un `GET /api/v1/numbers/{id}/health` falla de inmediato con
  un número eliminado, en lugar de dejar que cada destinatario falle uno por uno.

## Códigos de error relacionados

* `133010`: el número existe, pero no está registrado en la Cloud API.
* `133015`: el número se acaba de eliminar y la eliminación no ha terminado.
* [100](https://wa.genuka.com/es/docs/errors/100): un parámetro desconocido o mal escrito; con el subcódigo 33, un objeto que
  no se encuentra o al que no se puede acceder.
* [200](https://wa.genuka.com/es/docs/errors/200): la cuenta ya no es accesible, por ejemplo después de que se retiró el
  acceso.

## Preguntas frecuentes

### ¿Cuál es la diferencia entre anular el registro de un número y eliminarlo?

Anular el registro hace que el número no se pueda usar con la Cloud API hasta que se vuelva a registrar, sin
eliminarlo ni borrar su historial. Eliminarlo lo quita de la cuenta de WhatsApp: ese es el caso que
produce el error 33.

### ¿Debo reintentar un envío rechazado con el error 33?

No. Mientras el número no se vuelva a conectar, cada envío sobre esa conexión fallará de la misma manera.

### ¿Se pierde mi historial de mensajes?

No del lado de Genuka WA: lo que se registró sigue vinculado a la conexión anterior. Del lado de Meta,
sí: eliminar un número también borra su historial, mientras que anular su registro lo conserva
([Meta, Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)).

## Fuentes

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Register a business phone number](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)
* [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)
