WhatsApp Embedded Signup para plataformas SaaS: versiones, migración y la fecha límite de v2 y v3

WhatsApp Embedded Signup es el flujo de registro que una plataforma SaaS agrega a su propio producto para que sus clientes empresariales conecten sus cuentas de WhatsApp y sus números de teléfono a la plataforma en una ventana emergente. Meta descontinúa la versión 2 (v2), la versión 3 (v3) y sus versiones de public preview el 15 de octubre de 2026.[1] La versión 4 (v4) no tiene una fecha de fin anunciada, mantiene la compatibilidad con la Marketing Messages API for WhatsApp y agrega compatibilidad con Click to WhatsApp Ads y la Conversions API. Esta guía muestra cómo comprobar qué versión usas, qué cambia en v4 y cómo migrar antes de la fecha límite.

Puntos clave

  1. El objeto extras de tu código de inicio de Embedded Signup muestra qué versión usas, y leerlo toma unos minutos.
  2. Embedded Signup v2, v3 y sus public previews llegan a su fecha de descontinuación el 15 de octubre de 2026, mientras que v4 y su public preview no tienen una fecha de fin anunciada.
  3. Meta estima hasta una semana de trabajo de desarrollo para llegar a v4, incluidas las pruebas.
  4. Meta actualiza automáticamente la mayoría de las integraciones v2 y v3 restantes, pero las integraciones v2 que usan only_waba_sharing, marketing_messages_lite o coex necesitan ajustes de desarrollo antes del 15 de octubre de 2026.
  5. Una plataforma necesita el estatus de Solution Partner o Tech Provider y acceso avanzado del App Review antes de poder hacer el onboarding de clientes empresariales.

¿Qué es WhatsApp Embedded Signup?

Embedded Signup es una interfaz de autenticación y autorización, compatible con computadoras y celulares, que los clientes empresariales usan para generar los activos de WhatsApp que un partner necesita para hacer su onboarding en la WhatsApp Business Platform.[2] Una empresa SaaS lo inicia desde un enlace o un botón, y se abre en una ventana nueva. El flujo recopila información de la empresa, crea los activos y le da a tu app de Meta acceso a ellos. Funciona sobre Facebook Login for Business y el Facebook JavaScript SDK, y los clientes conservan la propiedad de todos los activos y el acceso completo a WhatsApp Manager.

Dos tipos de partner pueden operar el flujo. Los Solution Partners ya deben tener una línea de crédito que comparten con sus clientes para la facturación. Los Tech Providers son las plataformas de software que obtienen acceso avanzado a los permisos whatsapp_business_messaging y whatsapp_business_management mediante el App Review de Meta, y sus clientes agregan un método de pago a su propia Messaging account.

Los términos de cuenta de Meta están cambiando: la documentación más antigua y muchos ejemplos de código hablan de la cuenta de WhatsApp Business (WABA), el contenedor de los activos de WhatsApp de una empresa. Meta la está dividiendo en una WhatsApp account y una Messaging account, con un despliegue que empieza el 23 de septiembre de 2026 y llega a todas las empresas a mediados de octubre de 2026, y los valores de waba_id existentes ahora corresponden a IDs de Messaging account.[3] Meta afirma que los IDs, endpoints y tokens de acceso existentes siguen funcionando durante todo el despliegue, y la descripción general de Embedded Signup de Meta califica el cambio como una beta sujeta a cambios. Esta guía usa los términos nuevos de aquí en adelante.

360Dialog, Official Meta Solution Partner, ofrece Embedded Signup a partners SaaS a través de su Partner Platform. Ahí, Integrated Onboarding tiene cuatro métodos: Direct Link (no-code), Connect Button (un paquete NPM de React, low-code), Custom IO (independiente del framework) y Partner-Hosted Embedded Signup (high-code, para Tech Providers aprobados por Meta).[4] El Embedded Signup de 360Dialog se activa automáticamente en todo Integrated Onboarding, y los partners pueden alojar su propio flujo después de cumplir los requisitos de Meta. El lado de negocio de la decisión, incluidas las ventajas y desventajas de desarrollar o comprar, la monetización y la elección de partner, está en nuestro artículo sobre el contexto de integración en SaaS.

Si tu plataforma tiene que ofrecer a sus clientes onboarding de WhatsApp antes de que Meta retire v2 y v3 el 15 de octubre de 2026, habla con nosotros sobre qué método de Integrated Onboarding se ajusta a tu producto.

¿Qué versiones de Embedded Signup siguen disponibles?

Meta lista seis versiones de Embedded Signup: v2, v3, v4 y una public preview de cada una. Meta descontinúa v2 y v3 junto con sus public previews el 15 de octubre de 2026, y todavía no anuncia una fecha de fin para v4 ni para la public preview de v4. Una public preview es una versión opcional que seleccionas con el valor version del objeto extras.

El objeto extras es la propiedad de opciones que pasas a FB.login en tu código de inicio, y su forma te indica la versión. Meta muestra estas formas para v2, v3 y v4:

// v2: no version field; sessionInfoVersion turns session logging on (possible value: 3)
extras: {
    setup: "<SETUP_DATA>",
    features: [ { name: "<FEATURE_NAME>" } ],
    featureType: "<FEATURE_TYPE>",
    sessionInfoVersion: "<SESSION_INFO_VERSION>"
}
// v3
extras: {
    setup: "<SETUP_DATA>",
    features: [ { name: "<FEATURE_NAME>" } ],
    featureType: "<FEATURE_TYPE>",
    version: "v3"
}
// v4: the extras object is purposely empty
extras: {}

Una configuración de Facebook Login for Business es un conjunto guardado de opciones de inicio de sesión en el panel de tu app de Meta, identificado por un ID de configuración, que define qué productos incluye el flujo. Meta documenta que crear una configuración nueva y seleccionar productos te pasa automáticamente a v4.[5] Por eso la configuración forma parte de la comprobación de versión de cualquier integración cuyo código de inicio no incluye un valor version. Para usar primero la public preview de v4, define el valor version:

extras: { version: "v4-public-preview" }

La página de versiones de Meta da estas fechas:

VersiónFecha de lanzamientoDisponible hasta
v4 public preview12 de mayo de 2026No anunciada
v48 de octubre de 2025No anunciada
v3 public preview14 de agosto de 202515 de octubre de 2026
v2 public preview14 de agosto de 202515 de octubre de 2026
v329 de mayo de 202515 de octubre de 2026
v2Enero de 202315 de octubre de 2026

