Inicio WhatsApp | Conexión, plantillas y envío Cómo conectar un número de WhatsApp con coexistencia (App + API)

Cómo conectar un número de WhatsApp con coexistencia (App + API)

Última actualización el Aug 19, 2026

Cuándo usarlo

  • Ya usas el número en el WhatsApp Business App (celular) y quieres seguir usándolo

  • Quieres probar la API y automatizaciones sin renunciar al uso manual por celular

  • Tu equipo (vendedores, consultores, account managers) necesita seguir usando el celular

  • Quieres una transición gradual hacia la API sin interrumpir la operación actual

Limitación importante de la coexistencia: dispositivos no compatibles

Meta tiene una limitación oficial en el modelo de coexistencia: los mensajes intercambiados por el WhatsApp Desktop (Windows) o por el WhatsApp en WearOS no llegan al Cloud Chat — aunque aparezcan en el celular, y tampoco llegan al destinatario. Esta limitación solo afecta a la coexistencia; en el modelo sin coexistencia (API exclusiva) el problema no existe.

Reporte típico del cliente:

Los mensajes enviados por el agente no están llegando al cliente.

Los mensajes del cliente aparecen en el celular, pero no en el Cloud Chat.

Detalles técnicos en la documentación oficial de Meta — en resumen, esas apps no disparan el webhook smb_message_echoes que la API usa para espejar la conversación.

Cómo sortearlo

Migrar al modelo SIN coexistencia (API exclusiva): todos los mensajes pasan por la API, ya no hay conflicto entre dispositivos, y el número deja de funcionar en el celular.

Paso a paso: Como conectar um número do WhatsApp via API oficial (sem coexistência).

Requisitos previos

Iniciar la integración sin validar los puntos de abajo puede resultar en pérdida del número, bloqueo por parte de Meta, errores en el proceso de verificación o en la necesidad de rehacer toda la configuración.

¿Migración de un número existente? Lee primero la guía de migración — lectura obligatoria.

Si el número que quieres conectar ya está activo en otra plataforma de atención o en otro proveedor (BSP), NO inicies el flujo de Registro Incorporado antes de leer:

Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento

Saltarte esa etapa puede resultar en:

  • Fallas en el proceso de verificación y migración trabada

  • Imposibilidad de liberar el número del proveedor anterior

  • Necesidad de rehacer toda la configuración desde cero

La guía de migración muestra todos los requisitos previos de Meta (propiedad de la WABA, Verificación en Dos Pasos, estado del Business Manager, método de pago, historial de mensajes) que deben validarse antes de realizar la integración en el Cloud Chat.

¿Número nuevo? Hay que calentarlo antes de intentar integrarlo.

Meta evalúa el historial de uso del número antes de liberar la conexión vía API. Los números recién creados, sin historial en el WhatsApp Business App, pueden ser bloqueados en el propio Registro Incorporado — Meta devuelve el error:

