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
- Abre la conversación individual de WhatsApp.
- En el compositor, haz clic en Pedir teléfono. Cuando el teléfono del contacto es desconocido, el botón aparece destacado.
- 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.
- 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
- En el compositor, haz clic en Pedir teléfono.
- 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.
- Haz clic en Usar plantilla. El compositor de plantillas de WhatsApp se abre con la plantilla ya elegida.
- 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.