## Visión general

WhatsApp está lanzando **nombres de usuario** a lo largo de 2026. Un cliente que adopta un nombre de
usuario puede **ocultar su número de teléfono**. En ese caso, la conversación llega identificada solo por
un **ID comercial** (BSUID, el ID de alcance comercial, por ejemplo `BR.123…`) y el nombre de usuario, sin
número. En WhatsApp Web, el equivalente es un identificador `@lid`.

La **solicitud de teléfono** es el camino **oficial** para que el cliente comparta su número contigo:

- El cliente recibe un mensaje con un **botón nativo de WhatsApp** para compartir su contacto.
- Si toca el botón, el número llega a la conversación como **"Teléfono compartido"** y se guarda en el
  contacto.
- A partir de ese momento, la plataforma envía al teléfono, como recomienda Meta.

El cliente siempre decide si lo comparte. Si rechaza o ignora la solicitud, no pasa nada: la conversación
continúa por el ID comercial.

## Requisitos previos

- Una conversación **individual** en una bandeja de entrada de WhatsApp. Los grupos, comunidades y canales
  no aceptan la solicitud.
- Permiso para responder en la conversación.
- Para pedirlo con la **ventana de 24 horas cerrada**: una **plantilla aprobada** de la categoría
  **Utilidad** o **Marketing** que tenga el botón **Compartir contacto**.
- En una bandeja **solo de WhatsApp Web**: el servicio de WhatsApp Web (gateway) actualizado por el
  operador de la plataforma. Consulta la tabla en **Configuración y opciones**.

## Paso a paso

### Con la ventana de 24 horas abierta

1. Abre la conversación individual de WhatsApp.
2. En el compositor, haz clic en **Pedir teléfono**. Cuando el teléfono del contacto es desconocido, el
   botón aparece destacado.
3. En la pestaña **Mensaje**, revisa el texto que el cliente lee encima del botón. Es editable y admite
   hasta **1024 caracteres**. Explica para qué se usará el número.
4. Haz clic en **Enviar solicitud**. El cliente recibe el texto con el botón para compartir su contacto.

### Con la ventana de 24 horas cerrada

1. En el compositor, haz clic en **Pedir teléfono**.
2. En la pestaña **Plantilla aprobada**, elige una plantilla de la categoría **Utilidad** o **Marketing**
   que tenga el botón **Compartir contacto**. El botón no lleva parámetros en el envío.
3. Haz clic en **Usar plantilla**. El compositor de plantillas de WhatsApp se abre con la plantilla ya
   elegida.
4. Completa las variables, si las hay, revisa la vista previa y el costo, y haz clic en **Enviar**.

Si no hay ninguna plantilla aprobada con ese botón, el diálogo explica cómo crear una en
**Configuración → Bandejas de entrada → (tu bandeja de WhatsApp) → Plantillas**.

### Cuando el cliente comparte

- El número aparece en la conversación como **"Teléfono compartido"** y se guarda en el contacto.
- Los siguientes envíos usan el teléfono.
- Si el cliente comparte la tarjeta de **otra persona**, sigue siendo una tarjeta de contacto común y
  **no cambia** el contacto de la conversación.
- En **WhatsApp Web**, el cliente responde enviando **su propia tarjeta de contacto**. La plataforma solo
  guarda el número cuando WhatsApp comprueba que la tarjeta es del propio cliente, en una conversación
  individual. Como WhatsApp Web no vincula la respuesta con la solicitud, también se acepta la tarjeta propia
  enviada sin solicitud.
- Si el número **ya pertenece a otro contacto**, la plataforma **no fusiona los contactos por su cuenta**.
  La burbuja te avisa y ofrece **Abrir contacto**, para que uses el flujo de fusión que ya existe.
- Si el contacto ya tenía **otro teléfono guardado**, la burbuja te avisa y ofrece **Revisar contacto**,
  para que confirmes qué número debe quedar en el contacto.
- En un aviso de conflicto, la burbuja también ofrece **Descartar aviso**. Marca el conflicto como revisado
  sin fusionar nada, y la burbuja pasa a mostrar **Aviso descartado**. Quien decide es el agente: la
  plataforma nunca fusiona los contactos por su cuenta.

## Configuración y opciones

### Dónde aparece el botón

- En el compositor de una conversación individual de WhatsApp, con el nombre **Pedir teléfono**.
- Destacado cuando el teléfono del contacto es desconocido.
- En grupos, comunidades, canales, bandejas sin soporte o para quien no puede responder, el botón no
  aparece o queda deshabilitado, con el motivo.
- La etiqueta del botón que ve el cliente es **fija** y aparece en el idioma de su app. No se puede
  personalizar.

### Por tipo de bandeja de entrada

| Bandeja de entrada | Cómo se envía la solicitud |
|---|---|
| WhatsApp oficial (Cloud) y coexistencia | Por WhatsApp oficial. |
| Bandeja híbrida (oficial + WhatsApp Web, unificada o no) | En una conversación de la bandeja oficial, siempre por el canal oficial. La solicitud nunca se repite por WhatsApp Web. |
| Solo WhatsApp Web | Depende de una actualización del servicio de WhatsApp Web (gateway). La plataforma revisa sola el gateway de cada bandeja: mientras no esté actualizado, **Pedir teléfono** queda deshabilitado y la ayuda del botón explica el motivo ("verificando" mientras la plataforma todavía no confirmó el gateway); cuando el operador lo actualice, el botón vuelve a funcionar solo en aproximadamente una hora. La respuesta del cliente llega como su propia tarjeta de contacto y se guarda en el contacto de la misma forma. |

### Flujos (Flow Builder)

El nodo de mensaje tiene el tipo **Solicitar contacto**, que hace la misma solicitud de teléfono en
WhatsApp oficial.