Si estás calculando cuántos canales de clientes va a pasar tu plataforma a v4 antes de la fecha límite del 15 de octubre de 2026, habla con nosotros sobre planes y precios.

¿Qué cambia cuando pasas a v4?

v4 selecciona productos mediante una configuración de Facebook Login for Business y puede hacer el onboarding de una empresa en varios productos de mensajería de Meta en un solo flujo. La página de v4 de Meta lista Conversions API, Click to WhatsApp Ads, Click to Messenger Ads y Click to Direct Ads como productos adicionales compatibles, y afirma que v4 sigue siendo compatible con Cloud API, la Marketing Messages API for WhatsApp, el onboarding de la app WhatsApp Business, la Business Verification gestionada por el partner y la Automatic Events API.

Cloud API es la WhatsApp Business API alojada por Meta. La Marketing Messages API for WhatsApp es la API de Meta para enviar mensajes de marketing. Los Click to WhatsApp Ads (CTWA) son anuncios de Meta que abren una conversación de WhatsApp, y la Conversions API devuelve eventos de conversión a Meta para medir los anuncios. La tabla de versiones de Meta lista la Marketing Messages API for WhatsApp, Click to WhatsApp Ads y Conversions API (WhatsApp) como productos que se pueden seleccionar en la configuración de inicio de sesión solo en v4, mientras que las integraciones v2 y v3 llegan a la Marketing Messages API con el nombre de función marketing_messages_lite.

El flujo en sí cambia de varias formas:

  • Phone Number First: los clientes ingresan y verifican su número de teléfono empresarial al principio, antes de crear o seleccionar activos de la empresa, para que los problemas de elegibilidad y verificación aparezcan antes. Meta indica que el despliegue está en curso, así que algunos clientes todavía ven el orden de pantallas anterior.
  • Páginas consolidadas: la selección de activos, la información de la empresa y los permisos ocupan cada uno una sola página.
  • Activos compartidos: los administradores de activos pueden compartir activos de otros portfolios comerciales, las cuentas empresariales de Meta que contienen los activos de una empresa.
  • Vinculación de páginas: los números de teléfono se vinculan automáticamente a Páginas de Facebook cuando un cliente hace el onboarding en anuncios que hacen clic a WhatsApp mediante la Marketing API.
  • Onboarding de varios productos: un solo flujo puede cubrir WhatsApp, Instagram y Messenger, y el onboarding de una sola API sigue siendo totalmente compatible.

La public preview de v4 tiene la misma funcionalidad que v4, y Meta señala la interfaz simplificada y el flujo Phone Number First como las diferencias clave.[6] En cuanto a permisos, v4 selecciona todos los permisos y activos necesarios para los productos que eliges, y necesitas acceso avanzado para cada uno de ellos. El acceso avanzado es el nivel de permiso que Meta otorga mediante el App Review para que tu app pueda usar un permiso con los activos de los clientes empresariales. Cloud API y la Marketing Messages API for WhatsApp necesitan whatsapp_business_management y whatsapp_business_messaging, la Conversions API para CTWA necesita whatsapp_business_manage_events, y CTWA necesita ads_read, ads_management, pages_manage_ads, pages_read_engagement y pages_show_list.

¿Cómo cambian el estado de finalización y el registro de sesión según la versión?

El estado de finalización y el registro de sesión son los dos comportamientos que dependen de la versión y cambian lo que recibe tu backend. El estado de finalización es el estatus del número de teléfono con el que un cliente empresarial puede terminar el flujo, y el registro de sesión (session logging) es el evento de mensaje del navegador que informa el resultado de cada flujo. La tabla da el valor de Meta para cada versión, y los párrafos siguientes tratan los eventos en sí.

VersiónTipos de funciónEstado de finalizaciónInformación prellenadaSession info loggingProductos mediante la configuración de inicio de sesión
v4whatsapp_business_app_onboardingNúmero de teléfono verificado, no verificado o sin númeroPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosMarketing Messages API for WhatsApp, Click to WhatsApp Ads, Conversions API (WhatsApp)
v3whatsapp_business_app_onboardingNúmero de teléfono verificado, no verificado o sin númeroPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosNo compatible
v3 public previewwhatsapp_business_app_onboardingNúmero de teléfono verificado, no verificado o sin númeroPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosNo compatible
v2only_waba_sharing, whatsapp_business_app_onboarding, marketing_messages_liteNúmero de teléfono verificadoPuede completar la información de la empresa y omitir pantallasLos partners deben agregar un sessionInfoVersion para recibir el callbackNo compatible
v2 public previewonly_waba_sharing, whatsapp_business_app_onboarding, marketing_messages_liteNúmero de teléfono verificadoPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosNo compatible

El listener es un controlador de eventos de mensaje en la página que inicia el flujo. La página de implementación de Meta muestra cómo comprueba que event.origin termine en facebook.com y que data.type sea igual a WA_EMBEDDED_SIGNUP.[7] Al finalizar, recibe phone_number_id, waba_id (que contiene el ID de la Messaging account), business_id y, cuando el flujo los generó, ad_account_ids, page_ids, dataset_ids, catalog_ids, instagram_account_ids y waba_ids para flujos con varias cuentas.

El campo event distingue los resultados. Meta lista FINISH, FINISH_ONLY_WABA, FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING, FINISH_OBO_MIGRATION, FINISH_GRANT_ONLY_API_ACCESS y ERROR al finalizar. Un flujo abandonado informa CANCEL con data.current_step, la pantalla en la que el cliente salió. Un error informado por el usuario llega como CANCEL con data.error_message, data.error_code, data.session_id y data.timestamp. Cerrar la ventana emergente en la pantalla final cuenta como un onboarding exitoso. El código que devuelve el callback de respuesta tiene un tiempo de vida de 30 segundos, así que tu servidor tiene que canjearlo rápido; Meta documenta el canje en su página de onboarding como Tech Provider.

La página de v3 de Meta agrega que los partners en v3 todavía tienen que agregar un listener de eventos en la misma ventana de Embedded Signup para procesar la información entrante.[8] Como v3 y v4 permiten que los clientes terminen sin un número verificado, la misma página remite a la documentación del registro de sesión para determinar el estatus del número de teléfono de un flujo terminado.

¿Cómo funciona el onboarding con Coexistence en Embedded Signup?

