Solicitar datos de contacto es una acción de WhatsApp que le pide al usuario que comparta su número de teléfono dentro de la conversación. Con la llegada de los nombres de usuario (username) de WhatsApp, cada vez más personas pueden escribirle a tu negocio sin compartir su número: en esos casos la variable ${whatsappNumber} llega vacía y solo cuentas con el BSUID. Esta acción te permite solicitar ese dato cuando tu operación realmente lo necesita.

Puedes:

• Solicitar el número de teléfono a los usuarios que se contactan sin compartirlo.
• Insertar la acción en cualquier punto de tu flujo.
• Dejar que la acción se saltee automáticamente cuando el usuario ya compartió su número.
• Condicionar el pedido según la variable ${whatsappNumber} para no pedirlo de más.
• Ejecutar un camino específico ("Contacto compartido") la primera vez que el usuario comparte su número.

Antes de empezar, ten en cuenta que esta acción cobra sentido a medida que tus usuarios activan su username de WhatsApp y empiezan a contactarte sin compartir su número. Para entender el contexto completo de este cambio (BSUID, usernames y variables), te recomendamos leer primero el artículo relacionado que enlazamos al final.

Conceptos clave

Solicitar datos de contacto: acción de WhatsApp que envía al usuario un pedido para que comparta su número de teléfono dentro de la conversación.

${whatsappNumber}: variable que contiene el número de teléfono únicamente cuando el usuario lo compartió explícitamente. Si nunca lo compartió, permanece vacía.

BSUID (Business Scoped User ID): identificador único y anónimo que Meta genera para cada combinación de usuario y empresa cuando el usuario no comparte su número de teléfono.

Contacto compartido: evento que se ejecuta únicamente la primera vez que el usuario comparte su número, y que te permite definir un camino específico en el flujo.

Pedido no bloqueante: el flujo siempre continúa hacia abajo, comparta o no el usuario su número. La acción no frena ni bloquea la conversación.

Cómo solicitar el número de teléfono

Paso 1: Agrega la acción a tu flujo

En el editor de flujos, agrega una nueva acción y selecciona Acción → Canales → WhatsApp → Solicitar datos de contacto.

Puedes ubicar esta acción en cualquier punto del flujo donde necesites contar con el número de teléfono del usuario.

Paso 2: Entiende cómo se comporta la acción

La acción está diseñada para resolver el pedido por sí sola:

• Si el usuario ya compartió su número (la variable ${whatsappNumber} tiene valor), la acción se saltea y el flujo continúa hacia abajo sin pedir nada.
• Si el usuario no tiene número asociado, la acción le envía el mensaje para que comparta su contacto y el flujo continúa igual.

Por eso la acción tiene dos salidas y esa forma particular en el diagrama: una rama para cuando el número ya existe y otra para el momento en que el usuario lo comparte.

Paso 3 (opcional): Condiciona el pedido con la variable

Si quieres controlar con más precisión cuándo se pide el número, puedes anteponer una condición que evalúe la variable ${whatsappNumber}:

• Si la variable tiene valor, el usuario ya compartió su número y no hace falta volver a pedirlo.
• Si la variable está vacía, deriva el flujo hacia la acción Solicitar datos de contacto.

Nota: condicionar el pedido evita volver a solicitar el número a quien ya lo compartió. Sin la condición, la acción vuelve a mostrar el mensaje cada vez que el usuario retoma la conversación sin haber compartido su número.

Paso 4: Así lo ve el usuario en WhatsApp

Cuando la acción se ejecuta, el usuario recibe el pedido para compartir su contacto (por ejemplo, junto a un botón Compartir información de contacto) y la conversación queda a la espera de su respuesta.

Al tocar el botón, WhatsApp le muestra qué datos va a compartir (número de teléfono y username) antes de confirmar el envío.

Paso 5: Qué pasa cuando el usuario comparte (o no) su número

Cuando el usuario comparte el contacto, el número queda disponible en la variable ${whatsappNumber} y, solo la primera vez, el flujo ejecuta el camino Contacto compartido, donde puedes definir los pasos que quieras (por ejemplo, un mensaje de confirmación).

Si el usuario prefiere no compartir su número, el flujo continúa igual hacia abajo: el pedido no es bloqueante y no existe un botón de "prefiero no compartirlo". Por eso, cualquier parte de tu flujo que dependa del número de teléfono debe contemplar que una porción de los usuarios no lo compartirá, resolviéndolo con la condición del Paso 3.

Nota sobre pruebas: por el momento no hay una forma directa de probar este flujo desde tu cuenta. Para verlo funcionar necesitas contactarte por primera vez desde una línea de WhatsApp que tenga habilitado el username sin compartir el número de teléfono, algo que depende de que Meta habilite el rollout de usernames.

Para conocer el contexto completo de los nombres de usuario, el BSUID y las variables de WhatsApp, te compartimos el artículo "WhatsApp implementa nombres de usuarios y un nuevo identificador de cuentas (BSUID)".

Recuerda visitar nuestro Centro de Ayuda para mayor información