Migrar a la API Oficial de WhatsApp sin Perder el Historial

Quien decide migrar a la API oficial de WhatsApp casi siempre se encuentra con la misma pregunta: ¿qué ocurre con las conversaciones que tienes actualmente en el móvil? Desde que Meta ha habilitado el modo de coexistencia, es posible realizar el cambio sin borrar nada. Pero existen tres caminos, y solo uno de ellos conserva el historial. Esta guía te muestra cuál elegir, el paso a paso, cuánto cuesta y cuándo es mejor esperar.

TL;DR

Existen tres rutas: coexistencia (mismo número en la app y en la API), migración total del número (elimina la cuenta de la app) y número nuevo. Solo la coexistencia trae el historial a la API.

En la coexistencia, Meta sincroniza las conversaciones individuales de los últimos 180 días. El contenido multimedia, solo el de los últimos 14 días. Los grupos no se transfieren.

En la migración total, la documentación de Meta es directa: el historial de mensajes se pierde. Haz una copia de seguridad antes.

Desde el 1 de octubre de 2026, las respuestas dentro de la ventana de 24 horas pasaron a cobrarse después de 1.000 mensajes gratuitos por número al mes. Esto debe tenerse en cuenta en el coste de la migración.

Con Voyia, la plataforma de API oficial de Agathas Web, conectas el número actual, mantienes el móvil funcionando y pagas los mensajes de Meta sin recargos.

¿Por qué migrar a la API oficial de WhatsApp ahora (y no después)?

La app de WhatsApp Business fue diseñada para una persona atendiendo desde un móvil. Cuando la empresa necesita tres agentes en el mismo número, un chatbot fuera del horario o informes de conversaciones sin respuesta, la app se convierte en un cuello de botella.

El atajo común es la API no oficial, que "replica" WhatsApp Web. Funciona hasta que el número es bloqueado, y en 2026 la ola de bloqueos se hizo difícil de ignorar. Detallamos el escenario en el texto sobre el bloqueo de WhatsApp Business en 2026 en Brasil.

Tres hechos cambiaron el panorama en 2026:

La coexistencia terminó con el "o uno o el otro". Antes, entrar en la API exigía renunciar a la app y al historial. Hoy el mismo número funciona en ambos.
La facturación en euros llegó. Desde el 1 de julio de 2026, las cuentas de WhatsApp Business (WABA) de clientes en España pueden facturarse en EUR. Las elegibles deben migrar a EUR antes del 30 de junio de 2027.
El precio volvió a cambiar en octubre. Los mensajes de servicio dejaron de ser 100% gratuitos.

En 18 años de Agathas Web, migrando servidores, entornos virtuales de aprendizaje Moodle y sitios de alojamiento gestionado, aprendí que una migración planificada cuesta poco y una migración a toda prisa, después de un bloqueo, cuesta caro. Decidir migrar a la API oficial de WhatsApp mientras el número aún está sano es lo que permite elegir la ruta que conserva el historial.

Las 3 rutas para salir de la app y qué hace cada una con el historial

Quien vaya a migrar a la API oficial de WhatsApp necesita elegir la ruta antes de cualquier paso técnico.

Ruta 1: coexistencia (el número permanece en la app y en la API)

Conectas el número que ya usas en la app de WhatsApp Business a la Cloud API, a través del flujo oficial de registro de Meta (el Embedded Signup), escaneando un código QR con el móvil. La app sigue funcionando, y la API empieza a recibir las mismas conversaciones. Es la única ruta que importa el historial a la plataforma.

Ruta 2: migración total del número

Es la forma más radical de migrar a la API oficial de WhatsApp, y funciona así: eliminas la cuenta de WhatsApp en la aplicación y registras el número directamente en la Cloud API. La propia documentación de Meta avisa que, en ese caso, el historial de mensajes existente se pierde, y que el número solo volverá a funcionar en la app si se desregistra de la API. Después de eliminar la cuenta, el número puede tardar hasta 3 minutos en estar disponible.

Ruta 3: número nuevo

