Error 200 de WhatsApp: acceso denegado (200-299) — solución
Error 200 de la Cloud API de WhatsApp: token ausente, permiso revocado o un usuario del sistema sin acceso a la cuenta. Cómo diagnosticarlo y corregirlo.
El error 200 de WhatsApp, como todo el rango de 200 a 299, significa que a la llamada le faltan los derechos que necesita: ningún token, un permiso que nunca se otorgó o que se retiró después, o un usuario del sistema sin acceso a la cuenta de WhatsApp de destino. No tiene nada que ver con el estado HTTP 200. Se corrige restableciendo el acceso, no reintentando.
¿Qué significa el error 200?
Meta incluye dos entradas entre sus errores de autorización (Meta, códigos de error de la Cloud API):
| Código | details según Meta | Lo que recomienda Meta |
|---|---|---|
200 | "No access token was provided." La API responde entonces "Provide valid app ID", en algunos endpoints GET como whatsapp_business_profile; otros endpoints devuelven 190 o 104 en su lugar | "Ensure your request includes a valid access token." (Asegúrate de que tu solicitud incluya un token de acceso válido.) Meta señala que este caso es distinto del 190 |
200 a 299 | "Permission is either not granted or has been removed." | Verificar en el depurador de tokens de acceso que la app tiene los permisos que exige el endpoint |
La guía de tokens de Meta agrega el caso más común en producción: la mayoría de los endpoints verifica que el usuario detrás del token tenga acceso al recurso solicitado y, si no, lo rechaza con el código de error 200, "not to be confused with HTTP status code 200" (que no debe confundirse con el código de estado HTTP 200) (Meta, Access tokens). Graph llama a este rango "API Permission" (Meta, Graph API, manejo de errores).
¿Cuándo ocurre el error 200?
- El usuario del sistema no está asignado a la cuenta. Un usuario del sistema "empleado" necesita acceso parcial o total a la cuenta de WhatsApp y a la cuenta de mensajería: el acceso solo a la segunda no basta (misma página).
- Al token le falta un permiso. Por ejemplo, anular el registro de un número sin
whatsapp_business_managementdevuelve 200 (Meta, Registration). - La solicitud no tiene ningún token, típicamente un
GETsobre el perfil de la empresa. - La empresa dejó de compartir su cuenta con el socio. Meta emite entonces un evento
PARTNER_REMOVED(Meta, account_update webhook), y el usuario del sistema del socio pierde el acceso a la cuenta.
¿Dónde lo ves en Genuka WA?
Con Genuka WA, el último caso es frecuente: tu cliente retiró el acceso de Genuka a su
cuenta de WhatsApp, en su Business Manager o, para un número en coexistencia, desde la app WhatsApp
Business (Meta, coexistence). Genuka recibe el
PARTNER_REMOVED, marca la conexión como disconnected y reenvía el evento account_update a
tus webhooks. La misma situación también puede llegar como código 100 con
subcódigo 33, "… cannot be loaded due to missing permissions", consulta el error 100.
Genuka no coloca los códigos 200 a 299 en una clase dedicada: la clase sigue el estado HTTP que devolvió Meta,
config en un 401 o 403, unknown en los demás casos. En ambos casos, el rechazo no se puede reintentar.
| Canal | Lo que recibes |
|---|---|
POST /api/v1/messages | 409 send_config o 400 send_unknown, con meta.code: 200 |
POST /api/v1/templates | 403 o 422, "error": "meta_rejected" |
GET /api/v1/connections | "status": "disconnected" en el número afectado |
Un número en coexistencia también puede pasar a offboarded: Meta reportó que ya no está vinculado a la
API, por ejemplo después de un cambio de dispositivo seguido de un nuevo registro
(Meta, coexistence). Genuka rechaza entonces los envíos por su cuenta, antes de llamar
a Meta: 409 send_config, con un mensaje que menciona la desvinculación ("was offboarded by the
merchant…") y sin meta.code. Un número que liberaste de tu plan se rechaza de la misma manera, como
409 number_released.
¿Cómo corrijo el error 200?
Si pasas por Genuka WA
Revisa el estado del número.
curl "https://wa.genuka.com/api/v1/connections?companyId=cmp_123" \
-H "Authorization: Bearer $GENUKA_WA_API_KEY"{ "data": [ { "id": "con_1", "companyId": "cmp_123", "displayPhoneNumber": "+237 6 90 …",
"qualityRating": "GREEN", "status": "disconnected" } ] }Si está en disconnected, averigua por qué antes de pedir una reconexión. El estado significa que Meta
reportó que la cuenta ya no se comparte con Genuka, o que fue eliminada, o que tú mismo liberaste el número.
Un cliente que retiró el acceso vuelve a pasar por el mismo enlace /connect/{your-slug}:
el acceso vuelve sobre el mismo registro, conservando mensajes, plantillas y estadísticas, y sin ocupar un espacio nuevo
de tu plan (Conectar un número). Un número liberado necesita de nuevo un espacio
libre. Una cuenta eliminada, o desactivada por Meta (error 368), no se
restablece volviendo a conectarse: el evento account_update reenviado a tus webhooks te indica qué
caso aplica. Si está en offboarded, sigue la guía de coexistencia.
Si sigue en connected, contacta al soporte de Genuka con el encabezado x-request-id
de la respuesta y meta.traceId. El estado refleja los últimos eventos recibidos de Meta: no
prueba que el acceso esté intacto.
Si llamas a la Cloud API con tu propio token
Asigna el usuario del sistema a ambas cuentas. En Meta Business Suite: configuración del portafolio, Accounts > WhatsApp accounts, elige la cuenta, pestaña Personas (en inglés, People), +Add people, y luego el usuario del sistema y su nivel de acceso. Repite en Accounts > Messaging accounts (Meta, Access tokens).
Revisa los permisos del token en el
depurador de tokens de acceso:
whatsapp_business_management y whatsapp_business_messaging, más business_management si
administras activos del portafolio.
No dependas de la cascada de la API. El acceso otorgado por API en la cuenta de mensajería también se aplica a la cuenta de WhatsApp vinculada, pero Meta califica este comportamiento como provisional, y Meta Business Suite no lo hace. Asigna ambas cuentas de forma explícita (misma página).
¿Cómo evito el error 200?
- Suscribe un endpoint a
account_update. UnPARTNER_REMOVEDte avisa en el momento en que un cliente retira el acceso, antes de que tus envíos empiecen a fallar. - Explica a tus clientes lo que implica retirar el acceso. Quitar a Genuka de su Business Manager corta la API en todos los números de esa cuenta de WhatsApp.
- Si administras tus propios tokens, Meta indica que un usuario del sistema administrador tiene acceso por defecto a todas las cuentas de WhatsApp que pertenecen a tu portafolio o se comparten con él; un usuario del sistema empleado debe asignarse cuenta por cuenta.
Códigos de error relacionados
- 190: el token venció o fue invalidado.
- 10: permiso no otorgado o retirado, incluidas las plantillas de OTP para una empresa no verificada.
- 3: falta una capacidad o un permiso para este endpoint.
- 0: Meta no pudo autenticar al usuario de la app.
Preguntas frecuentes
¿El error 200 tiene relación con el estado HTTP 200?
En absoluto. Es un código de error de Meta, devuelto en el campo code de una respuesta fallida. Meta lo
aclara en su propia documentación.
Mi cliente quitó a Genuka por error: ¿qué debe hacer?
Volver a pasar por tu enlace de conexión. El número vuelve sobre el mismo registro, con su historial, y sin ocupar un espacio adicional.
¿Por qué el error solo afecta a algunos de mis números?
Porque el acceso se otorga por cuenta de WhatsApp. Los números de un cliente que retiró el acceso fallan; los de tus demás clientes siguen funcionando.
¿Debo reintentar?
No. Mientras no se restablezca el acceso, cada nueva llamada producirá el mismo error.
Fuentes
Error 190 de WhatsApp: token de acceso vencido — causa y solución
Error 190 de la Cloud API de WhatsApp (token de acceso vencido): qué token venció, cómo reemplazarlo de forma definitiva y por qué los usuarios de Genuka WA nunca manejan tokens de Meta.
Error 4 de WhatsApp: límite de velocidad de la app alcanzado — solución
Error 4 de WhatsApp (API Too Many Calls): la app alcanzó su límite de velocidad de llamadas a la API de Meta. En qué se diferencia de 80007 y 130429, y cómo reintentar sin riesgo.