Cuándo usarlo
- Tienes una duda puntual sobre la integración de WhatsApp y quieres una respuesta rápida
- Estás en preonboarding y quieres tener a mano las respuestas frecuentes del equipo
- Quieres mapear caminos alternativos antes de abrir un ticket de soporte
Sobre el número y la cuenta
¿Necesito un chip físico o un celular para integrar?
No necesariamente. Para la integración sin coexistencia (API exclusiva), no necesitas un chip físico: puedes usar un número virtual. Para la integración con coexistencia, necesitas el celular con la WhatsApp Business App instalada en el momento de la configuración.
¿Qué es un número virtual? ¿Dónde lo compro?
Un número virtual es un número de teléfono que funciona sin chip físico, contratado en línea. Cloud Chat recomienda BR DID para quienes necesitan un número virtual para usar en la API.
¿Puedo usar mi número personal de WhatsApp?
No lo recomendamos. La WhatsApp Business API está pensada para números empresariales. Además, al integrar sin coexistencia, el número deja de funcionar en la app del celular, lo que causaría problemas si es tu número personal.
¿Puedo tener dos números de WhatsApp diferentes conectados en Cloud Chat?
Sí. Cada número queda en una bandeja de entrada separada. De forma predeterminada, una cuenta verificada puede tener hasta 20 números conectados.
Detalles: ¿Cuál es el límite de números de WhatsApp conectados?
¿Puedo conectar el mismo número en dos herramientas al mismo tiempo (por ejemplo, Cloud Chat y otra plataforma)?
No. Un número solo puede estar conectado a un proveedor de API a la vez. Para migrar a Cloud Chat, primero es necesario desconectarlo del proveedor anterior.
Sobre la migración
¿Voy a perder el historial de mensajes al migrar?
El historial de mensajes del proveedor anterior no se migra automáticamente: queda accesible solo en la plataforma antigua. Si necesitas importar tickets antiguos, es posible hacerlo mediante la API de Cloud Chat: Importación de historial de tickets.
En la integración con coexistencia, se sincroniza el historial de los últimos 6 meses de la WhatsApp Business App, pero solo de forma parcial y sin garantía de que esté completo (limitación de Meta).
Mi proveedor actual no quiere liberar el número. ¿Qué hago?
Contacta al equipo de soporte de Cloud Humans: existen caminos alternativos que dependen del análisis de cada caso. Antes, confirma: ¿la WABA está en tu Business Portfolio de Meta o en el portafolio del proveedor? Si está en el tuyo, tienes control administrativo y puedes migrar por tu cuenta.
Necesito desactivar la Two-Step Verification antes de migrar. ¿Cómo lo hago si no sé la contraseña?
-
Si eres el dueño de la WABA → entra al WhatsApp Manager y desactívala directamente
-
Si el proveedor anterior controla la Two-Step Verification → solicítale que la desactive
Sin desactivar la Two-Step Verification, la migración no es técnicamente posible.
Sobre la coexistencia
¿Qué es la coexistencia?
La coexistencia es la funcionalidad de Meta que permite usar el mismo número simultáneamente en el celular (WhatsApp Business App) y en la API oficial (Cloud Chat). Detalles: Qué es la coexistencia en WhatsApp.
Si uso coexistencia, ¿qué pasa si el celular se queda sin batería o sin internet?
Cloud Chat sigue funcionando normalmente mediante la API. La coexistencia no depende de que el celular esté activo.
Si alguien elimina manualmente Cloud Chat de la lista de dispositivos vinculados en la app del celular, la integración se interrumpirá y habrá que rehacerla.
Mis mensajes de WhatsApp Desktop (Windows) no aparecen en Cloud Chat. ¿Por qué?
WhatsApp Desktop para Windows y WhatsApp WearOS no son compatibles con Meta para el espejado mediante la API en modo coexistencia. Los mensajes quedan visibles en el celular, pero no generan webhook y por eso no llegan a Cloud Chat. WhatsApp Web (navegador) funciona normalmente.
Detalles: ¿Los mensajes de WhatsApp no llegan a Cloud Chat? Entiende la limitación de la coexistencia.
¿Puedo usar grupos de WhatsApp en Cloud Chat?
No. La API oficial de Meta no admite grupos. Los grupos siguen visibles solo en el celular (en modo coexistencia), pero no aparecen en Cloud Chat.
Sobre plantillas y envíos
¿Qué son las plantillas y cuándo las necesito?
Las plantillas son mensajes preaprobados por Meta, usados para iniciar conversaciones con clientes o para enviar mensajes después de la ventana de 24 h de inactividad. Para respuestas dentro de las 24 h siguientes al último contacto del cliente, no necesitas una plantilla.
¿Por qué mi plantilla fue rechazada como Utility?
Meta reclasifica plantillas de Utility a Marketing cuando detecta lenguaje promocional, falta de contexto transaccional o un texto demasiado genérico. Para revertirlo:
-
Incluye un identificador claro (número de pedido, ticket, protocolo)
-
Usa un lenguaje objetivo
-
Elimina cualquier tono comercial
Detalles: Reglas de plantillas de WhatsApp (Meta): categorías, estructura y rechazos.
¿Por qué no logro enviar mensajes a muchos contactos a la vez?
Probablemente alcanzaste el límite de tu tier de envío. Cada cuenta comienza en el Tier 1 (1.000 conversaciones/24 h) y avanza automáticamente a medida que crecen el volumen y la calidad.
Detalles: Tiers de envío de WhatsApp: qué son y cómo evolucionar.
Troubleshooting rápido
Cloud Chat dejó de recibir mensajes de WhatsApp. ¿Qué debo verificar?
-
Verifica si la bandeja de entrada está activa en Configuraciones → Bandejas de Entrada
-
Si usas coexistencia, verifica en el celular si Cloud Chat todavía aparece en Dispositivos Vinculados
-
Si el dispositivo fue eliminado, vuelve a conectarlo: Cómo reconectar tu inbox de WhatsApp en Cloud Chat
-
Si el problema persiste, contacta al soporte
Mi mensaje aparece con error. ¿Qué significa?
Consulta la guía completa con causas y acciones para cada código: ¿Por qué no se está enviando mi mensaje? Guía Completa de Errores.
Observaciones
-
Para elegir el modelo de integración: Guía Maestro — Cómo conectar tu número de WhatsApp a Cloud Chat.
-
Documentación oficial de Meta sobre la WhatsApp Business Platform: Meta Developers — WhatsApp Business Platform.