Migrar WhatsApp Business a la API: guía paso a paso
Conserva tu número e historial al migrar de WhatsApp Business a la API. Pasos reales: Business Manager, 2FA, nombre para mostrar y tiempos esperados.
Ya decidiste dar el salto a la API de WhatsApp Business. Bien. Ahora viene la parte que nadie explica con claridad: el trámite real, el orden correcto de los pasos y qué pasa con tu número y tu historial en el proceso.
Este artículo no explica qué es la API ni cuándo conviene usarla — para eso está nuestra guía sin tecnicismos. Aquí asumimos que ya decidiste migrar y necesitas saber el cómo, el cuánto tarda y dónde se traban la mayoría de las empresas.
Lo que sí se conserva (y lo que no)
Antes de arrancar, conviene tener expectativas claras.
Sí se conserva:
- Tu número de teléfono (es el activo más importante).
- El nombre de tu cuenta, aunque deberás aprobarlo de nuevo.
- Tu reputación de número ante Meta (historial de calidad).
No se conserva:
- El historial de chats de la app. Una vez que el número migra a la API, los mensajes anteriores quedan solo en el dispositivo donde usabas WhatsApp Business app — no se transfieren al proveedor de API.
- Los contactos guardados dentro de la app (etiquetas, listas de difusión anteriores).
- Las respuestas rápidas y catálogos configurados en la app. Tendrás que recrearlos en la plataforma API que elijas.
El historial de chats es el punto que más sorprende. No hay forma oficial de exportarlo y que quede disponible en la API: puedes hacer una exportación en texto plano desde la app (Configuración → Chats → Exportar chat) como respaldo, pero es un archivo .txt o .zip, no una base de datos consultable.
Los cinco pasos de la migración, en orden
1. Crea o vincula tu cuenta de Meta Business Manager
Todo pasa por Meta Business Manager. Si ya tienes una cuenta para gestionar tus anuncios de Facebook/Instagram, úsala. Si no, crea una nueva.
Lo que necesitas antes de continuar:
- Una página de Facebook asociada al negocio (puede ser nueva, no necesita seguidores).
- Un documento de identidad o comprobante fiscal del negocio para la verificación.
- Acceso de administrador a la cuenta de Business Manager.
Verificación del negocio: Meta puede pedirte que verifiques tu empresa subiendo documentos (registro mercantil, comprobante de domicilio fiscal, etc.). Este paso puede tomar entre 1 y 5 días hábiles según el país y el volumen de solicitudes. En México y Colombia el proceso suele ser más ágil que en países con menos volumen de verificaciones; en casos complejos hemos visto hasta 10 días hábiles.
2. Activa la autenticación en dos pasos (2FA) en tu número actual
Antes de portar el número a la API, debes desactivar 2FA en WhatsApp Business app y luego activarlo en la plataforma API. El orden importa.
Pasos concretos:
- Abre WhatsApp Business app → Configuración → Cuenta → Verificación en dos pasos → Desactivar.
- Espera al menos 7 días si activaste el 2FA hace poco (Meta tiene un período de seguridad).
- Cuando registres el número en tu plataforma API, el sistema te pedirá un código OTP enviado al número. Tenlo accesible (SIM activa o número de VoIP con buzón de voz).
Si salteas la desactivación del 2FA en la app, el registro en la API fallará con un error de verificación y perderás tiempo.
3. Registra el número en la plataforma API (o con tu proveedor)
Aquí entra tu proveedor de soluciones de WhatsApp Business (BSP, por sus siglas en inglés). Si usas un Tech Provider verificado de Meta — como Lead Lab AI — el flujo suele ser más directo: conectas tu número desde el panel, recibes el OTP y listo.
Lo que ocurre en este paso:
- El número se desvincula de la WhatsApp Business app. Desde ese momento, la app deja de funcionar con ese número.
- El número queda registrado en la API bajo tu Business Manager.
- Puedes usar el número en la API en cuestión de minutos una vez que Meta lo aprueba.
Tiempo estimado de este paso: entre 10 minutos y 2 horas, dependiendo de si Meta tiene cola de procesamiento.
4. Configura tu nombre para mostrar (Display Name)
El nombre para mostrar es lo que ven tus contactos cuando les escribes. Meta lo revisa manualmente y puede rechazarlo.
Causas frecuentes de rechazo:
- El nombre es demasiado genérico ("Ventas", "Soporte", "Empresa").
- No coincide con el nombre legal o comercial registrado en Business Manager.
- Contiene signos de puntuación extraños o palabras que Meta considera ambiguas.
- Parece una imitación de una marca conocida.
Qué hacer si te lo rechazan:
- Lee el motivo exacto en el correo de Meta (suelen darlo, aunque en inglés).
- Ajusta el nombre para que refleje claramente tu marca o razón social.
- Vuelve a solicitarlo desde Business Manager → Cuentas de WhatsApp → tu número → Editar perfil.
Cada intento de aprobación puede tomar entre 1 y 3 días hábiles. Si te rechazan dos veces con el mismo nombre, cambia el enfoque antes de reintentar.
5. Crea y aprueba tus primeras plantillas de mensaje
Para iniciar conversaciones con tus clientes (mensajes que salen de tu negocio, no respuestas), necesitas plantillas aprobadas por Meta. Sin al menos una plantilla activa, no puedes hacer envíos proactivos.
Desde el 1 de julio de 2025, Meta cobra por mensaje de plantilla enviado, no por conversación. Las categorías son:
- Marketing: promociones, ofertas, recordatorios de ventas.
- Utilidad (Utility): confirmaciones de pedido, actualizaciones de estado, alertas transaccionales.
- Autenticación: códigos OTP y verificación.
Cada categoría tiene su propio precio por país. Para tarifas actualizadas, consulta siempre la página oficial de precios de Meta. Los mensajes que inician tus clientes (servicio) siguen siendo gratuitos durante la ventana de atención de 24 horas.
Tabla resumen: tiempos y posibles bloqueos
| Paso | Tiempo estimado | Principal causa de retraso |
|---|---|---|
| Verificación de negocio en BM | 1–10 días hábiles | Documentos incompletos o ilegibles |
| Desactivación de 2FA en app | Inmediato (o hasta 7 días de espera) | Haber activado 2FA recientemente |
| Registro del número en la API | 10 min – 2 horas | Cola de procesamiento de Meta |
| Aprobación del Display Name | 1–3 días hábiles por intento | Nombre genérico o inconsistente con BM |
| Aprobación de plantillas | Minutos – 24 horas | Categoría incorrecta o contenido ambiguo |
Tiempo total realista: si tienes todo en orden desde el día uno, puedes estar operativo en 3–5 días hábiles. Si hay rechazo de documentos o del nombre para mostrar, planifica entre 1 y 3 semanas.
Errores que alargan el proceso (y cómo evitarlos)
No desactivar el 2FA antes de empezar. Es el error más común y el que más tiempo cuesta porque el período de espera de seguridad no se puede acelerar.
Usar un nombre para mostrar diferente al de tu Business Manager. Meta cruza los datos. Si tu empresa está registrada como "Distribuidora López S.A." en Business Manager y pides el nombre "DL Soluciones", espera rechazo.
Subir documentos de verificación en baja resolución. Los PDFs escaneados con teléfono suelen fallar. Usa documentos digitales cuando sea posible.
Migrar el número sin avisar a tu equipo. Desde el momento en que el número entra a la API, nadie puede responder desde la app. Si tu equipo sigue intentando usarla, los mensajes no llegarán. Coordina la fecha de corte con anticipación.
Pruébalo en tu negocio
Una vez que tu número está en la API, el siguiente paso es conectarlo a una plataforma que lo aproveche de verdad. En Lead Lab AI, como Tech Provider verificado de Meta, el proceso de conexión toma un clic desde el panel — y desde ahí puedes activar ValerIA o OlivIA para atender ventas y soporte en WhatsApp, voz y chat web con la misma inteligencia.
Crea tu cuenta en https://www.lead-lab.ai/signup o escríbenos a hola@lead-lab.ai si tienes dudas antes de migrar.
¿Listo para que la IA atienda por ti?
ValerIA vende y OlivIA da soporte — por WhatsApp, voz y chat web, conectadas a tus datos. Configúralo en minutos.