Error 3 de WhatsApp: problema de capacidad o permisos
El código de error 3 indica que la app que llama al endpoint carece de una capacidad o permiso requerido por ese endpoint. La descripción de Meta es "Capability or permissions issue." La Graph API lo denomina API Method. La solución es revisar los permisos concedidos al token con el depurador de tokens de acceso y añadir el que necesite el endpoint.
El código de Meta para "Capability or permissions issue."
El nombre que la guía de gestión de errores de Graph API da al código 3.
whatsapp_business_management y whatsapp_business_messaging, los dos permisos que necesitan la mayoría de los endpoints de WhatsApp.
¿Qué significa el código de error 3 de WhatsApp?
Significa que la petición fue autenticada, pero la app no tiene autorización para hacer lo que solicitó.
Meta incluye el código 3 entre los errores de autorización de la referencia de Cloud API, con el texto descriptivo "Capability or permissions issue." La guía de gestión de errores de Graph API, que Cloud API hereda, llama al mismo código API Method e indica que la app debe tener la capacidad o los permisos necesarios para la llamada.
Por tanto, el token funciona. La identidad no es el problema, lo que diferencia este caso de los códigos 0 y 190. El problema es qué puede tocar el token.
¿Cómo compruebas qué permisos tiene un token?
Con el depurador de tokens de acceso o con el endpoint debug_token, que devuelve la misma información.
La respuesta enumera los permisos concedidos en su propiedad scopes. Compara esa lista con la página de referencia del endpoint que falló, ya que cada referencia indica los permisos necesarios.
En WhatsApp, dos permisos cubren casi todo. whatsapp_business_management se necesita para los metadatos de la cuenta, las plantillas, los listados de números de teléfono, las analíticas y los webhooks de la cuenta. whatsapp_business_messaging se necesita para enviar cualquier mensaje y recibir webhooks de mensajes y estados. Un token que solo tenga uno de ellos falla en las llamadas que necesitan el otro.
¿Por qué una app de un partner puede ver el error 3 cuando un desarrollador directo no?
Porque los partners que prestan servicio a otras empresas tienen un control adicional.
La guía de permisos de Meta indica que un partner cuyos clientes usan su app para acceder a sus datos debe superar App Review y tener acceso Advanced para cada permiso que necesite la app. Un desarrollador directo que solo trabaja con los datos de su propia empresa no necesita App Review ni acceso Advanced.
Por eso, el mismo código puede ejecutarse correctamente contra la cuenta del desarrollador y fallar contra la cuenta de un cliente. Cuando aparece este patrón, la cuestión no es qué permiso falta en el token, sino si la app ha sido aprobada para usar ese permiso en activos que no le pertenecen.
Errores comunes
- Generar un token nuevo con los mismos alcances. Un token nuevo con los mismos permisos falla en el mismo punto.
- Comprobar el nombre del permiso en la configuración de la app en vez de hacerlo en el token. Lo que cuenta es lo que se concedió al token.
- Probar solo contra tu propia cuenta. Las apps de partners necesitan acceso Advanced antes de que las cuentas de clientes acepten la llamada.
EasyCoexistence conecta cada número mediante el flujo Embedded Signup de Meta, de modo que la empresa concede los permisos durante la incorporación y después puede consultar el estado de la conexión desde el panel.
Preguntas frecuentes
¿El error 3 es un problema con mi número de teléfono?
No. Se refiere a lo que el token de la app tiene permitido hacer. El número no se comprueba antes de rechazar la petición.
¿Cuál es la diferencia entre el error 3 y el error 10?
El código 3 indica un problema de capacidad o permisos. El código 10 indica que un permiso no se concedió o se eliminó. Ambos se resuelven comprobando los alcances del token.
¿Qué permiso necesito para enviar mensajes?
whatsapp_business_messaging. La guía de permisos de Meta indica que es necesario para enviar cualquier tipo de mensaje.
¿Reintentar ayudará?
No. Los permisos del token no cambian entre intentos, por lo que el resultado es el mismo.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el