Genuka WA docs

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

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

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úmeroCódigo devueltoQué hacer
Eliminado de la cuenta de WhatsApp33Revisa el ID y luego agrega y vuelve a conectar el número
Con el registro anulado en la Cloud API, pero todavía presente133010: "Phone number not registered on the WhatsApp Business Platform"Vuelve a registrarlo
Eliminado hace unos minutos y en proceso de volver a registrarse133015: la eliminación no ha terminadoEspera 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).

¿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:

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. 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). 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 y el error 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.

CanalLo que recibes
POST /api/v1/messages400 send_unknown (o 409 send_config si Meta responde 401 o 403), meta.code: 33
GET /api/v1/numbers/{id}/health422 meta_error (o 403 si Meta responde 401 o 403), con el mismo objeto meta
GET /api/v1/numbers?refresh=trueEl número vuelve con "refreshed": false y un refreshError
CampañaCada destinatario pasa a failed, con el mensaje de Meta

¿Cómo corrijo el error 33?

Si pasas por Genuka WA

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.

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.

Si se eliminó, vuelve a conectarlo. La empresa vuelve a pasar por el enlace de conexión, 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). 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: 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: 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).

Fuentes

En esta página