Embedded Signup es un flujo de Meta que se muestra dentro de la experiencia de incorporación de un proveedor. Permite a tu empresa autorizar la configuración de la cuenta y el número sin entregar al proveedor tu inicio de sesión personal de Meta.
¿Quién debe iniciar Embedded Signup?
Usa el inicio de sesión de Meta del propietario del portafolio empresarial o de un administrador con permisos para gestionar sus activos de WhatsApp. La persona que completa el flujo aprueba lo que el proveedor puede conectar.
Mantén al administrador en control de la cuenta de Meta. Pedir a un proveedor que suplante a ese administrador arriesga la pérdida de control sobre los activos y los permisos. El propietario de la empresa debe revisar los activos, los permisos y los términos en el diálogo de Meta antes de confirmar.
¿Qué activos conecta el flujo?
El flujo puede conectar un portafolio empresarial de Meta, una cuenta empresarial de WhatsApp y un número de teléfono a la integración del proveedor. Las opciones exactas dependen de si creas una cuenta nueva o seleccionas una existente.
| Activo | Confirma antes de continuar |
|---|---|
| Portafolio empresarial | La empresa legal y el administrador son correctos |
| Cuenta empresarial de WhatsApp | La cuenta es la que tu equipo pretende operar |
| Número de teléfono | El número está disponible para la configuración de WhatsApp seleccionada |
| Conexión del proveedor | El proveedor y el espacio de trabajo que reciben la conexión son correctos |
El proveedor puede operar los activos conectados. Tu empresa sigue siendo responsable de las políticas de la cuenta, el permiso del cliente y el contenido de los mensajes. Revisa la política empresarial de WhatsApp de Meta antes de autorizar el acceso.
¿Qué ocurre durante el flujo?
El proveedor abre el diálogo de Embedded Signup de Meta en su panel. Tú inicias sesión, eliges o creas los activos empresariales, proporcionas los datos empresariales solicitados y autorizas la conexión del proveedor.
La verificación del teléfono puede ser un paso separado. Sigue las comprobaciones de número en la guía de números de WhatsApp de Bird antes de empezar si no tienes certeza de que el número candidato pueda conectarse.
¿Qué queda incompleto cuando se cierra el diálogo?
Cuando el diálogo se cierra, la verificación, la conexión y el envío pueden seguir incompletos. El flujo del navegador ha regresado, pero Meta puede estar aún procesando los activos.
La operación de finalización de Bird es exclusiva del panel. Una solicitud de backend no puede reproducir el consentimiento del administrador ni la selección de activos, así que no construyas una integración pública de API en torno a ella.
En Bird, lee los campos status, next y finish_setup_url del número conectado. status es un enum abierto. Incluye awaiting_signup, banned, connected, deleted, disconnected, failed, flagged, migrated, pending, preparing, rate_limited y restricted; acepta cualquier valor no reconocido. El campo separado error explica por qué falló la conexión por última vez. next informa la siguiente acción mientras la conexión está incompleta. Cuando el registro espera un paso en el navegador, finish_setup_url aparece solo para awaiting_signup; abrirlo completa el flujo del panel porque el paso no puede ejecutarse a través de la API. Consulta el recurso después de completar el flujo en lugar de tratar la redirección como una prueba de envío exitosa.
Los estados marcado, restringido y bloqueado pueden afectar el acceso de envío de un número conectado.
¿Cómo verifico la preparación para el registro?
Antes del flujo, confirma:
- El administrador puede acceder al portafolio empresarial de Meta correcto.
- Los datos de la empresa y la titularidad de la cuenta están listos para revisión.
- El número de teléfono está disponible para esta ruta de conexión.
- El espacio de trabajo del proveedor es el que debe recibir la cuenta.
Después del flujo, confirma la cuenta, el estado del número, el resultado de verificación y un envío de prueba real. Mantén registrados al propietario de la cuenta de Meta y al contacto de soporte del proveedor para recuperación.
En resumen
Lleva al administrador correcto.
El propietario o un administrador del portafolio empresarial de Meta debe completar los pasos de consentimiento y activos.
Prepara el número y la empresa.
Ten listos el portafolio empresarial, los datos de la cuenta empresarial de WhatsApp y un número para el flujo de conexión del proveedor.
Espera trabajo después del registro.
Cerrar el diálogo no garantiza la verificación, la conexión del número ni la disponibilidad de envío. Sigue el estado reportado.
Mantén clara la titularidad.
Confirma qué portafolio empresarial, cuenta y número conecta el proveedor antes de autorizar el flujo.