Cómo migrar proveedores de WhatsApp API sin perder tu número ni las plantillas

Por lo general, puedes mover un número de teléfono elegible de la Plataforma WhatsApp Business de un proveedor a otro mientras conservas el número y los atributos importantes de la cuenta, pero no debes asumir que cada plantilla, mensaje o flujo de trabajo se transferirá. Una migración segura verifica la propiedad de Meta Business, la preparación del WABA de destino, la aprobación del nombre para mostrar, los requisitos de pago y región de datos, el acceso al número, la verificación en dos pasos, las plantillas elegibles, los Webhooks, las credenciales de la aplicación, la copia de seguridad del historial y la validación posterior al corte antes de cancelar el servicio anterior.

Comprender qué es lo que realmente se está moviendo

Una migración de proveedor de WhatsApp normalmente cambia el proveedor o la plataforma a través de la cual se conecta y opera un número de teléfono. No es una transferencia de toda tu aplicación de servicio al cliente o marketing.

Separa el proyecto en tres capas:

1. Capa de cuenta de Meta: Portafolio de Negocios de Meta, Cuenta de WhatsApp Business (WABA), número de teléfono, nombre para mostrar, calificación de calidad, límite de mensajes, estado de Cuenta Comercial Oficial cuando corresponda y plantillas de mensajes.
2. Capa de conexión del proveedor: relación de incorporación, credenciales, puntos finales de mensajes, configuración de Webhooks, facturación, registros y objetos específicos del proveedor.
3. Capa de aplicación empresarial: Historial de Bandeja de Entrada, asignaciones, notas, campos de contacto, registros de consentimiento, segmentos, campañas, automatizaciones, conocimiento de IA, integraciones, informes e identificadores de mensajes internos.

La documentación de los proveedores YCloud, Twilio, 360dialog y respond.io indica que los atributos importantes del número y las plantillas elegibles pueden retenerse o duplicarse en migraciones compatibles. También muestra por qué las garantías generales no son seguras: las plantillas de baja calidad, rechazadas, pendientes o no elegibles pueden no moverse; la calidad de la plantilla puede reiniciarse o revisarse; las conversaciones históricas y los objetos de flujo de trabajo específicos del proveedor pueden seguir diferentes reglas.

Qué se puede retener comúnmente

La documentación actual de los proveedores identifica ampliamente lo siguiente como retenible en una migración elegible de proveedor a proveedor:

• el número de teléfono;
• nombre para mostrar aprobado;
• calificación de calidad del número de teléfono;
• nivel de límite de mensajes;
• estatus de Cuenta Comercial Oficial, cuando la cuenta lo tiene; y
• plantillas aprobadas y elegibles.

Las reglas exactas varían. Twilio dice que Meta duplica las plantillas de alta calidad en el WABA de destino y las revisa nuevamente; algunas pueden ser rechazadas, y la calidad de la plantilla duplicada comienza como desconocida. YCloud dice que las plantillas aprobadas de calidad media/alta se sincronizan, mientras que las de baja calidad o inutilizables no lo hacen y la calidad de la plantilla comienza de nuevo. Respond.io excluye de manera similar las plantillas de baja calidad, rechazadas o pendientes.

Trata estas fuentes como orientación específica del destino, no como una promesa universal. Pide a tu proveedor seleccionado que confirme por escrito las reglas actuales para tu WABA de origen, WABA de destino, portafolio comercial y ruta de migración.

Qué comúnmente no se mueve automáticamente

No asumas que lo siguiente se transferirá con el número:

• contenido de conversaciones históricas almacenado por el proveedor anterior;
• Asignaciones de Bandeja de Entrada, comentarios internos, etiquetas o estado de casos;
• registros de contactos del proveedor y atributos personalizados;
• definiciones de campañas y análisis de campañas pasadas;
• configuración de flujos de trabajo, bots, Journey o agentes de IA;
• mapeos de CRM e integraciones de comercio electrónico;
• credenciales de API, URLs de puntos finales o secretos de Webhooks;
• identificadores de mensajes del proveedor e historial de registros; o
• plan, saldo, créditos y arreglos de soporte.

La guía de migración de números de YCloud dice explícitamente que los registros de chat históricos no se migran y aconseja respaldarlos con el proveedor original. Respond.io describe la protección de sus flujos de trabajo y transmisiones existentes al mover un canal ya conectado a la oferta de proveedor de respond.io; eso no debe generalizarse a flujos de trabajo arbitrarios almacenados en el sistema de un proveedor diferente.

Crea un inventario artefacto por artefacto y asigna un propietario para exportar, reconstruir, validar o retirar deliberadamente cada elemento.

Paso 1: Congelar el Alcance y Seleccionar una Ventana de Cambio