Mantienes el número antiguo en la app y creas un número nuevo solo para la API. El historial permanece intacto en el móvil antiguo. El coste es avisar a los clientes y convivir con dos números durante un tiempo.

Criterio	Coexistencia	Migración total	Número nuevo
Historial en la API	Sí, 180 días de conversaciones 1:1	No, se pierde	No, permanece en la app antigua
Móvil sigue atendiendo	Sí	No	Sí, en el número antiguo
Grupos	Solo en la app	Perdidos	Solo en la app antigua
Tasa de envío	Fija en 20 mensajes/segundo	Escala según la calidad	Escala según la calidad
Listas de difusión	Solo lectura	Sustituidas por plantillas	Sustituidas por plantillas
Riesgo para el cliente final	Ninguno, mismo número	Ninguno, mismo número	Necesita ser avisado
Mejor para	PYME con equipo que aún opera desde el móvil	Operación de alto volumen y automatización intensiva	Quien quiere separar marcas o líneas

Para la mayoría de las PYMES, la coexistencia es el punto de partida.

Lo que la coexistencia conserva y lo que queda fuera

Quien decide migrar a la API oficial de WhatsApp mediante la coexistencia suele oír del vendedor que "no pierde nada". No es del todo cierto. Según la documentación de Meta para la integración de usuarios de la app Business:

Lo que se transfiere a la API

Conversaciones individuales de los últimos 180 días, a partir del momento de la conexión.
Contenido multimedia enviado en los últimos 14 días. Fotos, audios y documentos más antiguos aparecen como marcadores, sin el archivo.
Contactos con número de WhatsApp, en una sincronización única. Los cambios posteriores llegan por webhook.
Mensajes nuevos, replicados en ambos sentidos: lo que el equipo responde en el móvil aparece en la plataforma, y viceversa.

Lo que no se transfiere (o deja de funcionar)

Grupos no se sincronizan.
Mensajes temporales, de visualización única y ubicación en tiempo real se desactivan en las conversaciones 1:1.
Listas de difusión se desactivan: las existentes se convierten en solo lectura y no se pueden crear nuevas.
Herramientas de la app como catálogo, estados, mensaje de saludo, mensaje de ausencia, respuestas rápidas y etiquetas no se transfieren a la API.
Llamadas de voz y vídeo siguen solo en el móvil.
Dispositivos vinculados (WhatsApp Web y Desktop) se desconectan al establecer la conexión. WhatsApp para Windows no es compatible con la coexistencia.

Dos detalles que pueden frustrar las migraciones

El primero: la sincronización del historial debe comenzar en un plazo de 24 horas después de la conexión, y cada etapa solo se ejecuta una vez. Si la plataforma falla en esa ventana, rehacerlo exige desconectar el número y repetir el proceso.

El segundo: el móvil principal debe permanecer activo. Si la app permanece inactiva durante aproximadamente 14 días, Meta desconecta la coexistencia. Ya explicamos esta rutina en la guía sobre el modo de coexistencia de WhatsApp.

Paso a paso: cómo migrar a la API oficial de WhatsApp sin perder el historial

El siguiente itinerario es el que seguimos cuando ayudamos a una empresa a migrar a la API oficial de WhatsApp por la ruta de la coexistencia.

Antes (D-7 a D-1)

Actualiza la app de WhatsApp Business en el móvil principal. La versión mínima requerida es la 2.24.17.
Confirma que es una cuenta Business, no el WhatsApp personal.
Haz una copia de seguridad completa en Google Drive (Android) o iCloud (iPhone). Es tu seguro si algo sale mal.
Exporta las conversaciones críticas que tengan más de 180 días. La función "Exportar chat" genera un archivo de texto por chat. Tiene un límite (10.000 mensajes recientes con contenido multimedia, 40.000 sin él), así que prioriza contratos y clientes de alto valor.
Configura el Portafolio Empresarial de Meta (antiguo Administrador Comercial) con datos reales de la empresa, NIF/CIF y un administrador con verificación en dos pasos.
Haz una lista de lo que el equipo usa de la app hoy: etiquetas, respuestas rápidas, catálogo, listas de difusión. Todo esto deberá recrearse en la plataforma.
Avisa al equipo sobre la fecha y el fin de WhatsApp Web en los ordenadores.

