"A tu app le faltan permisos de Graph API para vincular el número asociado a Cloud API"
Este mensaje significa que la plataforma que inició el registro no tiene los permisos de WhatsApp que Meta exige, con el nivel de acceso requerido, para conectar un número de una app de WhatsApp Business a Cloud API. Meta solo permite que una empresa conceda permisos para los que la plataforma tiene acceso avanzado. La empresa no puede corregirlo; debe hacerlo la plataforma.
Qué necesita un partner para cada permiso antes de que sus clientes puedan concederlo mediante Embedded Signup.
Las llamadas a la API devuelven este error cuando se usa whatsapp_business_management sin acceso avanzado en cuentas que la app no posee.
whatsapp_business_management y whatsapp_business_messaging, los dos permisos que Meta indica que generalmente necesitan las integraciones de WhatsApp.
Meta exige que la plataforma ya sea Solution Partner o Tech Provider para incorporar usuarios de apps de WhatsApp Business.
¿Qué significa el mensaje?
El texto completo dice: "Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again." Las referencias públicas de errores de Meta no incluyen esta redacción exacta, pero cada parte corresponde a algo que Meta sí documenta.
"Your app" es la app de Meta de la plataforma que ejecuta el registro, no la app de WhatsApp Business del teléfono. Meta no define públicamente el vínculo de un número asociado; por el contexto, describe la incorporación de Cloud API a un número que sigue registrado en la app de WhatsApp Business, que es el esquema de Coexistencia. Y los permisos "advanced" de WhatsApp Business se refieren al acceso avanzado, el nivel que Meta concede mediante la revisión de la app.
¿Qué permisos están involucrados?
La documentación de permisos de Meta menciona dos que generalmente necesitan las integraciones de WhatsApp. whatsapp_business_management cubre los metadatos de la cuenta, las plantillas, los números de teléfono, los análisis y los webhooks de la cuenta. whatsapp_business_messaging cubre el envío de mensajes y la recepción de webhooks de mensajes y estados.
Para un partner cuyos clientes usan su app, Meta exige la revisión de la app y acceso avanzado para cada permiso que necesite la app. Meta explica directamente la consecuencia: sin acceso avanzado para un permiso, los clientes no pueden concederlo a la app mediante Embedded Signup. Las llamadas realizadas con whatsapp_business_management en cuentas que la app no posee, sin acceso avanzado, devuelven el error 200.
Una plataforma puede comprobar qué concedió realmente una empresa inspeccionando el token con el endpoint debug_token de Meta, que muestra los permisos concedidos en scopes.
¿Qué puede hacer la empresa?
Muy poco por su cuenta, y no debería intentar cambiar su configuración de Meta para solucionar esto. La solución corresponde a la plataforma: debe ser Tech Provider o Solution Partner, algo que Meta exige para incorporar usuarios de apps de WhatsApp Business, y debe tener aprobado el acceso avanzado para los permisos de WhatsApp.
La empresa puede comunicar el mensaje exacto a la plataforma y reintentar cuando esta confirme su acceso, o usar una plataforma que ya tenga ese estado. Reintentar el mismo flujo en la misma plataforma antes de eso produce el mismo resultado y no afecta a la app de WhatsApp Business del teléfono.
Errores comunes
- Conceder más permisos en la configuración de Meta de la propia empresa. El acceso que falta pertenece a la app de la plataforma.
- Alojar una herramienta por cuenta propia en una app de desarrollador sin revisión de la app. Sin acceso avanzado, las empresas no pueden conceder los permisos necesarios.
- Reintentar repetidamente en la misma plataforma. El resultado solo cambia cuando cambia el acceso de esa plataforma.
EasyCoexistence es un Tech Provider independiente de Meta, con su propia app de Meta, y ejecuta Embedded Signup v4 para Coexistencia. Así, las empresas conectan su número mediante una plataforma que ya tiene el acceso exigido por Meta.
Preguntas frecuentes
¿Hay algún problema con mi app de WhatsApp Business?
No. El mensaje se refiere a la app de Meta de la plataforma, no a la app del teléfono, que sigue funcionando.
¿Puedo conceder el permiso personalmente?
Solo aparecen para que los concedas los permisos para los que la plataforma tiene acceso avanzado. Primero debe aprobarse ese acceso para la plataforma.
¿Cómo obtiene una plataforma el acceso avanzado?
Mediante la revisión de la app de Meta para cada permiso que necesite su app, como partner cuyos clientes usan la app.
¿La empresa necesita una revisión de la app?
No. Meta indica que un desarrollador que accede directamente solo a sus propios datos empresariales no necesita revisión de la app ni acceso avanzado.
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