Esta guía existe para responder una única pregunta:
👉 "¿Cuál FAQ de WhatsApp debo leer antes de integrar mi número?"
Antes de comenzar cualquier integración o migración, lee esta página.
Evita pérdida de número, bloqueos, errores de configuración y retrabajo.
🧠 Visión general: hay 2 puntos importantes antes de conectar tu número
La integración de WhatsApp con Cloud Chat implica los siguientes puntos principales:
-
Identificar si el número es nuevo o ya existente y, en base a ello, asegurar que todos los requisitos previos de Meta estén validados antes de iniciar la integración.
-
Elegir el modelo de integración (con o sin coexistencia).
Cada escenario cuenta con una documentación específica.
📌 Primer paso: ¿Número nuevo o número existente?
🆕 Número nuevo
Nunca ha sido usado en:
-
Aplicación de WhatsApp Business
-
Otro proveedor de tecnología (ejemplo: Cloud Chat)
-
Otra WABA en Meta
⚠️ La integración es un proceso delicado.
Si se realiza incorrectamente, puede generar bloqueo o pérdida del número.
👉 Lee obligatoriamente antes de migrar:
Requisitos previos obligatorios antes de conectar un número nuevo de WhatsApp
🔄 Número existente (migración)
Ya ha sido usado en:
-
Aplicación de WhatsApp Business
-
Otro proveedor de tecnología (ejemplo: Cloud Chat)
-
Otra WABA en Meta
⚠️ La migración es un proceso delicado.
Si se realiza incorrectamente, puede generar bloqueo o pérdida del número.
👉 Lee obligatoriamente antes de migrar:
Requisitos previos obligatorios para migración de número WhatsApp
📥 Importación de historial de tickets (via API) en caso de migración
Después de completar la migración, es posible importar tickets de otro sistema de ayuda mediante API de Cloud Chat.
Esto es recomendable para empresas que:
-
Están migrando de otro sistema de atención
-
Quieren recuperar tickets antiguos para consulta, auditoría o continuidad operacional
La importación se realiza mediante un endpoint específico de la API de Cloud Chat, enviando los datos estructurados de los tickets (contacto, fechas, mensajes e identificadores).
👉 Lee la documentación técnica completa con ejemplos de solicitudes y estructura obligatoria:
Importación de historial de tickets
📌 Segundo paso: Elegir el modelo de integración — Con o sin coexistencia
Antes de conectar, debes decidir cómo operará el número en el día a día de tu negocio.
🔒 Integración SIN coexistencia (API exclusiva)
El número funciona exclusivamente via API oficial de Meta (WABA) dentro de Cloud Chat.
Tras la conexión:
-
Todos los mensajes se envían y reciben solo a través de Cloud Chat (u otros sistemas conectados a la API)
-
Ya no será posible usar el número en la aplicación de WhatsApp Business.
Ideal para empresas que:
-
Operan 100% vía help desk
-
Utilizan automatizaciones y chatbots
-
No necesitan usar WhatsApp en el teléfono celular
-
Buscan mayor estabilidad y control operacional
💡 Si aún necesitas usar el número en el celular, este no es el modelo ideal.
👉 Lee el paso a paso completo para realizar la integración:
Cómo conectar un número de WhatsApp mediante API oficial (sin coexistencia)
🔁 Integración CON coexistencia (Móvil + API simultáneamente)
El número funciona al mismo tiempo:
-
En la app de WhatsApp Business (móvil)
-
En la API oficial (WABA) vía Cloud Chat
Esto permite mantener parte de la operación en el móvil mientras Cloud Chat opera en paralelo.
📥 Historial de mensajes
Al realizar la integración con coexistencia, el historial de conversaciones de los últimos 6 meses se sincroniza e importa automáticamente en Cloud Chat.
Esto permite continuidad en la atención, manteniendo el contexto de las conversaciones recientes ya realizadas en el móvil.
⚠️ Importante: hay una limitación técnica en esta sincronización — los archivos adjuntos (imágenes, videos, audios y documentos) no se importan a Cloud Chat.
Solución alternativa: si necesitas acceder a archivos antiguos, debes consultarlos directamente en el teléfono, usando la propia app de WhatsApp Business.
📌 ¿Dónde aparece la coexistencia en el móvil?
En la app de WhatsApp Business, en la sección de Dispositivos conectados.
Cloud Chat aparecerá como un dispositivo adicional conectado vía API.
⚠️ ¿Qué pasa si alguien desconecta?
Si alguien con acceso al móvil remueve manualmente el dispositivo conectado:
-
Cloud Chat dejará de recibir mensajes inmediatamente.
-
Será necesario volver a realizar todo el proceso de integración.
⚠️ Limitación importante de la coexistencia
Los mensajes enviados desde aplicaciones no soportadas por Meta no se reflejan en Cloud Chat.
Ejemplos de apps no soportadas:
-
WhatsApp Desktop (Windows)
-
WhatsApp en WearOS
Estos mensajes siguen visibles en el teléfono principal, pero no generan webhook, por lo que no aparecen en Cloud Chat.
👉 Para entender en detalle por qué sucede esto, cómo diagnosticar y cuáles son las alternativas, ingresa a:
¿No aparecen mensajes en Cloud Chat? Entienda la limitación de la coexistencia
Ideal para empresas que:
-
Aún necesitan operar desde el móvil
-
Tienen vendedores, consultores o gestores de cuentas usando la app móvil
-
Quieren automatizar la atención de forma gradual
-
Desean probar la API sin dejar de usar la app
👉 Lee el paso a paso completo para realizar la integración:
Cómo conectar un número de WhatsApp con coexistencia (móvil + API)
❌ Errores comunes que esta guía ayuda a evitar
-
Iniciar la integración sin validar el estado de la WABA
-
No desactivar la Verificación en Dos Pasos antes de la migración
-
No entender la limitación de WhatsApp Desktop en coexistencia
-
Confundir número nuevo con número migrado
-
No validar la forma de pago cuando sea necesaria