Migración
Si ya tienes una instalación del cliente de la API de WhatsApp Business con una base de datos y deseas migrar tanto el cliente como la base de datos a una instalación nueva con el mismo número de teléfono, este documento te ayudará a identificar los cambios que debes hacer y cómo hacerlos.
Antes de empezar
- La copia de seguridad es el paso más importante de la migración.
- No es necesario que vuelvas a registrar tu número de teléfono después de la migración. Puedes comenzar a enviar mensajes tan pronto como finalice la migración.
- La nueva instalación debe tener la misma cantidad de fragmentos que la antigua. No puedes hacer cambios de escala durante la migración. Si la instalación antigua tiene una cantidad X de objetos maestros y una cantidad Y de apps principales, la instalación nueva debe tener exactamente la misma cantidad de dichos elementos. Si la cantidad de objetos maestros y apps principales antes y después de la migración no coincide, se producirá un error.
- Migra una cuenta de prueba antes de hacerlo con una cuenta en producción.
- Habrá tiempo de inactividad. El tiempo depende de la opción de migración, pero siempre hay tiempo de inactividad.
Opciones de migración
Hay varias opciones de migración en función de la cantidad de datos que desees migrar. Elige la opción que sea más adecuada para tus necesidades.
Datos que se conservan en cada opción de migración
| Opción 1 | Opción 2 | Opción 3 | |
|---|---|---|---|
Configuración | |||
Configuración de la app | ✔ | ✔ | ✔ |
Registro | ✔ | ✔ | ✔ |
Claves de cifrado | ✔ | ✔ | ✔ |
Mensajes | |||
Mensajes | ✔ | ✔ | |
Devoluciones de llamadas | ✔ | ✔ | |
Contactos | ✔ | ✔ | |
Tokens de autenticación | |||
Datos de usuario de la API | ✔ | ||
Tokens de autenticación de la API | ✔ |
Caso de uso y tiempo de inactividad típicos de cada opción de migración
En esta tabla, se describen los casos de uso típicos de cada opción de migración y el tiempo de inactividad correspondiente a cada uno. Se trata simplemente de casos de uso típicos; puedes elegir el tipo de migración en función de tus necesidades.
| Caso de uso general | Tiempo de inactividad | |
|---|---|---|
Opción 1 | Un proveedor de soluciones transfiere un cliente final a tu plataforma y deseas conservar solamente los datos de configuración. | Esta opción es la de menor tiempo de inactividad en comparación con las demás opciones porque la cantidad de datos que hay que transferir entre los equipos es mínima. |
Opción 2 | Un proveedor de soluciones transfiere un cliente final a tu plataforma y deseas conservar tanto los datos de configuración como los de mensajes. | El tiempo de inactividad de esta opción es mayor que el de la opción 1 porque hay que transferir tanto los datos de configuración como los datos de mensajes entre los equipos. La cantidad de datos puede ser considerable en función del negocio. |
Opción 3 | Un cliente directo de WhatsApp que administra el cliente de la API de WhatsApp Business y desea transferir a otro equipo el cliente de la API de WhatsApp Business y los datos asociados. | Esta opción es la de mayor tiempo de inactividad en comparación con las demás opciones porque es necesario transferir la totalidad de los datos entre los equipos. La cantidad de datos puede ser considerable en función del negocio. |
Opción 1: Solo configuración
En una migración de configuración solamente, se hace una copia de seguridad y se restaura solo la información de configuración. La información de mensajes y token de autenticación no se migra.
Paso 1: Realiza una nueva instalación
Usa la documentación de instalación para configurar tu nuevo cliente de la API de WhatsApp Business.
Paso 2: Obtén un nuevo token de autenticación para la nueva instalación
El token de autenticación actual no será válido en el nuevo entorno. Inicia sesión en la nueva instalación para obtener un token de autenticación nuevo.
Paso 3: Limpieza
- [Opcional] Desactiva la autenticación en dos pasos. Esto es útil cuando olvidas el código de autenticación en dos pasos y debes volver a registrarte. Si bien no es obligatorio volver a registrarse para que la migración se realice sin problemas, tal vez debas hacerlo si se produce algún error por algún motivo desconocido durante el proceso de copia de seguridad y restauración. Sigue las instrucciones para desactivar el código de autenticación en dos pasos.
Nota: Si tienes la certeza de que el código de autenticación en dos pasos es correcto, este paso es opcional. - [Opcional] Restablece los webhooks. Si hay webhooks configurados para recibir notificaciones entrantes y también se va a cambiar el servidor de webhook como parte de la migración, desactiva el servidor de webhook antiguo en la configuración de la app.
Nota: Este paso es opcional si no se va a cambiar el servidor de webhook después de la migración.
Paso 4: Realiza una copia de seguridad de la configuración desde la instalación actual
Utiliza el token de autenticación actual para realizar una copia de seguridad de los datos de configuración desde el cliente de la API de WhatsApp Business.
Paso 5: Desinstala la instalación actual
Al hacerlo, se genera un tiempo de inactividad para el envío de mensajes. Para minimizarlo, asegúrate de que el cliente de la API de WhatsApp Business esté listo para ejecutarse en la nueva ubicación. Consulta la sección sobre desinstalación de la guía de instalación correspondiente para obtener instrucciones. Asegúrate de desinstalar solamente el cliente de la API de WhatsApp Business, que incluye los contenedores Docker de la app principal, de la app web y de los objetos maestros; no elimines la base de datos.
Paso 6: Restaura la configuración en la nueva instalación
Inicia sesión si todavía no estás utilizando un nuevo token de autenticación y ejecuta una operación de restauración en la nueva instalación.
El nuevo cliente de la API de WhatsApp Business debería estar ejecutándose con toda la información requerida y ya debería poder utilizarse para enviar mensajes. Lo más importante que debes recordar es que no es obligatorio volver a registrar la cuenta de WhatsApp si la copia de seguridad y la restauración de la configuración se realizan correctamente.
Paso 7: Ejecuta una comprobación de estado
Ejecuta una comprobación de estado y envía un mensaje de prueba para verificar que el cliente de la API de WhatsApp Business esté funcionando.
Paso 8: [Opcional] Activa la verificación en dos pasos
Si la desactivaste en el paso 3, vuelve a activar la verificación en dos pasos ahora. Esto proporciona seguridad adicional para tu cuenta de WhatsApp.
Paso 9: Configura los webhooks
Configura los webhooks para activar notificaciones entrantes.
Paso 10: Elimina la base de datos antigua
La base de datos antigua contiene los datos de la configuración antigua, los mensajes antiguos y los tokens de autenticación antiguos. Si deseas recuperar estos datos en el futuro, no elimines la base de datos antigua. Una vez que decidas eliminar la base de datos, asegúrate de que el cliente de la API de WhatsApp Business se haya estado ejecutando durante al menos 14 días y de que el servicio de mensajes esté funcionando correctamente antes de eliminarla.
Opción 2: Configuración y mensajes
En una migración de configuración y mensajes, se hace una copia de seguridad y se restaura la información de configuración y los mensajes. La información de token de autenticación no se migra.
Ten en cuenta la cantidad de datos que hay que transferir a otro equipo. Como la cantidad de datos que hay que incluir en la copia de seguridad y restaurar es mayor, el tiempo de inactividad es relativamente mayor que con la opción 1. El tiempo de inactividad total variará en función de la cantidad de datos que se transfiera y las latencias de la red.
Paso 1: Limpieza
- [Opcional] Desactiva la autenticación en dos pasos. Esto es útil cuando olvidas el código de autenticación en dos pasos y debes volver a registrarte. Si bien no es obligatorio volver a registrarse para que la migración se realice sin problemas, tal vez debas hacerlo si se produce algún error por algún motivo desconocido durante el proceso de copia de seguridad y restauración. Sigue las instrucciones para desactivar el código de autenticación en dos pasos.
Nota: Si tienes la certeza de que el código de autenticación en dos pasos es correcto, este paso es opcional. - [Opcional] Restablece los webhooks. Si hay webhooks configurados para recibir notificaciones entrantes y también se va a cambiar el servidor de webhook como parte de la migración, desactiva el servidor de webhook antiguo en la configuración de la app. Este es el primer paso durante el que comienza a haber tiempo de inactividad para el envío de mensajes.
Nota: Este paso es opcional si no se va a cambiar el servidor de webhook después de la migración.
Paso 2: Desinstala la instalación actual
Al hacerlo, se genera un tiempo de inactividad para el envío de mensajes. Para minimizarlo, asegúrate de que el cliente de la API de WhatsApp Business esté listo para ejecutarse en la nueva ubicación. Consulta la sección sobre desinstalación de la guía de instalación correspondiente para obtener instrucciones. Asegúrate de solo desinstalar el cliente de la API de WhatsApp Business; no elimines la base de datos.
Paso 3: Realiza una copia de seguridad de la base de datos
Realiza una copia de seguridad de todas las bases de datos excepto por waweb, que incluye datos de usuarios y autenticación, mediante una utilidad como mysqldump o pg_dump desde el cliente actual de la API de WhatsApp Business.
Nota: Es importante excluir waweb si eres proveedor de soluciones y estás migrando un negocio de una plataforma a otra. Podría no ser conveniente transferir o entregar tokens de autenticación e información de usuario actualmente almacenados.
Paso 4: Restaura la base de datos
Restaura la base de datos en el nuevo cliente de la API de WhatsApp Business mediante una utilidad como mysqldump o pg_dump.
Paso 5: Realiza una nueva instalación
Usa la documentación de instalación para configurar tu nuevo cliente de la API de WhatsApp Business. Asegúrate de apuntar tu base de datos a la ubicación restaurada en el paso 4.
Paso 6: Obtén un nuevo token de autenticación para la nueva instalación
El token de autenticación actual no será válido en el nuevo entorno. Inicia sesión en la nueva instalación para obtener un token de autenticación nuevo.
El nuevo cliente de la API de WhatsApp Business debería estar ejecutándose con toda la información requerida y ya debería poder utilizarse para enviar mensajes. Lo más importante que debes recordar es que no es obligatorio volver a registrar la cuenta de WhatsApp si la copia de seguridad y la restauración de la base de datos se realizan correctamente.
Paso 7: Ejecuta una comprobación de estado
Ejecuta una comprobación de estado y envía un mensaje de prueba para verificar que el cliente de la API de WhatsApp Business esté funcionando.
Paso 8: [Opcional] Activa la verificación en dos pasos
Si la desactivaste en el paso 1, vuelve a activar la verificación en dos pasos ahora. Esto proporciona seguridad adicional para tu cuenta de WhatsApp.
Paso 9: Configura los webhooks
Configura los webhooks para activar notificaciones entrantes.
Paso 10: Elimina la base de datos antigua
La base de datos antigua contiene los datos de la configuración antigua, los mensajes antiguos y los tokens de autenticación antiguos. Si deseas recuperar estos datos en el futuro, no elimines la base de datos antigua. Una vez que decidas eliminar la base de datos, asegúrate de que el cliente de la API de WhatsApp Business se haya estado ejecutando durante al menos 14 días y de que el servicio de mensajes esté funcionando correctamente antes de eliminarla.
Opción 3: Migración completa
En una migración completa, se hace una copia de seguridad y una restauración de la configuración, los mensajes y los tokens de autenticación.
Esta opción puede parecer la mejor, pero ten en cuenta la cantidad de datos que hay que transferir a otro equipo. Como la cantidad de datos que hay que incluir en la copia de seguridad y restaurar es mayor, el tiempo de inactividad es relativamente mayor con esta opción que con las opciones 1 y 2.
Paso 1: Limpieza
- [Opcional] Desactiva la autenticación en dos pasos. Esto es útil cuando olvidas el código de autenticación en dos pasos y debes volver a registrarte. Si bien no es obligatorio volver a registrarse para que la migración se realice sin problemas, tal vez debas hacerlo si se produce algún error por algún motivo desconocido durante el proceso de copia de seguridad y restauración. Sigue las instrucciones para desactivar el código de autenticación en dos pasos.
Nota: Si tienes la certeza de que el código de autenticación en dos pasos es correcto, este paso es opcional.
Paso 2: Realiza una copia de seguridad del token de autenticación actual
La validez máxima del token es de 7 días. Asegúrate de que el token tenga tiempo suficiente para que realices la migración.
Paso 3: Desinstala la instalación actual
Al hacerlo, se genera un tiempo de inactividad para el envío de mensajes. Para minimizarlo, asegúrate de que el cliente de la API de WhatsApp Business esté listo para ejecutarse en la nueva ubicación. Consulta la sección sobre desinstalación de la guía de instalación correspondiente para obtener instrucciones. Asegúrate de solo desinstalar el cliente de la API de WhatsApp Business; no elimines la base de datos.
Paso 4: [Opcional] Realiza una copia de seguridad de la base de datos
Haz una copia de seguridad de la base de datos mediante una utilidad como mysqldump o pg_dump para capturar los datos de configuración, los mensajes y los tokens de autenticación.
Nota: Si solo migras el cliente de la API de WhatsApp Business, pero no la base de datos, este paso es opcional.
Paso 5: Restaura la base de datos
Restaura la base de datos en el nuevo cliente de la API de WhatsApp Business mediante una utilidad como mysqldump o pg_dump.
Paso 6: Realiza una nueva instalación
Usa la documentación de instalación para configurar tu nuevo cliente de la API de WhatsApp Business. Asegúrate de apuntar tu base de datos a la ubicación restaurada en el paso 5.
El nuevo cliente de la API de WhatsApp Business debería estar ejecutándose con toda la información requerida y ya debería poder utilizarse para enviar mensajes. Lo más importante que debes recordar es que no es obligatorio volver a registrar la cuenta de WhatsApp si la copia de seguridad y la restauración de los datos se realizan correctamente.
Paso 7: Ejecuta una comprobación de estado
Ejecuta una comprobación de estado y envía un mensaje de prueba para verificar que el cliente de la API de WhatsApp Business esté funcionando.
Paso 8: [Opcional] Activa la verificación en dos pasos
Si la desactivaste en el paso 1, vuelve a activar la verificación en dos pasos ahora. Esto proporciona seguridad adicional para tu cuenta de WhatsApp.
Paso 9: Configura los webhooks
Configura los webhooks para activar notificaciones entrantes.
Paso 10: Elimina la base de datos antigua
La base de datos antigua contiene los datos de la configuración antigua, los mensajes antiguos y los tokens de autenticación antiguos. Si deseas recuperar estos datos en el futuro, no elimines la base de datos antigua. Una vez que decidas eliminar la base de datos, asegúrate de que el cliente de la API de WhatsApp Business se haya estado ejecutando durante al menos 14 días y de que el servicio de mensajes esté funcionando correctamente antes de eliminarla.