Coexistence permite que una empresa siga usando la app WhatsApp Business en un número de teléfono que también funciona en Cloud API. Embedded Signup lo admite mediante el valor de featureType whatsapp_business_app_onboarding, y Meta exige Embedded Signup con registro de sesión para este flujo.[9] Meta lista estos requisitos previos:

  • El cliente usa la app WhatsApp Business en la versión 2.24.17 o superior.
  • Ya eres Solution Partner o Tech Provider y conoces Cloud API.
  • Tu webhook de callback, la dirección web donde WhatsApp entrega los eventos a tu servidor, acepta y procesa webhooks.

La página de Coexistence de Meta muestra un solo fragmento de inicio, en el Paso 2, “Customize Embedded Signup”:

// Launch method and callback registration
{
"config_id": "<CONFIGURATION_ID>",
"response_type": "code",
"override_default_response_type": true,
"extras": {
setup: {},
"featureType": "whatsapp_business_app_onboarding", // set to 'whatsapp_business_app_onboarding'
"sessionInfoVersion": "3"
}
}

El fragmento combina featureType con sessionInfoVersion y no tiene campo version. Meta no publica una sintaxis de Coexistence específica para v4: la página de v4 dice que el onboarding de usuarios de la app WhatsApp Business sigue siendo compatible mediante el parámetro feature_type y enlaza a este mismo paso. La página de instalación solo de la app (app-only install) de Meta presenta app_only_install como una forma de acceder a los activos de los clientes con tokens de empresa y afirma “App-Only Install can’t be used to onboard WhatsApp Business app users.”[10]

El changelog de Meta del 3 de septiembre de 2026 explica qué significa aquí el cambio a Phone Number First. Como el número de teléfono se recopila primero, Embedded Signup ahora entra automáticamente en el flujo de Coexistence cuando Coexistence está habilitado y el número ya se usa con la app WhatsApp Business, sin que el cliente seleccione la opción de la app. Las páginas que publica Meta dejan abierto cómo se habilita Coexistence en una configuración de v4.

En la operación, tres reglas de Meta definen la integración:

  • Throughput: los números que se usan tanto en la app como en Cloud API envían con un throughput fijo, la velocidad de envío, de 20 mensajes por segundo.
  • Sincronización del historial: después del onboarding, tienes 24 horas para sincronizar el historial de mensajes del cliente; de lo contrario, el cliente debe pasar por el offboarding.
  • Campos de webhook: suscríbete a account_update, history, smb_app_state_sync y smb_message_echoes. El evento de sesión de este flujo define event como FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING.

Durante el onboarding, Meta convierte la cuenta de WhatsApp Business existente del cliente en una Messaging account retrocompatible, y el waba_id conserva el mismo ID.

¿Cómo migrar a v4 antes de la fecha límite?

El blog para desarrolladores de Meta del 14 de mayo de 2026 afirma que “most integrations that are still on v2 or v3 after the deprecation deadline will be automatically upgraded to v4.”[11] Las integraciones que usan los tipos de función only_waba_sharing, marketing_messages_lite o coex con v2 no se pueden actualizar automáticamente y necesitan ajustes de desarrollo antes del 15 de octubre. Después de esa fecha, según Meta, esos tipos de función descontinuados dejan de funcionar y pasan al flujo estándar de Embedded Signup.

Las páginas de documentación muestran un aviso de descontinuación de una línea, y la publicación del blog deja abierto qué pasa con las empresas que ya integraste, así que confirma con Meta antes de la fecha el efecto en tus clientes actuales. Meta estima hasta una semana de trabajo de desarrollo para la actualización, incluidas las pruebas, y dice que en muchos casos la actualización toma solo unos minutos de configuración más el tiempo de pruebas.

La lista de verificación de migración sigue la página de v4 y el blog de Meta:

  1. Haz un inventario de tu código de inicio. Lee el objeto extras y lista cada featureType y cada nombre de función que uses. Todo lo que coincida con only_waba_sharing, marketing_messages_lite o coex necesita un cambio de desarrollo.
  2. Revisa tus dominios. Agrega los dominios permitidos en Facebook Login for Business, Settings, Client OAuth settings, como indica la página de implementación de Meta.
  3. Crea una configuración nueva. Ve a App Dashboard, Facebook Login for Business, Configurations, y selecciona Embedded Signup como variante de inicio de sesión.
  4. Selecciona los productos. Elige los productos que quieres incluir; seleccionar más de uno es opcional. Seleccionar productos te pasa automáticamente a v4.
  5. Reemplaza el objeto extras. Copia el ID de configuración en la llamada del Facebook Login SDK. La página de versiones de Meta muestra extras: {} para v4, y su página de implementación muestra extras: { setup: {} } en la llamada de inicio; ambos son textos vigentes de Meta, así que usa la llamada de inicio de la página de implementación como referencia de trabajo.
  6. Prueba el flujo. En el Embedded Signup Builder, selecciona la configuración nueva y abre el flujo. El blog de Meta dice “You don’t need to select a version, since the configuration now drives that logic.” Haz clic en Login with Facebook para ver v4 en vista previa e incluye los problemas comunes de la ventana emergente en los navegadores que usan tus clientes.

Los Measurement Partners necesitan una revisión aparte: la página de v3 de Meta afirma que “Measurement product onboarding will only be supported on v2 for the time being” y agrega que los Measurement Partners serán compatibles en una versión futura, sin indicar versión ni fecha, mientras que v2 llega a su fecha de descontinuación el 15 de octubre de 2026.

¿Cómo obtiene acceso a la API tu producto SaaS?

Un producto SaaS obtiene acceso a la WhatsApp API al convertirse en Tech Provider de Meta, o al trabajar con un Solution Partner, y luego hacer el onboarding de clientes empresariales mediante Embedded Signup. El camino de Tech Provider de Meta requiere una app de Meta con el caso de uso de WhatsApp y un portfolio comercial conectado, seguido de estos pasos:[12]

  • Verificación de la empresa: verifica tu empresa con Meta antes del App Review.
  • App Review: envía dos videos, uno que muestre un mensaje enviado desde tu app y recibido en WhatsApp y otro que muestre la creación de una plantilla de mensaje, el formato aprobado previamente para los mensajes que inicia la empresa, además de la documentación.
  • Acceso avanzado: el App Review otorga acceso avanzado a whatsapp_business_messaging y whatsapp_business_management, y Meta exige ambos para convertirse en Tech Provider.