### Libreta de contactos de Meta

La **libreta de contactos** (*contact book*) es un recurso de Meta, por **portafolio comercial**, que
guarda el teléfono de quienes interactuaron con el número y lo usa para completar los webhooks siguientes.

- Un teléfono compartido con el botón se agrega a ella automáticamente.
- Solo registra interacciones a partir del lanzamiento del recurso.
- Se puede desactivar en **Meta Business Suite → Configuración del negocio → Información del negocio**.
  Desactivar la libreta **borra su contenido**.

## Casos de uso

- Confirmar una entrega o una cita con un cliente que aparece solo por su nombre de usuario.
- Pedir el teléfono después de que la ventana de 24 horas se cerró, con una plantilla aprobada que tenga
  el botón **Compartir contacto**.
- Pedir el teléfono dentro de un flujo automatizado, con el tipo **Solicitar contacto**.

## Consejos, límites y buenas prácticas

- Pide el teléfono **solo cuando haya un motivo** y explica en el texto para qué se usará el número.
- Si el cliente rechaza o ignora la solicitud, **no insistas de forma seguida**. La conversación continúa
  por el ID comercial, y Meta puede aplicar límites de calidad a los mensajes no deseados.
- El texto libre admite hasta **1024 caracteres**.
- Las plantillas de **Autenticación** no aceptan el botón **Compartir contacto**, y una plantilla solo
  puede tener **un** botón de ese tipo.
- La etiqueta del botón la define WhatsApp y no se puede personalizar.

### Privacidad y LGPD

- El cliente decide si comparte su número.
- El teléfono compartido pasa a ser un **dato personal** del contacto y queda enmascarado en el
  **Modo Presentación**.
- Para solicitudes de eliminación de datos, usa el proceso de privacidad de la plataforma.

## Solución de problemas

Ningún fallo reenvía la solicitud de teléfono por sí solo. Así, el cliente nunca recibe la misma
solicitud dos veces. Inténtalo de nuevo cuando el mensaje diga que no llegó nada al contacto.

- **"La solicitud de teléfono no se envió porque la ventana de atención de 24 horas de WhatsApp está
  cerrada."**: envía una plantilla aprobada de **Utilidad** o **Marketing** con el botón
  **Compartir contacto**.
- **"La solicitud de teléfono no se envió porque no tiene texto."** o **"…porque el texto supera los 1024
  caracteres."**: escribe el texto que el cliente lee encima del botón, con hasta 1024 caracteres.
- **"Meta no acepta este tipo de mensaje para un contacto conocido solo por su nombre de usuario de
  WhatsApp…"** (código 131062): ocurre con las plantillas de **Autenticación**. Pide el teléfono antes de
  enviar ese tipo de plantilla.
- **"Esta bandeja de WhatsApp Web todavía no puede pedir el teléfono…"**: el servicio de WhatsApp Web de la
  bandeja necesita una actualización. Pide al operador de la plataforma que actualice el gateway o envía la
  solicitud por el canal oficial de WhatsApp.
- **"La sesión de WhatsApp Web de esta bandeja está desconectada, así que la solicitud de teléfono no se
  envió."**: reconecta la bandeja e inténtalo de nuevo.
- **"El servicio de WhatsApp Web rechazó esta solicitud de teléfono, así que no se envió nada."**:
  inténtalo de nuevo. Si sigue fallando, contacta al operador de la plataforma.
- **"WhatsApp Web no pudo usar el teléfono de este contacto."**: revisa el número guardado en el contacto e
  inténtalo de nuevo.
- **"WhatsApp no envió la solicitud de teléfono. No llegó nada al contacto, así que puedes intentarlo de
  nuevo."**: envía la solicitud otra vez.
- **"WhatsApp no confirmó si la solicitud de teléfono llegó al contacto."**: la solicitud no se reenvía
  automáticamente, para que el contacto nunca la reciba dos veces. Antes de pedirlo de nuevo, ten en
  cuenta que el cliente puede haberla recibido ya.
- **No hay ninguna plantilla con el botón para elegir**: crea una en
  **Configuración → Bandejas de entrada → (tu bandeja de WhatsApp) → Plantillas**, en la categoría
  **Utilidad** o **Marketing**, y espera la aprobación de Meta.
- **El cliente compartió, pero el número ya pertenece a otro contacto**: la burbuja muestra el aviso y
  ofrece **Abrir contacto**, para usar el flujo de fusión de contactos, y **Descartar aviso**, para marcar
  el conflicto como revisado sin fusionar nada. Una vez descartado, la burbuja muestra
  **Aviso descartado**. Quien decide es el agente: la plataforma nunca fusiona los contactos por su
  cuenta.
- **El contacto ya tenía otro teléfono guardado**: la burbuja muestra el aviso y ofrece
  **Revisar contacto**. Confirma qué número debe quedar en el contacto.
- **El botón Pedir teléfono está deshabilitado**: revisa el motivo que se muestra. La solicitud no aplica a
  grupos, comunidades, canales, bandejas sin soporte ni a quien no puede responder en la conversación.

## Ver también

- [Bandeja híbrida de WhatsApp: Coexistencia (Cloud) + WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-hybrid-inbox-es)
- [WhatsApp Inbox Suite: Plantillas, Flows y Llamadas](/hc/ajuda/articles/inboxes-channels-whatsapp-inbox-suite-es)
- [Coexistence de WhatsApp Cloud](/hc/ajuda/articles/inboxes-channels-whatsapp-coexistence-es)
- [Flow Builder](/hc/ajuda/articles/automation-flows-flow-builder-es)
- [Modo Presentación](/hc/ajuda/articles/administration-modo-apresentacao-es)