Embedded Signup: conectar tu número de WhatsApp sin salir del sitio

Embedded Signup es el flujo oficial de Meta para conectar un número de WhatsApp a la Cloud API sin salir del sitio de la plataforma. Todo ocurre en una ventana emergente de la propia Meta: entras con tu cuenta de Facebook Business, eliges o creas la empresa, eliges o registras el número y vuelves con la conexión lista.

Por qué importa

Antes del registro incorporado, conectar un número exigía crear aplicaciones en el panel de Meta, generar tokens de acceso y enviárselos al proveedor, normalmente por correo o chat. Además de lento, era inseguro: un token de sistema circulando fuera de cualquier caja fuerte.

En el flujo incorporado la autorización la emite Meta y se entrega directamente al servidor de la plataforma. Nunca ves ni copias un token, y el acceso concedido se puede revocar en cualquier momento en el Business Manager.

Qué pasa en cada paso

1. Inicio de sesión y elección del negocio — usas la cuenta que administra la empresa en Meta Business Manager, o creas una en el momento.
2. WhatsApp Business Account — la WABA que guardará tus números, plantillas y calificación de calidad. Nace a nombre de tu empresa.
3. Número — registrar uno nuevo (verificado por SMS o llamada) o migrar uno existente.
4. Confirmación — la ventana se cierra y la plataforma termina: identifica la WABA, suscribe los webhooks que entregan los mensajes y registra el número en la Cloud API.

A partir de ahí la bandeja empieza a recibir. Si alguien escribe al número, el mensaje aparece en tiempo real.

Coexistencia: conservar la app del móvil

Si el número ya se usa en la app de WhatsApp Business, hay una alternativa a la migración pura: el modo de coexistencia. Escaneas un código QR dentro del flujo oficial y el número pasa a funcionar en los dos sitios: la app sigue en el móvil del equipo y las mismas conversaciones aparecen en la plataforma.

Una diferencia técnica importante: los números en coexistencia no pasan por el registro en la Cloud API, porque la vinculación con la app ya cumple ese papel. Si algo pide "registrar" un número en coexistencia, la configuración está mal.

Errores habituales y qué hacer

"Este número ya está en uso" — el número está activo en el WhatsApp común o en la app Business y hay que liberarlo antes. Borrar la cuenta dentro de la app lo libera en unos minutos; o usa coexistencia, que no exige borrar nada.

La ventana no se abre — el navegador bloqueó la ventana emergente. El clic debe venir de una acción directa del usuario; si el bloqueador lo atrapó, permite el dominio e inténtalo otra vez.

"No se pudo completar la conexión" — normalmente la empresa aún no está verificada en el Business Manager, o quien inició sesión no es administrador de ella. La verificación del negocio es un proceso de Meta y tarda de horas a unos días.

No llega ningún mensaje tras conectar — los webhooks no quedaron suscritos, o el número no se registró. Reconectar por el mismo flujo resuelve la mayoría de los casos.

Después de conectar

Con el número activo, los pasos habituales son crear las primeras plantillas, invitar al equipo con roles y, si encaja, dar acceso a un agente de IA. Antes de eso conviene entender la ventana de 24 horas: es la que define qué se puede enviar y cuándo.