Migración
Si cuentas con una configuración existente del cliente de la API de WhatsApp Business con una base de datos y quieres migrar tanto el cliente como la base de datos a una nueva configuración con el mismo número de teléfono, en este documento se muestra cómo puedes identificar los cambios necesarios y las acciones que debes realizar al respecto.
Antes de empezar
- Realizar una copia de seguridad es el paso más importante de la migración.
- No es necesario que vuelvas a registrar el número de teléfono después de la migración. Puedes comenzar a enviar mensajes en cuanto la migración se complete.
- La nueva configuración debe tener el mismo número de particiones que la anterior. No puedes ampliar ni reducir los recursos durante la migración. Si la configuración anterior incluye X objetos maestros e Y aplicaciones principales, la nueva configuración debe tener exactamente el mismo número de ambos elementos. Si el número de maestros y aplicaciones principales no coincide antes y después de la migración, esta generará un error.
- Prueba a migrar una cuenta de prueba antes de migrar una cuenta de producción.
- Se producirá un tiempo de inactividad. La duración de este dependerá de la opción de migración. Sin embargo, todas las migraciones provocan un tiempo de inactividad.
Opciones de migración
Existen varias opciones de migración en función de la cantidad de datos que quieres migrar. Elige la opción que mejor se ajuste a 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 aplicación | ✔ | ✔ | ✔ |
Registro | ✔ | ✔ | ✔ |
Claves de cifrado | ✔ | ✔ | ✔ |
Mensajes | |||
Mensajes | ✔ | ✔ | |
Devoluciones de llamada | ✔ | ✔ | |
Contactos | ✔ | ✔ | |
Identificadores de autenticación | |||
Datos de usuario de la API | ✔ | ||
Identificadores de autenticación de la API | ✔ |
Caso de uso habitual y tiempo de inactividad para cada opción de migración
En la siguiente tabla se describen los casos de uso habituales de cada opción de migración y el tiempo de inactividad relacionado. Estos solo son casos de uso habituales; debes elegir el tipo de opción de migración que se ajuste a tus necesidades.
| Caso de uso general | Tiempo de inactividad | |
|---|---|---|
Opción 1 | Como proveedor de soluciones, migras un cliente final a tu plataforma y quieres que se conserven solo los datos de configuración. | Esta opción tiene el tiempo de inactividad más bajo en comparación con otras opciones, ya que la cantidad de datos que se debe transferir entre equipos es mínima. |
Opción 2 | Como proveedor de soluciones, migras un cliente final a tu plataforma y quieres que se conserven los datos de configuración y mensajes. | Esta opción presenta un mayor tiempo de inactividad en comparación con la Opción 1, ya que los datos de configuración y mensajes se deben transferir entre equipos. El tamaño de estos datos puede ser bastante grande en función de la empresa. |
Opción 3 | Como cliente directo de WhatsApp, administras el cliente de la API de WhatsApp Business por tu cuenta y vas a migrar tanto dicho cliente como los datos a otra máquina. | Esta opción presenta el tiempo de inactividad más alto en comparación con las demás opciones, ya que se debe transferir la totalidad de los datos del cliente entre máquinas. Estos datos pueden aumentar bastante de tamaño en función de la empresa. |
Opción 1: solo configuración
En una migración solo de configuración, únicamente se crea y restaura una copia de seguridad de la información de configuración. No se transfiere la información sobre los mensajes y el identificador de autenticación.
Paso 1: descargar una nueva configuración
Configura el nuevo cliente de la API de WhatsApp Business con ayuda de la documentación de instalación.
Paso 2: obtener un nuevo identificador de autenticación para la nueva configuración
El identificador de autenticación actual no será válido en el nuevo entorno. Inicia sesión en la nueva configuración para obtener un nuevo identificador de autenticación.
Paso 3: limpiar
- [Opcional] Desactiva la autenticación en dos pasos. Esta acción resulta útil cuando olvidas el código de la autenticación en dos pasos y necesitas volver a registrarte. Aunque no es necesario volver a registrarse para completar la migración correctamente, es posible que te veas obligado a registrarte de nuevo si se genera un error en la creación y restauración de la copia de seguridad por algún motivo desconocido. Sigue las instrucciones para desactivar el código de autenticación en dos pasos.
Nota: Este paso es opcional si estás seguro de que tu código de autenticación en dos pasos es correcto. - [Opcional] Restablece los webhooks. Si los webhooks están configurados para recibir notificaciones de entrada y el servidor de webhooks también va a cambiarse durante la migración, desactiva el servidor anterior desde la configuración de la aplicación.
Nota: Este paso es opcional si no vas a cambiar el servidor de webhooks después de la migración.
Paso 4: realizar una copia de seguridad de la configuración del entorno actual
Utiliza el identificador de autenticación actual para realizar una copia de seguridad de los datos de configuración del cliente de la API de WhatsApp Business actual.
Paso 5: desinstalar la configuración actual
Esto provocará un tiempo de inactividad para los mensajes. A fin de reducirlo al mínimo, comprueba que el cliente de la API de WhatsApp Business esté listo para ejecutarse en la nueva ubicación. Consulta la sección Desinstalación de la guía de instalación correspondiente para obtener instrucciones. Asegúrate de desinstalar solo el cliente de la API de WhatsApp Business, que incluye los contenedores de Docker de la aplicación principal, la aplicación web y el objeto maestro. No elimines la base de datos.
Paso 6: restaurar los parámetros en la nueva configuración
Inicia sesión, si aún no lo has hecho, utilizando un nuevo identificador de autenticación y realiza una restauración en la configuración nueva.
El nuevo cliente de la API de WhatsApp Business debe ejecutarse con toda la información necesaria y estar listo para enviar mensajes. Debes recordar que no es necesario que vuelvas a registrar la cuenta de WhatsApp si los procesos de copia de seguridad y restauración de la configuración se realizan correctamente.
Paso 7: realizar una comprobación de estado
Realiza una comprobación de estado y envía un mensaje de prueba para verificar que el cliente de la API de WhatsApp Business funciona.
Paso 8: [opcional] habilitar la verificación en dos pasos
Si la desactivaste en el Paso 3, habilita de nuevo la verificación en dos pasos en este momento. De este modo, obtendrás seguridad adicional para tu cuenta de WhatsApp.
Paso 9: configurar webhooks
Configura los webhooks para habilitar las notificaciones entrantes.
Paso 10: eliminar la base de datos anterior
La base de datos anterior contiene los datos de tu configuración, mensajes e identificadores de autenticación antiguos. Si quieres recuperar algunos de estos datos en el futuro, no elimines la base de datos anterior. Si decides eliminar la base de datos, asegúrate antes de que el cliente de la API de WhatsApp Business se haya ejecutado un mínimo de 14 días y de que el envío de mensajes funcione correctamente.
Opción 2: configuración y mensajes
En una migración de configuración y mensajes, se crea y restaura una copia de seguridad de la información de configuración y los mensajes. No se migra la información del identificador de autenticación.
Ten cuidado con la cantidad de datos que necesitan transferirse a otra máquina. Dado que hay más datos de los que se debe realizar una copia de seguridad y a restaurar, el tiempo de inactividad es relativamente superior al de la Opción 1. El tiempo de inactividad total variará en función de la cantidad de datos que se van a transferir y las latencias de la red.
Paso 1: limpiar
- [Opcional] Desactiva la autenticación en dos pasos. Esta acción resulta útil cuando olvidas el código de la autenticación en dos pasos y necesitas volver a registrarte. Aunque no es necesario volver a registrarse para completar la migración correctamente, es posible que te veas obligado a registrarte de nuevo si se genera un error en la creación y restauración de la copia de seguridad por algún motivo desconocido. Sigue las instrucciones para desactivar el código de autenticación en dos pasos.
Nota: Este paso es opcional si estás seguro de que tu código de autenticación en dos pasos es correcto. - [Opcional] Restablece los webhooks. Si los webhooks están configurados para recibir notificaciones de entrada y el servidor de webhooks también va a cambiarse durante la migración, desactiva el servidor anterior desde la configuración de la aplicación. Este es el primer paso en el que el envío de mensajes comienza a experimentar un tiempo de inactividad.
Nota: Este paso es opcional si no vas a cambiar el servidor de webhooks después de la migración.
Paso 2: desinstalar la configuración actual
Esto provocará un tiempo de inactividad para los mensajes. A fin de reducirlo al mínimo, comprueba que el cliente de la API de WhatsApp Business esté listo para ejecutarse en la nueva ubicación. Consulta la sección Desinstalación de la guía de instalación correspondiente para obtener instrucciones. Asegúrate de desinstalar solo el cliente de la API de WhatsApp Business; no elimines la base de datos.
Paso 3: crear una copia de seguridad de la base de datos
Crea una copia de seguridad para todas las bases de datos a excepción de waweb, que contiene datos de usuario y de autenticación, con una herramienta como mysqldump o pg_dump desde el cliente actual de la API de WhatsApp Business.
Nota: Es importante que excluyas waweb si eres un proveedor de soluciones que está migrando una empresa con tu plataforma como destino u origen. Es posible que no quieras continuar o proporcionar los identificadores de autenticación y la información de los usuarios almacenados actualmente.
Paso 4: restaurar la base de datos
Restaura la base de datos con una herramienta como mysqldump o pg_dump en el cliente nuevo de la API de WhatsApp Business.
Paso 5: descargar una nueva configuración
Configura el nuevo cliente de la API de WhatsApp Business con ayuda de la documentación de instalación. Asegúrate de que la base de datos apunte a la ubicación restaurada en el Paso 4.
Paso 6: obtener un nuevo identificador de autenticación para la nueva configuración
El identificador de autenticación actual no será válido en el nuevo entorno. Inicia sesión en la nueva configuración para obtener un nuevo identificador de autenticación.
El nuevo cliente de la API de WhatsApp Business debe ejecutarse con toda la información necesaria y estar listo para enviar mensajes. Debes recordar que no es necesario que vuelvas a registrar la cuenta de WhatsApp si los procesos de copia de seguridad y restauración de la base de datos se realizan correctamente.
Paso 7: realizar una comprobación de estado
Realiza una comprobación de estado y envía un mensaje de prueba para verificar que el cliente de la API de WhatsApp Business funciona.
Paso 8: [opcional] habilitar la verificación en dos pasos
Si la desactivaste en el Paso 1, habilita de nuevo la verificación en dos pasos en este momento. De este modo, obtendrás seguridad adicional para tu cuenta de WhatsApp.
Paso 9: configurar webhooks
Configura los webhooks para habilitar las notificaciones entrantes.
Paso 10: eliminar la base de datos anterior
La base de datos anterior contiene los datos de tu configuración, mensajes e identificadores de autenticación antiguos. Si quieres recuperar algunos de estos datos en el futuro, no elimines la base de datos anterior. Si decides eliminar la base de datos, asegúrate antes de que el cliente de la API de WhatsApp Business se haya ejecutado un mínimo de 14 días y de que el envío de mensajes funcione correctamente.
Opción 3: migración completa
En una migración completa, se crea y restaura una copia de seguridad de toda la configuración, los mensajes y los identificadores de autenticación.
Esta opción puede parecer la mejor de todas, pero debes mirar con atención la cantidad de datos que necesitan transferirse a otra máquina. Dado que hay más datos de los que se debe realizar una copia de seguridad y a restaurar, el tiempo de inactividad es relativamente superior al de la Opción 1 y la Opción 2.
Paso 1: limpiar
- [Opcional] Desactiva la autenticación en dos pasos. Esta acción resulta útil cuando olvidas el código de la autenticación en dos pasos y necesitas volver a registrarte. Aunque no es necesario volver a registrarse para completar la migración correctamente, es posible que te veas obligado a registrarte de nuevo si se genera un error en la creación y restauración de la copia de seguridad por algún motivo desconocido. Sigue las instrucciones para desactivar el código de autenticación en dos pasos.
Nota: Este paso es opcional si estás seguro de que tu código de autenticación en dos pasos es correcto.
Paso 2: crear una copia de seguridad del identificador de autenticación actual
La validez máxima de un identificador es de 7 días. Asegúrate de que el identificador tiene suficiente tiempo para que realices la migración.
Paso 3: desinstalar la configuración actual
Esto provocará un tiempo de inactividad para los mensajes. A fin de reducirlo al mínimo, comprueba que el cliente de la API de WhatsApp Business esté listo para ejecutarse en la nueva ubicación. Consulta la sección Desinstalación de la guía de instalación correspondiente para obtener instrucciones. Asegúrate de desinstalar solo el cliente de la API de WhatsApp Business; no elimines la base de datos.
Paso 4: [opcional] crear una copia de seguridad de la base de datos
Crea una copia de seguridad de la base de datos con una herramienta como mysqldump o pg_dump para capturar los datos de configuración, los mensajes y los identificadores de autenticación.
Nota: Si solo vas a migrar el cliente de la API de WhatsApp Business y no la base de datos, este paso es opcional.
Paso 5: restaurar la base de datos
Restaura la base de datos con una herramienta como mysqldump o pg_dump en el cliente nuevo de la API de WhatsApp Business.
Paso 6: descargar una nueva configuración
Configura el nuevo cliente de la API de WhatsApp Business con ayuda de la documentación de instalación. Asegúrate de que la base de datos apunte a la ubicación restaurada en el Paso 5.
El nuevo cliente de la API de WhatsApp Business debe ejecutarse con toda la información necesaria y estar listo para enviar mensajes. Debes recordar que no es necesario que vuelvas a registrar la cuenta de WhatsApp si los procesos de copia de seguridad y restauración de los datos se realizan correctamente.
Paso 7: realizar una comprobación de estado
Realiza una comprobación de estado y envía un mensaje de prueba para verificar que el cliente de la API de WhatsApp Business funciona.
Paso 8: [opcional] habilitar la verificación en dos pasos
Si la desactivaste en el Paso 1, habilita de nuevo la verificación en dos pasos en este momento. De este modo, obtendrás seguridad adicional para tu cuenta de WhatsApp.
Paso 9: configurar webhooks
Configura los webhooks para habilitar las notificaciones entrantes.
Paso 10: eliminar la base de datos anterior
La base de datos anterior contiene los datos de tu configuración, mensajes e identificadores de autenticación antiguos. Si quieres recuperar algunos de estos datos en el futuro, no elimines la base de datos anterior. Si decides eliminar la base de datos, asegúrate antes de que el cliente de la API de WhatsApp Business se haya ejecutado un mínimo de 14 días y de que el envío de mensajes funcione correctamente.