Los Tech Providers pueden ofrecer mensajería de forma independiente o trabajar con un Solution Partner para ofrecer estos servicios en conjunto, en cuyo caso se necesita el ID de la app del partner. El servidor que aloja el flujo necesita un certificado SSL válido, y la descripción general de Meta indica que solo puedes hacer el onboarding de clientes empresariales cuando tu app tiene acceso avanzado a cada permiso que necesita. Meta también ofrece Hosted Embedded Signup, un enlace alojado por Meta desde el App Dashboard, como alternativa a alojar el código tú mismo.

Meta limita cuántos clientes empresariales nuevos puedes integrar:

EtapaClientes empresariales nuevos por periodo continuo de 7 días
Predeterminado10
Después de Business Verification, App Review y Access Verification200

Meta indica a los partners que necesitan más de 200 onboardings por semana que soliciten a Meta el estatus de partner. El changelog de Meta del 3 de octubre de 2025 afirma que la Access Verification ya no es obligatoria para convertirse en Tech Provider, aunque el texto de la descripción general todavía la incluye para el límite más alto.

Para las plataformas que se conectan mediante 360Dialog, Partner-Hosted Embedded Signup permite que los Tech Providers aprobados por Meta alojen un flujo personalizado. Requiere el estatus de Tech Provider con una solución en producción integrada con 360Dialog en el estatus ACTIVE de Meta, además de acceso avanzado al permiso public_profile.[13] 360Dialog recomienda Embedded Signup v4 en ese caso, porque así la Marketing Messages API se puede habilitar para el cliente durante el onboarding. 360Dialog se encarga por completo del registro del número de teléfono, así que los pasos de registro de Meta se omiten, y la resolución de problemas de scripts personalizados de Embedded Signup queda fuera del soporte técnico de 360Dialog. La relación entre los números integrados de esta forma y Meta Business Agent está en nuestra guía completa de Meta Business Agent, y qué guardar por tenant queda fuera del alcance de esta guía.

Una vez que la configuración está en producción, cada cliente nuevo pasa por la misma ventana emergente, los mismos eventos del listener y el mismo canje del token de empresa. Qué productos ofreces primero, y en qué orden los adoptan tus clientes, se vuelve una decisión de producto que la configuración ahora hace explícita.

Obtener acceso a la API para conectar a tu primer cliente con la configuración de v4 que armaste con esta guía.

Preguntas frecuentes

¿Qué es WhatsApp Embedded Signup?

WhatsApp Embedded Signup es una interfaz de autenticación y autorización que los clientes empresariales usan para generar los activos de WhatsApp que un partner necesita para integrarlos en la WhatsApp Business Platform. Una empresa SaaS lo agrega a su propio producto, donde un enlace o botón lo abre en una ventana nueva y da a la app de Meta de la empresa acceso a los activos que crea el flujo.

¿Puedo hacer el onboarding de empresas con Embedded Signup?

Sí, una empresa con estatus de Solution Partner o Tech Provider puede integrar clientes empresariales mediante Embedded Signup, siempre que su app de Meta tenga acceso avanzado a los permisos que requiere el flujo. Meta indica que una empresa solo puede integrar clientes cuando su app está aprobada para esos permisos, y el límite predeterminado es de 10 clientes empresariales nuevos en un periodo continuo de 7 días.

¿Cuándo se descontinúan Embedded Signup v2 y v3?

Meta descontinúa Embedded Signup v2 y v3, incluidas sus versiones de public preview, el 15 de octubre de 2026. La página de versiones de Meta todavía no anuncia una fecha de fin para v4 ni para la public preview de v4. Meta no indica una hora del día para la descontinuación.

¿Cómo compruebo qué versión de Embedded Signup uso?

El objeto extras de tu código de inicio de Embedded Signup muestra la versión. El valor version v3 identifica v3, el valor version v4-public-preview activa esa preview, y Meta no muestra un campo version para v2, donde aparece sessionInfoVersion en su lugar. Un flujo v4 se define al seleccionar productos en una configuración de Facebook Login for Business, así que su objeto extras está vacío o solo contiene setup.

¿Qué pasa con las integraciones que sigan en v2 o v3 después del 15 de octubre de 2026?

El blog para desarrolladores de Meta del 14 de mayo de 2026 afirma que la mayoría de las integraciones que sigan en v2 o v3 tras la fecha límite se actualizan a v4 automáticamente. Las integraciones que usan los tipos de función only_waba_sharing, marketing_messages_lite o coex con v2 no se actualizan automáticamente, y después del 15 de octubre de 2026 esas funciones dejan de funcionar y pasan al flujo estándar.

¿Embedded Signup es compatible con Coexistence?

Sí, Embedded Signup es compatible con Coexistence mediante el featureType whatsapp_business_app_onboarding, que permite que un cliente siga usando la app WhatsApp Business en un número que también funciona en Cloud API. Meta exige el registro de sesión para este flujo y muestra un solo fragmento de inicio para él, que combina el tipo de función con sessionInfoVersion definido en 3.

¿Cuánto tiempo toma migrar a v4?

Meta estima hasta una semana de trabajo de desarrollo para actualizar a v4, incluidas las pruebas. Meta agrega que en muchos casos la actualización toma solo unos minutos de configuración más el tiempo de pruebas. El trabajo se centra en crear una configuración nueva de Facebook Login for Business, seleccionar productos y reemplazar el objeto extras de tu código de inicio.

Fuentes

[1] Meta for Developers, Embedded Signup versions: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/versions

[2] Meta for Developers, Embedded Signup overview: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview

[3] Meta for Developers, WhatsApp Business Platform changelog: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog/

[4] 360Dialog Partner Docs, Integrated Onboarding: https://docs.360dialog.com/partner/onboarding/integrated-onboarding

[5] Meta for Developers, Embedded Signup version 4: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-4

[6] Meta for Developers, Embedded Signup version 4 public preview: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-4-public-preview

[7] Meta for Developers, Embedded Signup implementation: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/implementation

[8] Meta for Developers, Embedded Signup version 3: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-3

[9] Meta for Developers, Onboarding WhatsApp Business app users (Coexistence): https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users

[10] Meta for Developers, App-only install: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/app-only-install

[11] Meta for Developers blog, Embedded signup v4: Upgrade to Meta’s streamlined, unified onboarding experience before the deadline on October 15, 2026 (May 14, 2026): https://developers.facebook.com/blog/post/2026/05/14/embedded-signup-v4/

[12] Meta for Developers, Become a Tech Provider: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers

[13] 360Dialog Partner Docs, Partner-Hosted Embedded Signup: https://docs.360dialog.com/partner/onboarding/partner-hosted-embedded-signup

