> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reserva tu nombre de usuario de WhatsApp Business

> Reserva tu nombre de usuario de WhatsApp Business en WhatsApp Manager antes que nadie: requisitos, pasos, reglas, errores e impacto en Flowella.

WhatsApp está introduciendo los **nombres de usuario**. En lugar de un número de teléfono, tu empresa obtiene un identificador como `@yourbrand` que los clientes pueden escribir en WhatsApp para iniciar una conversación. Las reservas de nombres de usuario de empresa se abrieron el **29 de junio de 2026** y la función se está activando país por país durante los meses siguientes. Los nombres de usuario se asignan por orden de llegada, así que esta página te guía para reservar el tuyo en la WhatsApp Business Platform ahora, aunque todavía no esté activo en tu país.

Esta guía solo cubre la vía de la **WhatsApp Business Platform**, que es la que usas si WhatsApp funciona a través de Flowella o de cualquier otro sistema en lugar de la app WhatsApp Business en un teléfono.

> [!NOTE]
>
> **Última verificación: 13 de septiembre de 2026**, con el Centro de ayuda de WhatsApp y la documentación para desarrolladores de Meta. Meta todavía lo está desplegando, así que consulta las [fuentes](#sources) si algo en pantalla no coincide.

## Por qué reservar ahora

* **Los nombres de usuario son únicos y se asignan por orden de llegada.** Cuando una cuenta de WhatsApp, de consumidor o de empresa, ocupa un identificador, nadie más puede usarlo.
* **Los identificadores coincidentes de Facebook e Instagram se guardan para sus propietarios, pero solo durante un tiempo limitado.** Meta reserva el nombre de usuario que ya usas en tu página de Facebook o tu cuenta de Instagram para que puedas reclamarlo en WhatsApp. WhatsApp indica que hay un plazo limitado para hacerlo y no ha publicado una fecha de fin. Pasado ese plazo, no hay garantía de que el identificador siga disponible.
* **No cuesta nada.** Reservar un nombre de usuario no tiene coste, y puedes cambiarlo o eliminarlo más adelante.
* **Protege tu marca aunque todavía no tengas planes con WhatsApp.** Un nombre de usuario reservado queda asociado a tu número de teléfono y nadie más puede reclamarlo.

## Qué hace un nombre de usuario de empresa y qué no hace

Un nombre de usuario de empresa es una forma de que los clientes te contacten **sin necesitar tu número de teléfono**. Una vez activo, los clientes que no tienen tu número guardado ven tu nombre de usuario en lugar de tu número en chats, grupos y llamadas.

Conviene tener claros sus límites:

* **No oculta el número de teléfono de tu empresa.** Tu número sigue apareciendo en tu perfil de empresa. La documentación de Meta deja claro que los nombres de usuario de empresa no son una función de privacidad; para eso están los nombres de usuario de consumidor.
* **No hay directorio.** Nadie puede explorar ni buscar tu empresa. Los clientes tienen que escribir tu nombre de usuario exacto, así que ponlo en tu web, tu señalización, las firmas de correo y tus perfiles sociales cuando esté activo.
* **Un nombre de usuario por número de teléfono.** Si tu WhatsApp Business Account tiene varios números, cada uno necesita su propio nombre de usuario.
* **Tu nombre de usuario es distinto de tu nombre visible.** El nombre visible sigue pasando por la revisión de Meta y sigue mostrándose a los clientes; consulta [Nombre visible y perfil](https://knowledge.flowella.io/es/whatsapp/accounts/profile-setup.md).

### Cómo se muestra tu nombre en un chat

Meta muestra la identidad de la empresa en este orden de prioridad. El cliente ve el primero que se aplique.

1. El nombre con el que el cliente te guardó en sus contactos
2. Tu nombre de empresa verificado o el nombre de tu Official Business Account
3. Tu nombre de usuario
4. Tu número de teléfono

Por tanto, una vez que Meta aprueba tu nombre visible, los clientes que no han guardado tu número ven ese nombre en lugar de tu nombre de usuario. Consulta [Nombres visibles](https://knowledge.flowella.io/es/whatsapp/accounts/display-names.md#how-meta-reviews-a-name).

## Antes de empezar

Necesitas tener todo lo siguiente. Si falta algo, sigue primero la [Secuencia de configuración](https://knowledge.flowella.io/es/whatsapp/accounts/setup-sequence.md).

**1. Una cartera de negocios de Meta con una WhatsApp Business Account**

El nombre de usuario se configura en un número de teléfono que pertenece a una WhatsApp Business Account (WABA) dentro de tu cartera. Consulta [Cartera de negocios](https://knowledge.flowella.io/es/whatsapp/accounts/business-portfolio.md) y [WhatsApp Business Account](https://knowledge.flowella.io/es/whatsapp/accounts/whatsapp-business-account.md).

**2. Un número de teléfono registrado en la Platform**

El número debe estar registrado para uso de la API en la WABA. Un número que se ha añadido pero aún no se ha registrado devuelve el error `133010` al intentar configurar un nombre de usuario. Consulta [Números de teléfono](https://knowledge.flowella.io/es/whatsapp/accounts/phone-numbers.md).

**3. Un límite de mensajes superior al nivel inicial**

Meta exige que la cartera de negocios tenga un **límite de mensajes superior** al que tiene toda cartera nueva al empezar (250 destinatarios únicos en un periodo móvil de 24 horas). Si no lo tiene, WhatsApp Manager muestra **Account not eligible** y la API devuelve el error `147002`. La forma más rápida de superarlo es completar la [verificación del negocio](https://knowledge.flowella.io/es/whatsapp/accounts/business-verification.md), tras la cual Meta puede subir el límite a 2.000. Enviar 2.000 mensajes de alta calidad a destinatarios únicos en 30 días también funciona, pero tarda más. Consulta [Límites de mensajes](https://knowledge.flowella.io/es/whatsapp/limits/messaging-limits.md).

**4. Los permisos adecuados**

Para configurar un nombre de usuario necesitas acceso de nivel administrador a la WABA o al número de teléfono. Si quieres reclamar un identificador que ya se usa en tu página de Facebook o tu cuenta de Instagram, también necesitas **control total** de esa página o cuenta, o **acceso parcial con el permiso de gestionar el teléfono**, porque Meta exige que primero vincules el número de teléfono a ella.

> [!TIP]
>
> Si no sabes en qué límite de mensajes estás, abre **WhatsApp Manager → Account tools → Messaging limits**. Cualquier valor superior a 250 es suficiente.

## Reserva tu nombre de usuario en WhatsApp Manager

Esta es la vía recomendada.

**1. Abre WhatsApp Manager**

Ve a [business.facebook.com/latest/whatsapp\_manager/phone\_numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers/) y, si se te pide, selecciona la cartera de negocios propietaria de tu WABA.

**2. Selecciona el número de teléfono**

En el menú de la izquierda, en **Account tools**, haz clic en **Phone numbers** y después en el número al que quieres dar un nombre de usuario. El panel de detalles del número se abre a la derecha.

**3. Abre la pestaña Profile**

En la parte superior del panel de detalles, haz clic en **Profile**. Desplázate más allá de **Profile picture** y **Display name** hasta la sección **Username**.

**4. Haz clic en Create (o Edit)**

Si el número todavía no tiene nombre de usuario, haz clic en **Create**. Si ya tiene uno, haz clic en **Edit**. Se abre el cuadro de diálogo **Edit username**.

**5. Elige una sugerencia o escribe el tuyo**

El cuadro de diálogo muestra una fila **Suggested**. Son los nombres de usuario que Meta ya ha reservado para tu empresa a partir de tu página de Facebook, tu cuenta de Instagram y el dominio de tu web, y tienen más probabilidades de aprobación. Haz clic en uno o escribe tu propio identificador en el campo. Una marca verde significa que está disponible; **This username is not available** significa que está ocupado o no supera las comprobaciones de Meta.

**6. Guarda**

Haz clic en **Save**. La sección Username muestra ahora **Current username: @yourhandle** con una insignia de estado y la fecha en que se actualizó.

> [!WARNING]
>
> Si elegiste un identificador que se usa en tu página de Facebook o tu cuenta de Instagram, Meta te pedirá que **vincules el número de teléfono** a esa página o cuenta antes de guardarlo. Puedes hacerlo desde el mismo cuadro de diálogo o añadiendo directamente el número de WhatsApp a la página o la cuenta de Instagram. Sin la vinculación, la solicitud falla con el error `147003` (Facebook) o `147004` (Instagram).

### Qué significa la insignia de estado

| Insignia | Significado |
| - | - |
| **Reserved** | Aprobado y reservado para tu número de teléfono, pero todavía no visible para los usuarios de WhatsApp. Pasa a activo por sí solo cuando Meta habilita los nombres de usuario en tu país. Mientras tanto, nadie puede reclamarlo. |
| **Approved** | Activo y visible. Los clientes que no tienen tu número guardado ven el nombre de usuario y pueden iniciar un chat escribiéndolo. |

WhatsApp envía una notificación cuando un nombre de usuario reservado pasa a estar activo. No tienes que hacer nada.

## Otras formas de reservar

> [accordion] Meta Business Suite
>
> Ve a **Settings → Accounts → WhatsApp accounts**, abre la pestaña **Phone numbers**, haz clic en el número, desplázate hasta **Username** y haz clic en **Create**. Es el mismo cuadro de diálogo que en WhatsApp Manager.

> [accordion] Username API
>
> Para desarrolladores y proveedores de soluciones, Meta expone el nombre de usuario en el número de teléfono de la empresa. El token de acceso necesita el permiso `whatsapp_business_management` con Full control o Partial access a los números de teléfono de la WABA.
>
> Configurar o cambiar un nombre de usuario:
>
> ```bash theme={null}
> curl -X POST "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username" \
>   -H "Content-Type: application/json" \
>   -H "Authorization: Bearer <ACCESS_TOKEN>" \
>   -d '{ "username": "yourbrand" }'
> ```
>
> Una respuesta correcta devuelve `{ "status": "reserved" }` o `{ "status": "approved" }`.
>
> Listar los nombres de usuario que Meta ha reservado para tu cartera:
>
> ```bash theme={null}
> curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username_suggestions" \
>   -H "Authorization: Bearer <ACCESS_TOKEN>"
> ```
>
> Consulta el nombre de usuario actual y su estado con `GET .../username` y elimínalo con `DELETE .../username`. Tienes la referencia completa en la documentación de Meta sobre [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/).

## Reglas del nombre de usuario

* Entre 3 y 35 caracteres
* Solo letras inglesas (a a z), dígitos (0 a 9), puntos (.) y guiones bajos (\_); se rechazan los caracteres acentuados como ñ, é o ü
* Al menos una letra; un nombre de usuario no puede tener solo números
* Sin punto al principio ni al final, y sin dos puntos seguidos
* No puede empezar por `www.`
* No puede terminar con una extensión de dominio de la lista, como `.com`, `.org`, `.net`, `.edu`, `.gov` o `.html`
* Las mayúsculas se ignoran al comprobar la unicidad, pero los puntos y guiones bajos no: `myid`, `my.id` y `my_id` son tres nombres de usuario distintos
* Meta reserva algunos nombres de usuario para empresas, gobiernos y figuras públicas, y no se pueden reclamar

## Errores que puedes ver

| Error | Qué significa | Qué hacer |
| - | - | - |
| **Account not eligible** / `147002` | La cartera de negocios sigue en el límite de mensajes inicial. | Completa la [verificación del negocio](https://knowledge.flowella.io/es/whatsapp/accounts/business-verification.md), o espera a haber superado los 250 por volumen de envíos, y vuelve a intentarlo. |
| **This username is not available** / `147001` | El identificador está ocupado, no supera las comprobaciones internas de Meta o está reservado para otra persona. | Elige otro identificador. Si es tu marca registrada y otra persona lo tiene, consulta las [preguntas frecuentes](#faq) más abajo. |
| **FB account not linked** / `147003` | El identificador se usa en una página de Facebook que no has vinculado a este número de teléfono. | Vincula el número de teléfono a la página (control total, o acceso parcial con gestión del teléfono) y vuelve a intentarlo. |
| **IG account not linked** / `147004` | El identificador se usa en una cuenta de Instagram que no has vinculado a este número de teléfono. | Vincula el número de teléfono a la cuenta de Instagram y vuelve a intentarlo. |
| **Username transfer required** / `147005` | El identificador ya está en otro número de teléfono de tu cartera. | Muévelo: en la API, vuelve a enviar con `"transfer_action": "force_transfer"`. |
| **Account not registered** / `133010` | El número de teléfono no se ha registrado para uso de la API. | Termina de registrar el número en la WABA y vuelve a intentarlo. |
| `100` Param invalid | El identificador incumple las reglas de formato. | Revisa las [reglas](#username-rules) anteriores. |

## Cambiar, mover o eliminar un nombre de usuario

* Puedes **cambiar** tu nombre de usuario desde el mismo cuadro de diálogo Edit. Hay un límite de veces que puedes cambiarlo y, cuando liberas un identificador, puede quedar disponible para que otros lo reclamen.
* En la Platform, un nombre de usuario se puede **transferir entre números de teléfono de la misma cartera de negocios**, por ejemplo de un número de prueba a uno de producción, o al consolidar números. El identificador en sí no cambia.
* **Delete** elimina el nombre de usuario del número. Hazlo solo si estás seguro; el identificador vuelve a quedar disponible.

## Cuando los clientes ocultan sus números

Los nombres de usuario de consumidor son una función de privacidad. Cuando un cliente adopta uno, su número de teléfono **queda oculto para cualquiera que no lo haya guardado ya**, incluidas las empresas. Esta es la parte del despliegue que importa para todo lo que esté conectado a un CRM.

La respuesta de Meta es el **business-scoped user ID (BSUID)**, un identificador estable para cada cliente que es exclusivo de tu empresa. Desde abril de 2026 aparece en todos los webhooks entrantes. Para un cliente con nombre de usuario, Meta incluye también el número de teléfono solo cuando se cumple una de estas condiciones: ese número de empresa ha intercambiado un mensaje o una llamada con el cliente en los últimos 30 días, el cliente está en tu libreta de contactos de Meta o el cliente ha compartido sus datos de contacto. En caso contrario, Meta envía solo el BSUID. Meta también ofrece un botón **Request contact info** que pide al cliente que comparta su número en el chat, pero el editor de plantillas de Flowella no ofrece este botón.

Qué significa esto en Flowella:

* **Flowella identifica cada contacto por su número de teléfono.** Si Meta envía el mensaje de un cliente sin su número de teléfono, Flowella no puede asociarlo a un contacto, y el mensaje no aparece en Flowella ni llega a HubSpot.
* **Las conversaciones en curso siguen funcionando.** Meta incluye el número de los clientes que han enviado un mensaje a ese número de empresa, o han recibido de él un mensaje o una llamada, en los últimos 30 días.
* **Pide el número cuando lo necesites.** Cuando un proceso dependa del número, como un envío o una devolución de llamada, pídelo en la conversación en lugar de dar por hecho que llega con cada mensaje.

Para conocer cada identificador, cuándo incluye Meta el número de teléfono y cómo funciona la agenda de contactos, consulta [Identificadores de usuario](https://knowledge.flowella.io/es/whatsapp/messaging/user-identifiers.md).

## Preguntas frecuentes

> [accordion] Alguien ha registrado mi marca como nombre de usuario. ¿Qué puedo hacer?
>
> Meta ofrece dos vías. Para la suplantación de identidad, usa el canal **Report Abuse** de Meta Direct Support. Para la infracción de marca registrada, usa el formulario de contacto de propiedad intelectual de WhatsApp. Tener tu página de Facebook y tu cuenta de Instagram vinculadas al número, y la verificación del negocio completada, refuerza tu caso.

> [accordion] ¿Necesito la insignia azul (Official Business Account) para obtener un nombre de usuario?
>
> No. La insignia de Official Business Account es una solicitud aparte en la misma pestaña Profile y no es obligatoria. Los nombres de usuario requieren la condición del límite de mensajes indicada arriba, no la insignia azul.

> [accordion] Tengo Meta Verified con una dirección web personalizada. ¿Tengo que hacer algo?
>
> WhatsApp indica que, para las empresas con Meta Verified que tienen una dirección de página web personalizada, el nombre de usuario de empresa coincide automáticamente con esa dirección y ya está reservado. Revisa la sección Username en WhatsApp Manager para confirmarlo.

> [accordion] Uso la app WhatsApp Business en un teléfono, no la Platform
>
> Esta página no cubre la app. En la app, los nombres de usuario se reservan desde tu perfil de empresa en el teléfono (no en WhatsApp Web) y no se necesita la verificación del negocio. Si usas la app y Flowella a la vez, consulta [Coexistencia](https://knowledge.flowella.io/es/whatsapp/accounts/co-existence.md).

> [accordion] ¿Funcionará mi nombre de usuario en los puntos de entrada de Flowella y en los enlaces click-to-chat?
>
> Sí. Los enlaces con seguimiento y los códigos QR de Flowella (puntos de entrada, en acceso anticipado) abren un chat con el número de teléfono de tu empresa, así que un nombre de usuario no los cambia. Cuando tu nombre de usuario esté activo, también puedes compartirlo en cualquier lugar donde compartas tu número. Consulta [Puntos de entrada](https://knowledge.flowella.io/es/app/entry-points.md) y [Click-to-chat](https://knowledge.flowella.io/es/campaigns/click-to-chat.md).

## Fuentes

* Centro de ayuda de WhatsApp: [About usernames on WhatsApp Business](https://faq.whatsapp.com/1131753190029163/)
* Centro de ayuda de WhatsApp: *About username reservations on WhatsApp Business*, enlazado desde el artículo anterior
* Meta for Developers: [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) (nombres de usuario reservados, Username API, códigos de error, reglas de formato, prioridad de visualización)
* Meta for Developers: [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)

## Relacionado

> [card] [Verificación del negocio](https://knowledge.flowella.io/es/whatsapp/accounts/business-verification.md)
>
> La forma más rápida de superar "Account not eligible".

> [card] [Límites de mensajes](https://knowledge.flowella.io/es/whatsapp/limits/messaging-limits.md)
>
> Cómo funciona el nivel inicial y cómo superarlo.

> [card] [Nombre visible y perfil](https://knowledge.flowella.io/es/whatsapp/accounts/profile-setup.md)
>
> El nombre que los clientes ven por encima de tu nombre de usuario.

> [card] [Secuencia de configuración](https://knowledge.flowella.io/es/whatsapp/accounts/setup-sequence.md)
>
> Todo lo que tiene que estar listo antes de este paso.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.