Cuando una empresa empieza a crecer en WhatsApp Business Platform, es común terminar administrando más de un número, más de una app de Meta for Developers, o incluso más de una marca dentro del mismo Business Portfolio. Esta guía resume la estructura que usamos en la práctica y las lecciones aprendidas al configurarla.
Los tres niveles que hay que distinguir
- Business Portfolio (Business Manager) — la organización dueña de todo: apps, WABAs, páginas, catálogos, usuarios y system users.
- App de Meta for Developers — el proyecto técnico donde vive el producto "WhatsApp Business Platform", con su App ID, sus credenciales y su configuración de Webhooks.
- WhatsApp Business Account (WABA) — la cuenta que agrupa uno o varios números de teléfono y su estado de verificación/restricción ante Meta. Un Business Portfolio puede ser dueño de varias WABAs, y cada WABA puede (aunque no siempre conviene) vincularse a una app distinta.
Un error común es pensar que "una app = un número". En realidad la relación real es Portfolio → WABA(s) → número(s), y la app es solo el canal técnico (API, webhook, tokens) por el que esa WABA se opera.
Por qué separar WABAs por marca o producto
Si dentro de un mismo portfolio manejas marcas o productos distintos, conviene:
- Crear una WABA independiente por marca en lugar de reutilizar la WABA existente. Esto aísla el historial de calidad, las plantillas de mensajes y, sobre todo, el estado de restricción: una WABA puede quedar restringida (por ejemplo, mientras se revisa la verificación de negocio) sin afectar a las demás WABAs del mismo portfolio.
- Crear una app separada en Meta for Developers por marca, cada una con su propio webhook y sus propios tokens. Esto facilita rotar o revocar credenciales de una marca sin tocar las demás.
Restricción a nivel WABA vs. a nivel Portfolio
- Una restricción a nivel WABA (ej. cuenta "Unverified" pero "Approved") no impide operar esa WABA ni crear otras nuevas en el mismo portfolio.
- Una restricción a nivel Portfolio ("Account Restricted" al intentar crear cualquier WABA nueva) sí bloquea la creación de nuevas cuentas hasta que se resuelva — típicamente iniciando y completando la verificación de negocio (Business Verification) del portfolio en el Security Center.
Diagnosticar cuál de los dos casos aplica es clave antes de intentar workarounds: si el bloqueo es de portfolio, no hay atajo posible y hay que esperar la revisión (normalmente un par de días hábiles).
System Users: separar credenciales por app/marca
Para generar tokens de acceso permanentes (no los temporales de 24h), la práctica recomendada es usar System Users dedicados en Meta Business Suite:
- Un System User por marca/app, no uno compartido.
- Cada System User debe tener solo los activos que necesita, con el nivel de acceso mínimo necesario.
- Meta limita a 1 System User con rol "Admin" por Business Portfolio. Los siguientes deben crearse con rol "Employee".
- Al generar el token permanente, elige expiración "Never" y guárdalo de inmediato: la UI lo enmascara después.
- Revisa periódicamente los "Assigned assets" de cada System User para limpiar accesos asignados por error.
Webhooks: dos lugares distintos donde se configuran
- Dentro del producto "WhatsApp" → Configuration: el webhook del flujo guiado de WhatsApp Business Platform.
- Products → Webhooks (a nivel de app): configuración por tipo de objeto (User, Page, Whatsapp Business Account, etc.), cada uno con su propia Callback URL. El objeto relevante para mensajería es Whatsapp Business Account — confirmar ahí que el campo
messagesesté "Subscribed".
Resumen práctico
| Nivel | Qué aísla |
|---|---|
| Business Portfolio | Nada — es el contenedor |
| App (Meta for Developers) | Webhook, tokens, App Review |
| WABA | Números, calidad, estado de restricción, verificación |
| System User | Credenciales/tokens de una app+WABA |
Separar por marca en cada uno de estos niveles cuesta un poco más de configuración inicial, pero evita que un problema de una marca se propague a las demás.