WhatsApp Embedded Signup es el flujo de registro que una plataforma SaaS agrega a su propio producto para que sus clientes empresariales conecten sus cuentas de WhatsApp y sus números de teléfono a la plataforma en una ventana emergente. Meta descontinúa la versión 2 (v2), la versión 3 (v3) y sus versiones de public preview el 15 de octubre de 2026.[1] La versión 4 (v4) no tiene una fecha de fin anunciada, mantiene la compatibilidad con la Marketing Messages API for WhatsApp y agrega compatibilidad con Click to WhatsApp Ads y la Conversions API. Esta guía muestra cómo comprobar qué versión usas, qué cambia en v4 y cómo migrar antes de la fecha límite.

Puntos clave

  1. El objeto extras de tu código de inicio de Embedded Signup muestra qué versión usas, y leerlo toma unos minutos.
  2. Embedded Signup v2, v3 y sus public previews llegan a su fecha de descontinuación el 15 de octubre de 2026, mientras que v4 y su public preview no tienen una fecha de fin anunciada.
  3. Meta estima hasta una semana de trabajo de desarrollo para llegar a v4, incluidas las pruebas.
  4. Meta actualiza automáticamente la mayoría de las integraciones v2 y v3 restantes, pero las integraciones v2 que usan only_waba_sharing, marketing_messages_lite o coex necesitan ajustes de desarrollo antes del 15 de octubre de 2026.
  5. Una plataforma necesita el estatus de Solution Partner o Tech Provider y acceso avanzado del App Review antes de poder hacer el onboarding de clientes empresariales.

¿Qué es WhatsApp Embedded Signup?

Embedded Signup es una interfaz de autenticación y autorización, compatible con computadoras y celulares, que los clientes empresariales usan para generar los activos de WhatsApp que un partner necesita para hacer su onboarding en la WhatsApp Business Platform.[2] Una empresa SaaS lo inicia desde un enlace o un botón, y se abre en una ventana nueva. El flujo recopila información de la empresa, crea los activos y le da a tu app de Meta acceso a ellos. Funciona sobre Facebook Login for Business y el Facebook JavaScript SDK, y los clientes conservan la propiedad de todos los activos y el acceso completo a WhatsApp Manager.

Dos tipos de partner pueden operar el flujo. Los Solution Partners ya deben tener una línea de crédito que comparten con sus clientes para la facturación. Los Tech Providers son las plataformas de software que obtienen acceso avanzado a los permisos whatsapp_business_messaging y whatsapp_business_management mediante el App Review de Meta, y sus clientes agregan un método de pago a su propia Messaging account.

Los términos de cuenta de Meta están cambiando: la documentación más antigua y muchos ejemplos de código hablan de la cuenta de WhatsApp Business (WABA), el contenedor de los activos de WhatsApp de una empresa. Meta la está dividiendo en una WhatsApp account y una Messaging account, con un despliegue que empieza el 23 de septiembre de 2026 y llega a todas las empresas a mediados de octubre de 2026, y los valores de waba_id existentes ahora corresponden a IDs de Messaging account.[3] Meta afirma que los IDs, endpoints y tokens de acceso existentes siguen funcionando durante todo el despliegue, y la descripción general de Embedded Signup de Meta califica el cambio como una beta sujeta a cambios. Esta guía usa los términos nuevos de aquí en adelante.

360Dialog, Official Meta Solution Partner, ofrece Embedded Signup a partners SaaS a través de su Partner Platform. Ahí, Integrated Onboarding tiene cuatro métodos: Direct Link (no-code), Connect Button (un paquete NPM de React, low-code), Custom IO (independiente del framework) y Partner-Hosted Embedded Signup (high-code, para Tech Providers aprobados por Meta).[4] El Embedded Signup de 360Dialog se activa automáticamente en todo Integrated Onboarding, y los partners pueden alojar su propio flujo después de cumplir los requisitos de Meta. El lado de negocio de la decisión, incluidas las ventajas y desventajas de desarrollar o comprar, la monetización y la elección de partner, está en nuestro artículo sobre el contexto de integración en SaaS.

Si tu plataforma tiene que ofrecer a sus clientes onboarding de WhatsApp antes de que Meta retire v2 y v3 el 15 de octubre de 2026, habla con nosotros sobre qué método de Integrated Onboarding se ajusta a tu producto.

¿Qué versiones de Embedded Signup siguen disponibles?

Meta lista seis versiones de Embedded Signup: v2, v3, v4 y una public preview de cada una. Meta descontinúa v2 y v3 junto con sus public previews el 15 de octubre de 2026, y todavía no anuncia una fecha de fin para v4 ni para la public preview de v4. Una public preview es una versión opcional que seleccionas con el valor version del objeto extras.

El objeto extras es la propiedad de opciones que pasas a FB.login en tu código de inicio, y su forma te indica la versión. Meta muestra estas formas para v2, v3 y v4:

// v2: no version field; sessionInfoVersion turns session logging on (possible value: 3)
extras: {
    setup: "<SETUP_DATA>",
    features: [ { name: "<FEATURE_NAME>" } ],
    featureType: "<FEATURE_TYPE>",
    sessionInfoVersion: "<SESSION_INFO_VERSION>"
}
// v3
extras: {
    setup: "<SETUP_DATA>",
    features: [ { name: "<FEATURE_NAME>" } ],
    featureType: "<FEATURE_TYPE>",
    version: "v3"
}
// v4: the extras object is purposely empty
extras: {}

Una configuración de Facebook Login for Business es un conjunto guardado de opciones de inicio de sesión en el panel de tu app de Meta, identificado por un ID de configuración, que define qué productos incluye el flujo. Meta documenta que crear una configuración nueva y seleccionar productos te pasa automáticamente a v4.[5] Por eso la configuración forma parte de la comprobación de versión de cualquier integración cuyo código de inicio no incluye un valor version. Para usar primero la public preview de v4, define el valor version:

extras: { version: "v4-public-preview" }

La página de versiones de Meta da estas fechas:

VersiónFecha de lanzamientoDisponible hasta
v4 public preview12 de mayo de 2026No anunciada
v48 de octubre de 2025No anunciada
v3 public preview14 de agosto de 202515 de octubre de 2026
v2 public preview14 de agosto de 202515 de octubre de 2026
v329 de mayo de 202515 de octubre de 2026
v2Enero de 202315 de octubre de 2026