Documente las cuentas de origen y destino, los ID de WABA, Meta Business Portfolio, el número de teléfono, el nombre para mostrar, la región de datos, las plantillas activas, las aplicaciones de envío y Webhook, las dependencias operativas y las personas responsables.

Elija una ventana de menor riesgo, pause los envíos de campañas no esenciales y establezca un punto de decisión claro para proceder o escalar. No prometa "tiempo de inactividad cero". Algunos proveedores describen la migración como tener ningún tiempo de inactividad, mientras que otras transiciones documentadas pueden tener una breve interrupción. Planifique mensajes retrasados o fallidos hasta que su propia validación demuestre lo contrario.

Paso 2: Confirme la preparación del negocio y el WABA

Las guías de migración del proveedor generalmente requieren una configuración saludable y propiedad adecuada. Verifique que el Business Portfolio y el WABA de origen estén activos y accesibles, que el WABA de destino esté listo, que los pagos o facturas cumplan con los requisitos aplicables, que el nombre para mostrar esté aprobado sin cambios pendientes, que las regiones de datos sean compatibles cuando sea relevante, que los administradores puedan acceder a WhatsApp Manager y que el destino tenga espacio para el número.

La guía de migración actual de Twilio dice que el WABA de origen y el nuevo WABA de destino deben usar la misma región de localización de datos durante el registro. YCloud describe mover entre WABAs en la misma cuenta de Business Manager. Debido a que los diseños de incorporación difieren, siga las instrucciones actuales del proveedor de destino en lugar de copiar pasos de otro proveedor.

Paso 3: Asegure el acceso al número de teléfono

El flujo de migración generalmente requiere la verificación del número mediante un código de un solo uso por SMS o voz. Confirme que su equipo puede recibirlo antes de la ventana de cambio, incluso para números virtuales o números detrás de un IVR.

Registre quién controla el número, quién puede recibir el código, si los SMS o llamadas internacionales funcionan, cualquier enrutamiento IVR y el método de respaldo. No reintente repetidamente sin comprender un fallo.

Paso 4: Desactive la verificación en dos pasos en el momento correcto

Las instrucciones de migración de YCloud, Twilio, 360dialog y respond.io identifican la desactivación de la verificación en dos pasos de WhatsApp para el número como un paso de preparación. Si su equipo no puede cambiarlo directamente, el proveedor existente o el administrador de la cuenta de Meta pueden necesitar ayudar.

Trate esto como un cambio de seguridad controlado: identifique al propietario, desactívelo cerca de la migración, limite el acceso durante la ventana, complete la verificación y restaure los controles de seguridad recomendados después de la validación. No lo desactive días antes sin una razón.

Paso 5: Haga una copia de seguridad de las plantillas y clasifique su riesgo

Exporte o registre cada plantilla que utilicen sus aplicaciones, incluyendo:

• nombre de la plantilla e idioma;
• categoría;
• componentes, variables, medios y botones;
• estado actual de aprobación y calidad;
• propietario del negocio y caso de uso;
• código de aplicación o flujo de trabajo que lo llama; y
• volumen de envíos recientes y criticidad.

Clasifique las plantillas como críticas, reemplazables u obsoletas. Resalte las plantillas pendientes, rechazadas, pausadas, deshabilitadas, de baja calidad o editadas recientemente porque pueden no calificar para la migración.

Después del corte, compare la lista de plantillas de destino con el inventario. Twilio advierte que las plantillas duplicadas se revisan y algunas pueden ser rechazadas. Los identificadores de plantilla específicos del proveedor también pueden cambiar, así que actualice los mapeos de la aplicación en lugar de asumir que el antiguo identificador funcionará.

Paso 6: Exporte la capa de aplicación empresarial

Preserve los registros requeridos para operaciones y cumplimiento: contactos y consentimiento, listas de supresión, casos abiertos, atributos del cliente, historial permitido, registros de campañas, lógica de automatización, configuración de IA, integraciones y líneas base de informes. Verifique el formato, completitud, marcas de tiempo, identificadores, cifrado y retención. Un CSV de contactos no es una copia de seguridad completa si los flujos de trabajo dependen del contexto del mensaje o caso.

Paso 7: Prepare el destino antes del corte

Antes de tocar el número de producción, prepare usuarios, roles, esquema de contactos, enrutamiento del Inbox, automatización aprobada, mapeos del sistema, el receptor Webhook autenticado, monitoreo, credenciales almacenadas de manera segura y un plan de prueba para cada ruta crítica de mensajes.

Si el destino es YCloud, esto puede incluir configurar su Inbox, Contacto, Campaña, Journey, Chatbot, Agente de IA y conexiones API/Webhook de acuerdo con las partes que su equipo utilizará. Si el destino es API-first, prepare sus propios sistemas operativos y capa de integración.

Paso 8: Ejecute la migración dirigida por el proveedor

