Solución de problemas paso a paso para el registro de la API de WhatsApp Business — cambio de BSPs, eliminación de números, creación de nuevas WABAs y registro.
Configurar WhatsApp Business API a través de WhatsTeam debería ser un proceso sencillo, pero ciertas situaciones pueden causar complicaciones durante el registro. Ya sea que tu número esté conectado a otro Proveedor de Soluciones de Negocio (BSP), registrado en una cuenta personal de WhatsApp o vinculado a un portafolio de Meta diferente, cada escenario requiere una ruta de resolución específica.
Esta guía completa te acompaña a través de los problemas más comunes encontrados durante el registro de WhatsApp y proporciona instrucciones claras paso a paso para resolverlos, para que puedas poner tu negocio en funcionamiento en WhatsTeam lo más rápido posible.
Antes de iniciar el proceso de registro de WhatsApp en WhatsTeam, asegúrate de tener los siguientes elementos listos. Completar esta lista de verificación de antemano te ahorrará tiempo y prevendrá los bloqueos más comunes.
Consejo: Tener todos estos elementos preparados antes de comenzar reducirá drásticamente la probabilidad de encontrar errores durante el proceso de registro.
Uno de los problemas más frecuentes ocurre cuando tu número de teléfono ya está registrado con otro Proveedor de Soluciones de Negocio (BSP) de WhatsApp. WhatsApp aplica una política estricta de un proveedor por número, lo que significa que un solo número de teléfono solo puede estar activo en un BSP a la vez.
Normalmente verás uno de los siguientes mensajes de error durante el registro:
Esta situación surge cuando:
La resolución depende de tu configuración actual. Tienes dos rutas principales:
Ambas rutas se describen en detalle en las siguientes secciones.
Si tu número actualmente está gestionado por otro BSP y quieres moverlo a WhatsTeam, necesitas realizar una migración formal. Este proceso implica coordinación entre tu proveedor actual, Meta y WhatsTeam.
| Factor | Migración (Misma WABA) | Inicio Nuevo (Nueva WABA) |
|---|---|---|
| Plantillas | Preservadas | Deben recrearse |
| Límite de mensajería | Preservado | Comienza en 1K/día |
| Calificación de calidad | Preservada | Comienza desde cero |
| Nombre para mostrar | Preservado | Debe re-aprobarse |
| Tiempo de inactividad | Minutos | Minutos a horas |
Recomendación: Siempre que sea posible, migra usando la misma WABA para preservar tus límites de mensajería y aprobaciones de plantillas. Esto es especialmente importante para negocios con altos volúmenes diarios de mensajes.
Antes de poder registrar tu número en WhatsTeam, debes eliminarlo de su cuenta de WhatsApp actual. El proceso difiere dependiendo de si tu número está en Cloud API o planeas usar el modo de Coexistencia.
La ruta Cloud API implica eliminar completamente el número de su registro actual de WhatsApp para que pueda ser registrado de nuevo en WhatsTeam.
Advertencia: Eliminar un número de teléfono de una WABA es permanente. Todo el historial de mensajes, conversaciones activas y mensajes pendientes asociados con ese número se perderán. Asegúrate de haber exportado cualquier dato necesario antes de proceder.
Si el número también se usaba en la aplicación móvil de WhatsApp o WhatsApp Business:
La ruta Coexistencia te permite seguir usando la aplicación móvil de WhatsApp Business en tu teléfono mientras conectas simultáneamente el mismo número a WhatsTeam a través de Cloud API. Esto es ideal para negocios que quieren mantener su presencia existente en WhatsApp mientras obtienen capacidades de API.
La Coexistencia solo funciona con la aplicación WhatsApp Business (icono verde con una "B"), no con la aplicación estándar de WhatsApp para consumidores. Si estás usando la aplicación regular de WhatsApp, primero debes migrar a la aplicación WhatsApp Business.
Antes de conectar a través de Coexistencia, desactiva todas las funciones de respuesta automática en tu aplicación WhatsApp Business:
A diferencia de la ruta Cloud API, no debes eliminar el número de la aplicación móvil. El número permanece activo en la aplicación mientras lo conectas a WhatsTeam a través del proceso de Embedded Signup.
Con la aplicación móvil aún activa, procede al proceso de registro en WhatsTeam. Durante el Embedded Signup, selecciona la opción de Coexistencia cuando se te indique. Los pasos detallados para este proceso se cubren en nuestra guía dedicada de Coexistencia.
Si estás comenzando desde cero o tu cuenta anterior no se puede recuperar, necesitarás crear una nueva WhatsApp Business Account. Hay dos métodos principales para hacer esto a través de WhatsTeam.
El flujo de Embedded Signup (ES) es el método más rápido y recomendado. Crea tu Meta Business Account y WhatsApp Business Account en un solo proceso simplificado directamente dentro de la plataforma WhatsTeam.
Si prefieres crear tu WhatsApp Business Account directamente a través de Meta antes de conectar a WhatsTeam, puedes hacerlo a través de Meta Business Suite.
Al usar el modo de Coexistencia, puede que necesites vincular tu WhatsApp Business Account a un Portafolio de Meta Business específico. Este paso asegura que la WABA esté correctamente asociada con tu identidad de negocio y que la facturación, permisos y cumplimiento estén configurados correctamente.
Después de vincular, verifica que:
En algunos casos, puede que necesites registrar un número de teléfono que fue previamente usado en una cuenta de WhatsApp diferente. Este proceso requiere una ejecución cuidadosa para evitar errores.
Antes de intentar re-registrar un número:
Ve a Meta Business Suite y verifica que el número no aparezca bajo ninguna WhatsApp Business Account. Si aún aparece, completa el proceso de eliminación descrito anteriormente en esta guía.
El proceso de liberación generalmente es instantáneo una vez que eliminas el número de la WABA anterior. Sin embargo, en algunos casos, los sistemas de Meta pueden tomar hasta 24 horas para propagar completamente el cambio. Si aún encuentras problemas después de 24 horas, contacta al soporte de WhatsTeam en support@whats.team.
Sí, esto es exactamente lo que habilita el modo de Coexistencia. Puedes seguir usando la aplicación móvil de WhatsApp Business mientras también envías y recibes mensajes a través de la API de WhatsTeam. Sin embargo, hay algunas limitaciones de funcionalidades en el modo de Coexistencia. Consulta nuestra guía dedicada de Coexistencia para detalles completos.
Si mantienes la misma WABA, tus plantillas aprobadas se preservarán. Si creas una nueva WABA, necesitarás enviar todas las plantillas para aprobación nuevamente, lo cual puede tomar hasta 24 horas por plantilla.
Si eliminas un número de una WABA y lo registras bajo una nueva WABA, tu límite de mensajería se restablece al nivel predeterminado (normalmente 1.000 conversaciones iniciadas por el negocio por 24 horas). Para preservar tu nivel de mensajería, migra el número dentro de la misma WABA siempre que sea posible.
Este error generalmente indica un problema temporal con el servicio de verificación de Meta. Intenta lo siguiente:
Sí, un breve estado de "Pendiente" es normal mientras Meta procesa el registro. Esto normalmente se resuelve en 5-15 minutos. Si el estado permanece como "Pendiente" por más de una hora, intenta actualizar tu conexión en el panel de WhatsTeam o contacta a soporte.
Guía completa de precios de WhatsApp API en India. Tarifas en INR para marketing, utilidad y autenticación con ejemplos reales.
Tarifas de WhatsApp Business API para España, Argentina, México y Brasil. Costos por mensaje, ejemplos reales y cómo optimizar tu gasto.
Herramientas
Recursos
Compara los precios de WhatsApp API y SMS cara a cara. Tasas de apertura, tasas de respuesta, costo por conversión y cuándo usar cada canal.