Si estás calculando cuántos canales de clientes va a pasar tu plataforma a v4 antes de la fecha límite del 15 de octubre de 2026, habla con nosotros sobre planes y precios.

¿Qué cambia cuando pasas a v4?

v4 selecciona productos mediante una configuración de Facebook Login for Business y puede hacer el onboarding de una empresa en varios productos de mensajería de Meta en un solo flujo. La página de v4 de Meta lista Conversions API, Click to WhatsApp Ads, Click to Messenger Ads y Click to Direct Ads como productos adicionales compatibles, y afirma que v4 sigue siendo compatible con Cloud API, la Marketing Messages API for WhatsApp, el onboarding de la app WhatsApp Business, la Business Verification gestionada por el partner y la Automatic Events API.

Cloud API es la WhatsApp Business API alojada por Meta. La Marketing Messages API for WhatsApp es la API de Meta para enviar mensajes de marketing. Los Click to WhatsApp Ads (CTWA) son anuncios de Meta que abren una conversación de WhatsApp, y la Conversions API devuelve eventos de conversión a Meta para medir los anuncios. La tabla de versiones de Meta lista la Marketing Messages API for WhatsApp, Click to WhatsApp Ads y Conversions API (WhatsApp) como productos que se pueden seleccionar en la configuración de inicio de sesión solo en v4, mientras que las integraciones v2 y v3 llegan a la Marketing Messages API con el nombre de función marketing_messages_lite.

El flujo en sí cambia de varias formas:

  • Phone Number First: los clientes ingresan y verifican su número de teléfono empresarial al principio, antes de crear o seleccionar activos de la empresa, para que los problemas de elegibilidad y verificación aparezcan antes. Meta indica que el despliegue está en curso, así que algunos clientes todavía ven el orden de pantallas anterior.
  • Páginas consolidadas: la selección de activos, la información de la empresa y los permisos ocupan cada uno una sola página.
  • Activos compartidos: los administradores de activos pueden compartir activos de otros portfolios comerciales, las cuentas empresariales de Meta que contienen los activos de una empresa.
  • Vinculación de páginas: los números de teléfono se vinculan automáticamente a Páginas de Facebook cuando un cliente hace el onboarding en anuncios que hacen clic a WhatsApp mediante la Marketing API.
  • Onboarding de varios productos: un solo flujo puede cubrir WhatsApp, Instagram y Messenger, y el onboarding de una sola API sigue siendo totalmente compatible.

La public preview de v4 tiene la misma funcionalidad que v4, y Meta señala la interfaz simplificada y el flujo Phone Number First como las diferencias clave.[6] En cuanto a permisos, v4 selecciona todos los permisos y activos necesarios para los productos que eliges, y necesitas acceso avanzado para cada uno de ellos. El acceso avanzado es el nivel de permiso que Meta otorga mediante el App Review para que tu app pueda usar un permiso con los activos de los clientes empresariales. Cloud API y la Marketing Messages API for WhatsApp necesitan whatsapp_business_management y whatsapp_business_messaging, la Conversions API para CTWA necesita whatsapp_business_manage_events, y CTWA necesita ads_read, ads_management, pages_manage_ads, pages_read_engagement y pages_show_list.

¿Cómo cambian el estado de finalización y el registro de sesión según la versión?

El estado de finalización y el registro de sesión son los dos comportamientos que dependen de la versión y cambian lo que recibe tu backend. El estado de finalización es el estatus del número de teléfono con el que un cliente empresarial puede terminar el flujo, y el registro de sesión (session logging) es el evento de mensaje del navegador que informa el resultado de cada flujo. La tabla da el valor de Meta para cada versión, y los párrafos siguientes tratan los eventos en sí.

VersiónTipos de funciónEstado de finalizaciónInformación prellenadaSession info loggingProductos mediante la configuración de inicio de sesión
v4whatsapp_business_app_onboardingNúmero de teléfono verificado, no verificado o sin númeroPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosMarketing Messages API for WhatsApp, Click to WhatsApp Ads, Conversions API (WhatsApp)
v3whatsapp_business_app_onboardingNúmero de teléfono verificado, no verificado o sin númeroPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosNo compatible
v3 public previewwhatsapp_business_app_onboardingNúmero de teléfono verificado, no verificado o sin númeroPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosNo compatible
v2only_waba_sharing, whatsapp_business_app_onboarding, marketing_messages_liteNúmero de teléfono verificadoPuede completar la información de la empresa y omitir pantallasLos partners deben agregar un sessionInfoVersion para recibir el callbackNo compatible
v2 public previewonly_waba_sharing, whatsapp_business_app_onboarding, marketing_messages_liteNúmero de teléfono verificadoPuede completar la información de la empresa, no se omite ninguna pantallaSe envía en todos los flujosNo compatible

El listener es un controlador de eventos de mensaje en la página que inicia el flujo. La página de implementación de Meta muestra cómo comprueba que event.origin termine en facebook.com y que data.type sea igual a WA_EMBEDDED_SIGNUP.[7] Al finalizar, recibe phone_number_id, waba_id (que contiene el ID de la Messaging account), business_id y, cuando el flujo los generó, ad_account_ids, page_ids, dataset_ids, catalog_ids, instagram_account_ids y waba_ids para flujos con varias cuentas.

El campo event distingue los resultados. Meta lista FINISH, FINISH_ONLY_WABA, FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING, FINISH_OBO_MIGRATION, FINISH_GRANT_ONLY_API_ACCESS y ERROR al finalizar. Un flujo abandonado informa CANCEL con data.current_step, la pantalla en la que el cliente salió. Un error informado por el usuario llega como CANCEL con data.error_message, data.error_code, data.session_id y data.timestamp. Cerrar la ventana emergente en la pantalla final cuenta como un onboarding exitoso. El código que devuelve el callback de respuesta tiene un tiempo de vida de 30 segundos, así que tu servidor tiene que canjearlo rápido; Meta documenta el canje en su página de onboarding como Tech Provider.

La página de v3 de Meta agrega que los partners en v3 todavía tienen que agregar un listener de eventos en la misma ventana de Embedded Signup para procesar la información entrante.[8] Como v3 y v4 permiten que los clientes terminen sin un número verificado, la misma página remite a la documentación del registro de sesión para determinar el estatus del número de teléfono de un flujo terminado.

¿Cómo funciona el onboarding con Coexistence en Embedded Signup?