"Tu número de teléfono no está habilitado para conectarse a la plataforma de WhatsApp Business. Se necesita más actividad en la app de WhatsApp Business para ayudar a determinar la habilitación." (#3441045)

Cómo calentarlo antes de integrar:

  • Usa el número en el WhatsApp Business App (celular) por algunos días / semanas, recibiendo conversaciones reales

  • Difunde el número en tus canales (sitio, redes sociales, correo) para generar entrada orgánica

  • Responde dentro de la ventana de 24 h, sin spam, sin mensajes repetidos, sin enlaces sospechosos

Después del calentamiento, el número entra en la API con mejor tier y Quality Rating, y el Registro Incorporado pasa sin el error anterior.

Documentación oficial de Meta: Messaging Limits · Quality Rating.

Validando el estado del Portafolio Empresarial

El Portafolio Empresarial (Business Portfolio) debe estar con el estado "Verificada" en Meta. Eso significa que Meta reconoció y validó la identidad de tu empresa.

¿Por qué importa? Sin la verificación, quedas sujeto a límites muy bajos de envío (hasta 250 mensajes/día), no puedes migrar números de otros proveedores y puedes tener restricciones en funcionalidades de la API. La verificación es el primer requisito para una operación sana en la plataforma de Meta.

Cómo verificarlo:

  1. Accede a business.facebook.com/settings/info

  2. Revisa el campo Estado de la verificación

  3. Debe estar como "Verificada" ✅

Si está como "No verificada" o "Pendiente", haz clic en Iniciar verificación y sigue el proceso con documentos y dominio de la empresa antes de continuar.

¿No usas WhatsApp Business App en el celular?

La coexistencia fue hecha para quien mantiene el número activo en el celular (WhatsApp Business App) en paralelo a la API. Si no vas a usar el número en el celular — solo en el Cloud Chat / API — este modelo no tiene sentido. Usa el método sin coexistencia:

Como conectar um número do WhatsApp via API oficial (sem coexistência)

El número ya debe estar registrado y activo en el WhatsApp Business App (celular) antes de empezar — la coexistencia solo funciona si el número ya está vinculado y en uso en la app antes del Registro Incorporado. Si el número todavía no está en el WhatsApp Business App, instala la app y registra el número.

Paso a paso de la integración con coexistencia

Con todos los requisitos previos de arriba validados, ya puedes iniciar la integración. Para eso, ten a mano:

  • Ser administrador de la cuenta en el Cloud Chat

  • Acceso de administrador al Portafolio Empresarial en Meta (necesario para autorizar la conexión en el flujo de Embedded Signup)

  • Tener el celular con el WhatsApp Business App a mano para leer el QR code en la sincronización

  • Tarjeta de crédito habilitada para pago en dólares — obligatorio en migración de plataforma de atención o para envíos proactivos

Etapa 1 — Acceder a la sección "Configurações" (Configuraciones) del Cloud Chat

  1. En el Cloud Chat, accede a Configurações (Configuraciones)

  1. Ve hasta la sección Caixas de Entrada (Bandejas de Entrada)

Etapa 2 — Iniciar la creación de la bandeja de entrada de WhatsApp

  1. Haz clic en Adicionar Caixa de Entrada (Agregar Bandeja de Entrada)

  1. Selecciona WhatsApp

  1. En la pantalla del Canal de WhatsApp, elige el proveedor Cadastro Incorporado (Embedded Signup) y completa el nombre deseado para la bandeja de entrada. Luego, haz clic en Entrar via WhatsApp

Etapa 3 — Autenticarse en Meta

En el pop-up de Meta que se abrirá, inicia sesión con la cuenta personal de Facebook de la persona que tiene acceso de administrador al Portafolio Empresarial (Business Portfolio) de la empresa en Meta.

El inicio de sesión no se hace con un correo corporativo genérico ni con una "cuenta de la empresa" — es con el Facebook personal de quien es admin del portafolio empresarial en Meta. Sin ese permiso administrativo, el flujo de Registro Incorporado no consigue autorizar la conexión y la integración se traba en esta etapa.

  1. Después del inicio de sesión, haz clic en Continuar

Etapa 4 — Seleccionar el Business Portfolio y activar la coexistencia

  1. Elige el Business Portfolio en Meta y haz clic en Avanzar

  1. Selecciona Conectar WhatsApp Business App existente y haz clic en Avanzar

Etapa 5 — Verificar el número

  1. Selecciona Agregar un nuevo número, ingresa el número de teléfono y verifícalo

Si el número es un teléfono fijo o un número digital, la verificación deberá hacerse por llamada telefónica, no por SMS.

Etapa 6 — Sincronizar con el WhatsApp Business App mediante QR code

  1. Después de la verificación, haz clic en Concluir (Finalizar) para iniciar la sincronización con el WhatsApp Business App

  2. Abre el WhatsApp Business en el celular, lee el QR code y sigue las instrucciones en el aparato

Importación del historial de contactos y mensajes

En el momento de la integración, el celular recibirá una notificación solicitando la importación del historial del número. Al confirmar, Meta sincroniza automáticamente el historial de mensajes y contactos de los últimos 6 meses hacia el Cloud Chat.

Aunque la importación está prevista en la documentación oficial de Meta, en integraciones recientes observamos que Meta puede no enviar el historial completo en el momento de la sincronización. Es común que parte de los mensajes o algunos contactos no se importen.

Ese comportamiento es intermitente y está fuera del control del Cloud Chat, ya que depende de la entrega de Meta. Mantén registros paralelos si es necesario.

Etapa 7 — Configurar el pago (si corresponde)

Cuándo el registro del método de pago es OBLIGATORIO:

  • Migración de un número existente — siempre obligatorio, sin excepción. Sin un método de pago válido, Meta no concluye la migración de la WABA.

  • Envío proactivo (template / campaña / mensaje unitario vía API) — obligatorio, porque Meta cobra por template enviado fuera de la ventana de 24 h.

  • Reapertura de la ventana de 24 h de Meta — obligatorio. Para iniciar una nueva conversación con un cliente fuera de la ventana activa, hay que enviar un template, y eso tiene costo directo cobrado por Meta a la tarjeta registrada.

  • Encuesta de satisfacción (CSAT) — el mensaje de CSAT también es un template de Meta. Si se envía fuera de la ventana de 24 h (caso común cuando el cliente no responde justo después de la atención), sin método de pago registrado el CSAT no se envía — el cliente no recibe la pregunta de evaluación y la métrica queda vacía.

Sin una tarjeta válida registrada en la WABA, ningún mensaje proactivo sale, ninguna ventana se reabre y ningún CSAT se entrega fuera de la ventana — el número queda restringido a responder dentro de las 24 h posteriores al último mensaje del cliente.

  1. Haz clic en Adicionar método de pagamento (Agregar método de pago) para registrar el método de pago en la WABA. Para una atención puramente reactiva (responder mensajes dentro de la ventana de 24 h, sin envíos proactivos y sin migración), haz clic en "Finish".

Etapa 8 — Agregar agentes a la bandeja de entrada

  1. Configura los agentes que tendrán acceso a la nueva bandeja de entrada

  1. Haz clic en Adicionar agentes (Agregar agentes)

La bandeja de entrada con coexistencia está integrada y lista para usar. ✅

Observaciones

El Cloud Chat aparece en el celular como dispositivo conectado, en WhatsApp Business App → Dispositivos Conectados

Si alguien quita el Cloud Chat de la lista de dispositivos en el celular, la integración se deshará y será necesario rehacer todo el proceso.