Siga el flujo de registro o migración actual integrado del proveedor de destino. Por lo general, el proceso le pedirá que seleccione el Meta Business Portfolio existente, use o cree el WABA de destino apropiado, ingrese el número de teléfono existente y lo verifique con el código de un solo uso.

Evite improvisar con pasos de una publicación de blog antigua. Los requisitos de migración cambian, y el proveedor de destino es responsable de su flujo de trabajo de incorporación actual.

Paso 9: Reconecte APIs, Webhooks y mapeos de mensajes

Un movimiento exitoso del número no reconecta automáticamente su aplicación. Actualice las URL o SDK, las credenciales y los alcances, los identificadores de remitente/WABA/plantilla, la verificación Webhook, el análisis de eventos, la lógica de reintento e idempotencia, los destinos posteriores y los umbrales de monitoreo.

Evite que la integración antigua envíe después del corte, pero preserve el acceso de solo lectura a los registros históricos hasta que las reglas de retención y contrato permitan el cierre.

Paso 10: Ejecute una validación por capas

Valide el número y el nombre para mostrar primero, luego las plantillas calificadas, la aceptación y eventos de estado salientes, la entrega entrante de Webhook e Inbox, la respuesta del agente, una automatización aprobada, controles de consentimiento/supresión y reconciliación de CRM/informes.

Utiliza destinatarios controlados y un caso negativo. Mantén el volumen de la campaña bajo hasta que la entrega, las respuestas y el enrutamiento se mantengan estables.

Paso 11: Estabiliza, luego cancela el servicio antiguo

No canceles la suscripción de origen antes de validar el destino, a menos que el proceso de los proveedores requiera explícitamente una secuencia diferente. Por ejemplo, 360dialog indica a los clientes que migran que liquiden facturas, desactiven la autenticación de dos factores, completen la migración con el nuevo proveedor y luego cancelen la suscripción del número antiguo para evitar cargos adicionales.

Después de la estabilización, confirma que no llegue tráfico crítico al punto final antiguo, exporta los registros y facturas permitidos, cancela los servicios antiguos, elimina el acceso obsoleto, restaura los ajustes de seguridad necesarios, actualiza la documentación operativa y registra lo que migró y lo que no.

Elige un destino que coincida con el modelo operativo

La migración es un buen momento para decidir si solo necesitas una conexión API o una capa operativa completa de WhatsApp. Los equipos liderados por desarrolladores con sistemas existentes pueden preferir Twilio o un proveedor de API centrado en WhatsApp como 360dialog. Los equipos que desean soporte, marketing, automatización, datos de clientes, IA e integraciones juntos deben incluir YCloud en la evaluación. Los equipos de conversación multicanal también pueden evaluar respond.io o plataformas similares.

Utiliza la lista reducida de proveedores de API de WhatsApp y la guía de selección de BSP antes de elegir el destino. La migración más segura comienza con la adecuación del comprador, propiedad clara y una ruta de salida probada, no con una transferencia de último momento del número.

Preguntas frecuentes

¿Puedo conservar mi número de teléfono de WhatsApp al cambiar de proveedor?

Generalmente, un número elegible de WhatsApp Business Platform puede migrarse, sujeto a los requisitos de Meta y del proveedor. Confirma la propiedad del negocio, la preparación del WABA, el estado del nombre para mostrar, el acceso al número, las condiciones de pago o facturación, la verificación en dos pasos y la elegibilidad del destino.

¿Se moverán todas mis plantillas de WhatsApp al nuevo proveedor?

No lo des por sentado. La documentación actual del proveedor indica que las plantillas aprobadas que cumplen los requisitos pueden duplicarse o sincronizarse, mientras que las de baja calidad, rechazadas, pendientes o no elegibles podrían no moverse. Los identificadores nuevos o revisados también podrían requerir cambios en la aplicación.

¿El historial de chat de WhatsApp migra con el número?

La migración de número entre proveedores no debe tratarse como una transferencia de historial de chat. YCloud indica explícitamente que los registros históricos de chat no migran en su flujo de migración de números. Exporta el historial permitido y verifica las opciones de importación del destino por separado.

¿La migración de proveedor de WhatsApp garantiza que no habrá tiempo de inactividad?

No existe una promesa universal segura de tiempo de inactividad cero. Planifica una ventana controlada, pausa los envíos no esenciales, prueba el destino por capas y prepara una escalada. La interrupción real depende de la ruta de migración y los sistemas circundantes.

¿Cuándo debería cancelar mi proveedor antiguo?

Por lo general, después de que el número de destino, las plantillas, las API, los Webhooks, la Bandeja de entrada y los flujos de trabajo críticos hayan pasado la validación, a menos que las instrucciones del proveedor requieran lo contrario. También liquida facturas, exporta los datos necesarios y confirma la cancelación para evitar facturación continua.