Coexistence permite que una empresa siga usando la app WhatsApp Business en un número de teléfono que también funciona en Cloud API. Embedded Signup lo admite mediante el valor de featureType whatsapp_business_app_onboarding, y Meta exige Embedded Signup con registro de sesión para este flujo.[9] Meta lista estos requisitos previos:

  • El cliente usa la app WhatsApp Business en la versión 2.24.17 o superior.
  • Ya eres Solution Partner o Tech Provider y conoces Cloud API.
  • Tu webhook de callback, la dirección web donde WhatsApp entrega los eventos a tu servidor, acepta y procesa webhooks.

La página de Coexistence de Meta muestra un solo fragmento de inicio, en el Paso 2, “Customize Embedded Signup”:

// Launch method and callback registration
{
"config_id": "<CONFIGURATION_ID>",
"response_type": "code",
"override_default_response_type": true,
"extras": {
setup: {},
"featureType": "whatsapp_business_app_onboarding", // set to 'whatsapp_business_app_onboarding'
"sessionInfoVersion": "3"
}
}

El fragmento combina featureType con sessionInfoVersion y no tiene campo version. Meta no publica una sintaxis de Coexistence específica para v4: la página de v4 dice que el onboarding de usuarios de la app WhatsApp Business sigue siendo compatible mediante el parámetro feature_type y enlaza a este mismo paso. La página de instalación solo de la app (app-only install) de Meta presenta app_only_install como una forma de acceder a los activos de los clientes con tokens de empresa y afirma “App-Only Install can’t be used to onboard WhatsApp Business app users.”[10]

El changelog de Meta del 3 de septiembre de 2026 explica qué significa aquí el cambio a Phone Number First. Como el número de teléfono se recopila primero, Embedded Signup ahora entra automáticamente en el flujo de Coexistence cuando Coexistence está habilitado y el número ya se usa con la app WhatsApp Business, sin que el cliente seleccione la opción de la app. Las páginas que publica Meta dejan abierto cómo se habilita Coexistence en una configuración de v4.

En la operación, tres reglas de Meta definen la integración:

  • Throughput: los números que se usan tanto en la app como en Cloud API envían con un throughput fijo, la velocidad de envío, de 20 mensajes por segundo.
  • Sincronización del historial: después del onboarding, tienes 24 horas para sincronizar el historial de mensajes del cliente; de lo contrario, el cliente debe pasar por el offboarding.
  • Campos de webhook: suscríbete a account_update, history, smb_app_state_sync y smb_message_echoes. El evento de sesión de este flujo define event como FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING.

Durante el onboarding, Meta convierte la cuenta de WhatsApp Business existente del cliente en una Messaging account retrocompatible, y el waba_id conserva el mismo ID.

¿Cómo migrar a v4 antes de la fecha límite?

El blog para desarrolladores de Meta del 14 de mayo de 2026 afirma que “most integrations that are still on v2 or v3 after the deprecation deadline will be automatically upgraded to v4.”[11] Las integraciones que usan los tipos de función only_waba_sharing, marketing_messages_lite o coex con v2 no se pueden actualizar automáticamente y necesitan ajustes de desarrollo antes del 15 de octubre. Después de esa fecha, según Meta, esos tipos de función descontinuados dejan de funcionar y pasan al flujo estándar de Embedded Signup.

Las páginas de documentación muestran un aviso de descontinuación de una línea, y la publicación del blog deja abierto qué pasa con las empresas que ya integraste, así que confirma con Meta antes de la fecha el efecto en tus clientes actuales. Meta estima hasta una semana de trabajo de desarrollo para la actualización, incluidas las pruebas, y dice que en muchos casos la actualización toma solo unos minutos de configuración más el tiempo de pruebas.

La lista de verificación de migración sigue la página de v4 y el blog de Meta:

  1. Haz un inventario de tu código de inicio. Lee el objeto extras y lista cada featureType y cada nombre de función que uses. Todo lo que coincida con only_waba_sharing, marketing_messages_lite o coex necesita un cambio de desarrollo.
  2. Revisa tus dominios. Agrega los dominios permitidos en Facebook Login for Business, Settings, Client OAuth settings, como indica la página de implementación de Meta.
  3. Crea una configuración nueva. Ve a App Dashboard, Facebook Login for Business, Configurations, y selecciona Embedded Signup como variante de inicio de sesión.
  4. Selecciona los productos. Elige los productos que quieres incluir; seleccionar más de uno es opcional. Seleccionar productos te pasa automáticamente a v4.
  5. Reemplaza el objeto extras. Copia el ID de configuración en la llamada del Facebook Login SDK. La página de versiones de Meta muestra extras: {} para v4, y su página de implementación muestra extras: { setup: {} } en la llamada de inicio; ambos son textos vigentes de Meta, así que usa la llamada de inicio de la página de implementación como referencia de trabajo.
  6. Prueba el flujo. En el Embedded Signup Builder, selecciona la configuración nueva y abre el flujo. El blog de Meta dice “You don’t need to select a version, since the configuration now drives that logic.” Haz clic en Login with Facebook para ver v4 en vista previa e incluye los problemas comunes de la ventana emergente en los navegadores que usan tus clientes.

Los Measurement Partners necesitan una revisión aparte: la página de v3 de Meta afirma que “Measurement product onboarding will only be supported on v2 for the time being” y agrega que los Measurement Partners serán compatibles en una versión futura, sin indicar versión ni fecha, mientras que v2 llega a su fecha de descontinuación el 15 de octubre de 2026.

¿Cómo obtiene acceso a la API tu producto SaaS?

Un producto SaaS obtiene acceso a la WhatsApp API al convertirse en Tech Provider de Meta, o al trabajar con un Solution Partner, y luego hacer el onboarding de clientes empresariales mediante Embedded Signup. El camino de Tech Provider de Meta requiere una app de Meta con el caso de uso de WhatsApp y un portfolio comercial conectado, seguido de estos pasos:[12]

  • Verificación de la empresa: verifica tu empresa con Meta antes del App Review.
  • App Review: envía dos videos, uno que muestre un mensaje enviado desde tu app y recibido en WhatsApp y otro que muestre la creación de una plantilla de mensaje, el formato aprobado previamente para los mensajes que inicia la empresa, además de la documentación.
  • Acceso avanzado: el App Review otorga acceso avanzado a whatsapp_business_messaging y whatsapp_business_management, y Meta exige ambos para convertirse en Tech Provider.

