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

# Solicitar contacto

> Pide al usuario que comparta su información de contacto, espera su respuesta y, si lo necesitas, exige el número de teléfono antes de continuar

El nodo **Solicitar contacto** envía un mensaje con el botón **Compartir info. de contacto** para que el usuario comparta su tarjeta de contacto desde WhatsApp. Úsalo para recuperar el número de teléfono de usuarios que llegan identificados solo por su nombre de usuario o BSUID, y para frenar el flujo hasta tenerlo.

## Configuración

### General

| Campo | Descripción | Límite |
| :- | :- | :- |
| **Mensaje** | Texto que acompaña al botón y explica por qué necesitas los datos del usuario | 1,024 caracteres |

El texto del botón es fijo: **Compartir info. de contacto**.

### Avanzado

<Frame caption="Pestaña Avanzado del nodo Solicitar contacto">
  <img src="https://mintcdn.com/jelouai/ULgwEHLikEppkuDq/assets/images/solicitud-contacto-avanzado_es.png?fit=max&auto=format&n=ULgwEHLikEppkuDq&q=85&s=9723c654539825ded24a1424d4efb571" alt="Pestaña Avanzado con Selección obligatoria activada y la opción Número de teléfono seleccionada" width="735" height="547" data-path="assets/images/solicitud-contacto-avanzado_es.png" />
</Frame>

| Campo | Descripción |
| :- | :- |
| **Selección obligatoria** | En los dos casos el flujo espera a que el usuario comparta su contacto. Cuando está activada, el usuario debe responder con el botón y cualquier otro mensaje recibe el **Mensaje de reintento**. Si está desactivada, el usuario puede escribir otra cosa y el router del proyecto lo atiende. Consulta [Sin selección obligatoria](#sin-selección-obligatoria). |
| **¿Qué debe compartir el usuario?** | Define qué respuesta desbloquea el flujo. Solo aparece con **Selección obligatoria** activada. |
| **Mensaje de reintento** | Texto que recibe el usuario cuando su respuesta no cumple el requisito. Si lo dejas vacío, se envía: *Por favor, comparte tu información de contacto usando el botón para continuar.* Solo aparece con **Selección obligatoria** activada. |

## Qué debe compartir el usuario

WhatsApp deja que el usuario elija qué datos de su tarjeta comparte, y el botón no permite restringirlo. Por eso la exigencia la aplica el nodo, con dos opciones excluyentes:

| Opción | El flujo continúa cuando | Si el usuario comparte solo su nombre de usuario |
| :- | :- | :- |
| **Número de teléfono** (por defecto) | La respuesta trae un número de teléfono | Recibe el **Mensaje de reintento** y el nodo sigue esperando |
| **Nombre de usuario** | El usuario comparte su contacto, con o sin número | El flujo continúa |

En las dos opciones, si el usuario responde con texto libre en lugar de tocar el botón, recibe el **Mensaje de reintento**. Una tarjeta de contacto enviada desde el menú de adjuntos tampoco desbloquea el nodo: el usuario debe usar el botón.

<Note>
  Los nodos que ya tenían **Selección obligatoria** activada se comportan como **Número de teléfono** sin que tengas que reconfigurarlos ni volver a publicar.
</Note>

## Sin selección obligatoria

Con **Selección obligatoria** desactivada, el nodo se comporta como **Botones** o **Lista** sin selección obligatoria: envía el mensaje y espera la tarjeta de contacto, pero no retiene al usuario. El flujo sigue por la salida del nodo solo cuando llega el contacto, así que los nodos siguientes ya pueden usar lo que compartió.

| Si el usuario… | Qué pasa |
| :- | :- |
| Comparte su contacto con el botón, con o sin número | El flujo continúa por la salida del nodo. Si la tarjeta trae número, queda disponible como `{{$user.phone}}` |
| Escribe cualquier otro mensaje | El router del proyecto atiende el mensaje y puede iniciar otro workflow. Este flujo sigue esperando el contacto |
| Comparte el contacto después de haber entrado en otro workflow | Se retoma el flujo que pidió el contacto, igual que al tocar un botón de un mensaje anterior |
| No responde | El flujo sigue esperando. No hay salida por expiración, y pasadas 24 horas el contacto ya no retoma el flujo |

Si el nodo no tiene nada conectado a su salida, el flujo termina ahí, igual que antes. Una tarjeta enviada desde el menú de adjuntos no retoma el flujo: el usuario debe usar el botón.

## Uso del número capturado

Con o sin **Selección obligatoria**, cuando el usuario comparte su número a través del botón y aún no tenía uno registrado, el número queda asociado al usuario y está disponible en los nodos siguientes de la misma ejecución:

```
Gracias, registramos tu número {{$user.phone}}
```

## Casos de uso

<AccordionGroup>
  <Accordion title="Onboarding bancario con usuarios BSUID">
    Un workflow de banca que recibe usuarios identificados solo por BSUID necesita el teléfono para validar su identidad: **Solicitar contacto** con **Selección obligatoria** y **Número de teléfono** evita que el flujo avance hasta tenerlo, y el **Mensaje de reintento** le explica al usuario qué falta.
  </Accordion>

  <Accordion title="Registro de leads sin fricción">
    Un workflow de captura de leads quiere guardar el contacto del usuario sin detener la conversación: **Solicitar contacto** con **Nombre de usuario** acepta cualquier tarjeta compartida y deja el número como opcional.
  </Accordion>

  <Accordion title="Pedir el teléfono sin bloquear la conversación">
    Un workflow de ventas pide el contacto para registrar al cliente, pero el cliente puede preguntar antes por un asesor o por una sucursal: **Solicitar contacto** sin **Selección obligatoria** deja que el router atienda esas preguntas y, cuando el cliente comparte su tarjeta, el registro continúa. Como la tarjeta puede llegar sin número, un nodo **Condicional** revisa si `{{$user.phone}}` está vacío antes de guardarlo y, si falta, lo pide de otra forma.
  </Accordion>
</AccordionGroup>

<Warning>
  Este nodo solo funciona en canales de WhatsApp.
</Warning>

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Solicitud de Ubicación" icon="location-dot" href="/guides/nodos/solicitud-ubicacion">
    Pide la ubicación del usuario con un botón interactivo
  </Card>

  <Card title="Contacto" icon="address-card" href="/guides/nodos/contacto">
    Envía una tarjeta de contacto al usuario
  </Card>
</CardGroup>


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