Si das de alta clientes en la API de WhatsApp con Embedded Signup, el popup de Meta donde tu cliente conecta su número y su cuenta, ese flujo acaba de ganar una pantalla. El 11 de noviembre de 2026, Meta anunció en el changelog de la plataforma que agregó una pantalla de nombre visible (display name) a las versiones v4-public-preview y v5-public-preview para todos los clientes empresariales. Ahí el cliente escribe el nombre que verán los usuarios de WhatsApp en lugar del número del negocio. Hoy solo aparece en las versiones de vista previa, pero Meta ya avisó que llegará a v4 y v5 "más adelante", sin fecha, y pide probar tu integración contra las versiones preview desde ya. Traducción: si tu onboarding asume que el popup tiene X pasos, o le pone el nombre al número por su cuenta después, hoy es el día de revisarlo, no el día que la pantalla aparezca en producción y te llenen el soporte.
Qué anunció Meta, al pie de la letra
La entrada del changelog es corta. Según Meta:
- La pantalla de nombre visible se agregó a
v4-public-previewyv5-public-previewpara todos los clientes empresariales. - Aparece después de que el cliente selecciona o crea sus activos de negocio (portafolio y cuenta de WhatsApp).
- En esa pantalla el cliente escribe el nombre visible de su número de negocio.
- La pantalla se irá desplegando a v4 y v5 después, así que Meta recomienda "probar tu integración contra las versiones public preview ahora".
La página de v4-public-preview, actualizada el mismo 11 de noviembre, lo dice más claro: esa versión "siempre muestra" la pantalla, y conviene probar contra ella "para que la pantalla no rompa" tu integración cuando llegue a v4.
Cómo funciona la pantalla
La documentación de la pantalla de nombre visible da varios detalles que importan si tú armas el onboarding:
- Pide el nombre que los usuarios de WhatsApp ven en lugar del número del negocio. Embedded Signup agrega el número con el nombre que el cliente escribe ahí.
- El nombre se valida contra las guías de nombres visibles mientras el cliente escribe. El botón Next se queda deshabilitado hasta que el nombre pasa.
- Pasar esa validación no es la aprobación final: Meta sigue revisando el nombre después de que termina el flujo.
- Si el cliente elige un número que ya existía y cuyo nombre no está aprobado, puede escribir uno nuevo en esta pantalla.
- Embedded Signup se salta la pantalla en tres casos: números que ya tienen un nombre aprobado, migraciones de número y el onboarding de usuarios de la app WhatsApp Business (el flujo de Coexistence).