Los Tech Providers pueden ofrecer mensajería de forma independiente o trabajar con un Solution Partner para ofrecer estos servicios en conjunto, en cuyo caso se necesita el ID de la app del partner. El servidor que aloja el flujo necesita un certificado SSL válido, y la descripción general de Meta indica que solo puedes hacer el onboarding de clientes empresariales cuando tu app tiene acceso avanzado a cada permiso que necesita. Meta también ofrece Hosted Embedded Signup, un enlace alojado por Meta desde el App Dashboard, como alternativa a alojar el código tú mismo.

Meta limita cuántos clientes empresariales nuevos puedes integrar:

EtapaClientes empresariales nuevos por periodo continuo de 7 días
Predeterminado10
Después de Business Verification, App Review y Access Verification200

Meta indica a los partners que necesitan más de 200 onboardings por semana que soliciten a Meta el estatus de partner. El changelog de Meta del 3 de octubre de 2025 afirma que la Access Verification ya no es obligatoria para convertirse en Tech Provider, aunque el texto de la descripción general todavía la incluye para el límite más alto.

Para las plataformas que se conectan mediante 360Dialog, Partner-Hosted Embedded Signup permite que los Tech Providers aprobados por Meta alojen un flujo personalizado. Requiere el estatus de Tech Provider con una solución en producción integrada con 360Dialog en el estatus ACTIVE de Meta, además de acceso avanzado al permiso public_profile.[13] 360Dialog recomienda Embedded Signup v4 en ese caso, porque así la Marketing Messages API se puede habilitar para el cliente durante el onboarding. 360Dialog se encarga por completo del registro del número de teléfono, así que los pasos de registro de Meta se omiten, y la resolución de problemas de scripts personalizados de Embedded Signup queda fuera del soporte técnico de 360Dialog. La relación entre los números integrados de esta forma y Meta Business Agent está en nuestra guía completa de Meta Business Agent, y qué guardar por tenant queda fuera del alcance de esta guía.

Una vez que la configuración está en producción, cada cliente nuevo pasa por la misma ventana emergente, los mismos eventos del listener y el mismo canje del token de empresa. Qué productos ofreces primero, y en qué orden los adoptan tus clientes, se vuelve una decisión de producto que la configuración ahora hace explícita.

Obtener acceso a la API para conectar a tu primer cliente con la configuración de v4 que armaste con esta guía.

Preguntas frecuentes

¿Qué es WhatsApp Embedded Signup?

WhatsApp Embedded Signup es una interfaz de autenticación y autorización que los clientes empresariales usan para generar los activos de WhatsApp que un partner necesita para integrarlos en la WhatsApp Business Platform. Una empresa SaaS lo agrega a su propio producto, donde un enlace o botón lo abre en una ventana nueva y da a la app de Meta de la empresa acceso a los activos que crea el flujo.

¿Puedo hacer el onboarding de empresas con Embedded Signup?

Sí, una empresa con estatus de Solution Partner o Tech Provider puede integrar clientes empresariales mediante Embedded Signup, siempre que su app de Meta tenga acceso avanzado a los permisos que requiere el flujo. Meta indica que una empresa solo puede integrar clientes cuando su app está aprobada para esos permisos, y el límite predeterminado es de 10 clientes empresariales nuevos en un periodo continuo de 7 días.

¿Cuándo se descontinúan Embedded Signup v2 y v3?

Meta descontinúa Embedded Signup v2 y v3, incluidas sus versiones de public preview, el 15 de octubre de 2026. La página de versiones de Meta todavía no anuncia una fecha de fin para v4 ni para la public preview de v4. Meta no indica una hora del día para la descontinuación.

¿Cómo compruebo qué versión de Embedded Signup uso?

El objeto extras de tu código de inicio de Embedded Signup muestra la versión. El valor version v3 identifica v3, el valor version v4-public-preview activa esa preview, y Meta no muestra un campo version para v2, donde aparece sessionInfoVersion en su lugar. Un flujo v4 se define al seleccionar productos en una configuración de Facebook Login for Business, así que su objeto extras está vacío o solo contiene setup.

¿Qué pasa con las integraciones que sigan en v2 o v3 después del 15 de octubre de 2026?

El blog para desarrolladores de Meta del 14 de mayo de 2026 afirma que la mayoría de las integraciones que sigan en v2 o v3 tras la fecha límite se actualizan a v4 automáticamente. Las integraciones que usan los tipos de función only_waba_sharing, marketing_messages_lite o coex con v2 no se actualizan automáticamente, y después del 15 de octubre de 2026 esas funciones dejan de funcionar y pasan al flujo estándar.

¿Embedded Signup es compatible con Coexistence?

Sí, Embedded Signup es compatible con Coexistence mediante el featureType whatsapp_business_app_onboarding, que permite que un cliente siga usando la app WhatsApp Business en un número que también funciona en Cloud API. Meta exige el registro de sesión para este flujo y muestra un solo fragmento de inicio para él, que combina el tipo de función con sessionInfoVersion definido en 3.

¿Cuánto tiempo toma migrar a v4?

Meta estima hasta una semana de trabajo de desarrollo para actualizar a v4, incluidas las pruebas. Meta agrega que en muchos casos la actualización toma solo unos minutos de configuración más el tiempo de pruebas. El trabajo se centra en crear una configuración nueva de Facebook Login for Business, seleccionar productos y reemplazar el objeto extras de tu código de inicio.

Fuentes

[1] Meta for Developers, Embedded Signup versions: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/versions

[2] Meta for Developers, Embedded Signup overview: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview

[3] Meta for Developers, WhatsApp Business Platform changelog: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog/

[4] 360Dialog Partner Docs, Integrated Onboarding: https://docs.360dialog.com/partner/onboarding/integrated-onboarding

[5] Meta for Developers, Embedded Signup version 4: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-4

[6] Meta for Developers, Embedded Signup version 4 public preview: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-4-public-preview

[7] Meta for Developers, Embedded Signup implementation: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/implementation

[8] Meta for Developers, Embedded Signup version 3: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-3

[9] Meta for Developers, Onboarding WhatsApp Business app users (Coexistence): https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users

[10] Meta for Developers, App-only install: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/app-only-install

[11] Meta for Developers blog, Embedded signup v4: Upgrade to Meta’s streamlined, unified onboarding experience before the deadline on October 15, 2026 (May 14, 2026): https://developers.facebook.com/blog/post/2026/05/14/embedded-signup-v4/

[12] Meta for Developers, Become a Tech Provider: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers

[13] 360Dialog Partner Docs, Partner-Hosted Embedded Signup: https://docs.360dialog.com/partner/onboarding/partner-hosted-embedded-signup