Cómo conectar un número de WhatsApp sin coexistencia (exclusivamente vía API)

¿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 integración en el Cloud Chat 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.

¿El número ya está registrado en el WhatsApp Business App del celular?

La integración sin coexistencia (este artículo) NO permite que el número siga funcionando en el WhatsApp Business App. Para seguir por aquí, tendrás que:

1. Eliminar la cuenta del número en el WhatsApp Business App (borrar la app o quitar la cuenta dentro de ella) antes de iniciar el Registro Incorporado (Embedded Signup)

2. Aceptar que el número dejará de funcionar en el celular después de la integración — todos los mensajes pasarán a llegar exclusivamente al Cloud Chat

Si quieres mantener el número funcionando en el WhatsApp Business App en paralelo al Cloud Chat, NO sigas este artículo. Usa el método de coexistencia:

Como conectar um número do WhatsApp com coexistência (celular + API)

¿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.

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.

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.