En el flujo de número empresarial que describe Meta, el orden queda así: autorización, alta del número, verificación por SMS o llamada, selección o creación de activos, nombre visible, revisión de permisos y pantalla de éxito. Al darle Finish, el popup manda el evento con los IDs que usas para terminar de dar de alta al cliente, igual que antes.
Dónde está cada versión
Para ubicar el cambio, vale la pena recordar el mapa de versiones que mantiene Meta en su página de versiones:
| Versión | Desde | Pantalla de nombre visible |
|---|---|---|
v5-public-preview |
20 de octubre de 2026 | Sí, desde el 11 de noviembre |
v5 |
20 de octubre de 2026 | Todavía no; llegará después |
v4-public-preview |
12 de mayo de 2026 | Sí, desde el 11 de noviembre |
v4 |
8 de octubre de 2025 | Todavía no; llegará después |
v2 y v3 (y sus preview) se deprecaron el 15 de octubre de 2026; las peticiones que todavía las piden, o que no mandan versión, se sirven como v4. Las versiones public preview son la misma versión con la interfaz nueva. Para probar basta con cambiar el version dentro de extras, por ejemplo version: "v5-public-preview". Según la documentación de v5, esa versión trae además el onboarding de la app WhatsApp Business encendido por defecto y un objeto de sesión distinto (versión 5), con messaging_account_ids en lugar de waba_id. Si vas a migrar de v4 a v5, ese es otro cambio que tu código tiene que absorber, aparte de esta pantalla.
Qué puede romperse en tu integración
Lo que sigue es mi lectura, no algo que Meta haya enumerado. No lo probé; sale de la documentación oficial de Embedded Signup.
1. Asumir que el nombre lo pones tú después. Muchos BSP y agencias dejan que el cliente termine el popup y luego, desde su panel, le ponen el nombre al número por API (new_display_name) o en WhatsApp Manager. Con la pantalla nueva, el nombre ya viene desde el flujo. Si tu panel pide el nombre otra vez, tu cliente lo va a escribir dos veces, y si escribe algo distinto, ahora tienes dos versiones del mismo nombre. La página de nombres visibles recuerda que un nombre se puede cambiar 10 veces cada 30 días y que, cuando se aprueba un cambio, hay que volver a registrar el número (POST /<PHONE_NUMBER_ID>/register) dentro de 14 días para que se aplique. Duplicar ese paso sin necesidad gasta intentos y te agrega una vuelta de revisión.
2. Tutoriales y capturas desactualizados. Si tu documentación, tu video de onboarding o el guion de tu equipo de soporte dice "después de elegir la cuenta de WhatsApp sigue la pantalla de permisos", eso deja de ser cierto. Es lo más fácil de arreglar y lo que más tickets genera si no lo arreglas.
3. Clientes que se quedan atorados. El botón Next no se habilita hasta que el nombre cumple las guías. Las guías de Meta piden, entre otras cosas, que el nombre represente de verdad al negocio, que no sea un término genérico ("Fashion" no pasa) ni una ubicación genérica ("New York" tampoco), y que tenga relación clara con el nombre legal o la marca del negocio. Un cliente que intente poner "Ventas" o "Soporte" a secas se va a quedar viendo un botón gris. Si tu onboarding es asistido, conviene explicarle esto antes de abrir el popup.
4. Datos prellenados. La guía de datos precargados ya permite mandar setup.phone.displayName al abrir Embedded Signup. La documentación de la pantalla nueva no dice si ese valor la llena o la omite, así que es justo lo que tienes que confirmar en preview antes de que la pantalla llegue a v4.
5. Métricas de abandono. Si mides en qué paso abandonan tus clientes el popup (según la guía de implementación, el evento CANCEL trae current_step con la pantalla en la que el cliente abandonó), vas a ver un paso nuevo. No lo confundas con un problema de tu lado.
Lo que todavía no se sabe
- Fecha de llegada a v4 y v5: Meta solo dice "más adelante".
- Si el despliegue será gradual por app o por cliente, o de golpe.
- Si
setup.phone.displayNameprecargado prellena o salta la pantalla. - Si la validación en vivo usa exactamente los mismos criterios que la revisión posterior. Meta deja claro que la revisión sigue existiendo, así que pasar la pantalla no garantiza la aprobación.
Qué haría yo esta semana
Mi recomendación, con lo que hay publicado: abre tu flujo de alta con version: "v4-public-preview" (o v5-public-preview si ya estás en v5) en un entorno de pruebas y recórrelo con un número nuevo, uno ya existente con nombre aprobado y uno sin aprobar. Comprueba que tu message listener siga recibiendo el evento de fin igual, que tu panel no vuelva a pedir el nombre y que tu documentación muestre la pantalla nueva. Es media hora de trabajo que te ahorra el día en que Meta la prenda en v4 sin avisar con fecha.
Fuentes
- Changelog de WhatsApp Business Platform, 11 de noviembre de 2026 (Meta)
- Embedded Signup: Version 4 Public Preview, pantalla de nombre visible (Meta)
- Embedded Signup: Version 5 Public Preview (Meta)
- Embedded Signup: Version 5 (Meta)
- Embedded Signup: versiones disponibles (Meta)
- Display names: verificación, cambios y re-registro (Meta)
- Display name guidelines for the WhatsApp Business Platform (Meta Business Help Center)
- Embedded Signup: datos precargados (Meta)
- Embedded Signup: implementación y eventos de sesión (Meta)