Durante (D-0)

Elige un horario de baja actividad, con el móvil principal cargado y conectado a Wi-Fi.
Inicia la conexión a través de la plataforma de API y elige conectar una app de WhatsApp Business existente.
Selecciona el portafolio, informa el número y escanea el código QR con el móvil principal.
Autoriza el intercambio del historial. Si te niegas, Meta no ofrece una segunda oportunidad sin rehacer todo.
Mantén la app abierta hasta que la sincronización termine. Dependiendo del volumen, tardará unos minutos.

Después (D+1 a D+14)

Verifica si las conversaciones antiguas y los contactos han aparecido en la plataforma.
Recrea respuestas rápidas, etiquetas y flujos de chatbot.
Envía las plantillas (mensajes modelo) que sustituirán a las listas de difusión. Pasan por la aprobación de Meta.
Define quién abre la app en el móvil principal al menos una vez por semana. No dejes esto a la memoria de nadie.

Cuánto cuesta migrar a la API oficial de WhatsApp en 2026

El coste de migrar a la API oficial de WhatsApp tiene tres capas, y confundir una con la otra es el error más común en los presupuestos que recibimos para revisar.

Capa 1: mensajes cobrados por Meta

Desde el 1 de julio de 2025, Meta cobra por mensaje de plantilla entregado, con un precio que varía por categoría (marketing, utilidad, autenticación) y por el país del destinatario. Marketing es la categoría más cara. Utilidad y autenticación tienen descuento por volumen mensual.

El 1 de octubre de 2026 llegó el cambio más relevante del año:

Los mensajes de servicio (respuestas libres dentro de la ventana de 24 horas que el cliente abre al escribir) pasaron a cobrarse, con 1.000 mensajes gratuitos por número de teléfono al mes. La franquicia no es acumulable.
Las plantillas de utilidad enviadas dentro de la ventana también pasaron a cobrarse, sin franquicia.
La ventana gratuita de anuncios (Click to WhatsApp) sigue siendo gratuita.

Los valores en euros están en la tabla oficial de precios de la plataforma WhatsApp Business de Meta, revisada con frecuencia.

Capa 2: la plataforma

Es la mensualidad de la herramienta (bandeja de entrada, chatbot, informes). La trampa: muchas plataformas cobran un margen sobre cada mensaje de Meta, y en el volumen de una operación de ventas ese margen pesa más que la mensualidad.

Capa 3: la implementación

Portafolio, conexión del número, plantillas, chatbot y formación, realizados por la propia empresa o contratados.

Item	Quién cobra	Cómo se cobra
Plantillas de marketing	Meta	Por mensaje entregado
Plantillas de utilidad y autenticación	Meta	Por mensaje, con descuento por volumen
Mensajes de servicio	Meta	Gratis hasta 1.000 por número/mes, después por mensaje
Mensajes enviados por la app en el móvil	Nadie	Siguen siendo gratuitas en la coexistencia
Plataforma de atención	Proveedor	Mensualidad, a veces con recargo por mensaje
Implementación	Proveedor o equipo interno	Tarifa única u horas

En la coexistencia, los mensajes que el equipo envía por la app siguen siendo gratuitos, lo que ayuda a quien quiere migrar a la API oficial de WhatsApp sin agotar la franquicia de servicio.

Cuándo NO migrar a la API oficial de WhatsApp (todavía)

No todas las empresas necesitan migrar a la API oficial de WhatsApp ahora. Quédate en la app por ahora si:

Una persona se encarga de toda la atención y el equipo no va a crecer este año.
El negocio depende de los grupos. Los grupos no se transfieren a la API, por lo que la migración no resuelve tu problema principal.
Las listas de difusión son tu único canal de campaña y no tienes interés en aprobar plantillas. En la API, una campaña es una plantilla aprobada y pagada por mensaje.
El número está bajo restricción o acaba de ser bloqueado. Resuélvelo primero: conectar un número problemático solo transfiere el problema.
Nadie va a cuidar del móvil principal. Sin la app abierta al menos cada dos semanas, la coexistencia se desactiva.

Y está el caso inverso: si hoy usas una herramienta no oficial que lee WhatsApp Web, la pregunta ya no es "cuándo", sino "cuánto tiempo aguanta el número". La comparativa API oficial vs API no oficial de WhatsApp muestra por qué ese riesgo no compensa.

Trampas comunes en la migración

Estas son las fallas que más aparecen cuando la empresa intenta migrar a la API oficial de WhatsApp sin un plan:

Borrar la cuenta de la app pensando que es coexistencia. Es la forma más rápida de perder todo el historial.
Rechazar el intercambio del historial en la pantalla de conexión. La decisión es única.
Olvidar los ordenadores con WhatsApp Web. Se desconectan, y quien respondía desde el escritorio necesita acceso a la plataforma al día siguiente.
Prometer envío masivo ilimitado. En la coexistencia, la tasa de envío es fija en 20 mensajes por segundo, y una campaña exige una plantilla aprobada.
Ignorar el cobro de los mensajes de servicio. Con la regla de octubre de 2026, una operación de soporte con miles de respuestas al mes supera la franquicia. Proyecta el volumen antes.
Webhook inestable. Si la plataforma no recibe los eventos de forma fiable, los mensajes del móvil no aparecen en el panel. Es infraestructura, no un detalle.

Pregunta al proveedor cómo monitoriza el webhook. Es la misma pregunta que hacemos sobre cualquier servidor de entorno virtual de aprendizaje Moodle que alojamos: ¿qué ocurre cuando algo deja de llegar, y quién se entera?

Cómo Agathas Web resuelve esto

Voyia es la plataforma de atención y ventas de Agathas Web sobre la API oficial de WhatsApp, conectada directamente a Meta. Fue diseñada para quien quiere migrar a la API oficial de WhatsApp saliendo de la app Business sin empezar de cero.

Lo que incluye:

Bandeja de entrada con varios agentes, transferencia entre ellos y colas por equipo (a partir del plan Profesional).
Chatbot no-code, respuestas rápidas y plantillas con variables.
Envíos masivos segmentados por etiquetas, con plantillas aprobadas.
Integración con IA usando tu propia clave (Claude, GPT, Gemini, DeepSeek), a partir del plan Profesional.
Informes de entrega, lectura y tiempo de respuesta.
App para iOS y Android, para que el equipo atienda desde cualquier lugar.
Soporte en español, facturación en euros con factura y cero recargos en los mensajes de Meta: pagas a Meta lo que es de Meta.

Cómo funciona en la práctica: contratas el plan, nosotros gestionamos la conexión de tu número a la API oficial (por la ruta que tenga sentido para tu operación) y tú configuras el equipo, los contactos, las plantillas y los flujos con los tutoriales del panel.

Cómo contratar: los planes son mensuales, sin permanencia, por número de WhatsApp. Starter a 149 €, Profesional a 349 € y Business a 749 € al mes. Starter y Profesional tienen una tarifa de instalación y configuración, con un valor informado por el equipo de ventas. Los detalles de cada plan están en la página de Voyia, y allí mismo puedes hablar con el equipo comercial.

Conclusión: migra con una ruta definida, no por sorpresa

Es posible migrar a la API oficial de WhatsApp sin perder el historial, siempre que la ruta sea la coexistencia y que hagas los deberes antes: app actualizada, copia de seguridad, exportación de las conversaciones antiguas y un responsable del móvil principal. La migración total y el número nuevo también tienen su lugar, pero ninguno de los dos transfiere el historial a la API.

Añade a esto el nuevo cobro de los mensajes de servicio y la elección de la plataforma se convierte en una decisión financiera, no solo técnica. Si quieres hacer este cambio con quien se encarga de la infraestructura y no cobra margen en los mensajes, conoce Voyia y solicita una conversación con nuestro equipo.