> ## 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

> Envía un mensaje con un botón para solicitar la información de contacto del usuario

<Badge icon="whatsapp" color="green">Disponible solo en WhatsApp</Badge>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
    --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
    --header 'Content-Type: application/json' \
    --data '{
      "type": "contact_info_request",
      "text": "Por favor comparte tu información de contacto",
      "userId": "USER_ID"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "messageId": "msg_123456789"
  }
  ```
</ResponseExample>

## Parámetros de ruta

<ParamField path="botId" type="string" required>
  Identificador único del bot que envía el mensaje.
</ParamField>

## Parámetros del cuerpo

<ParamField body="type" type="string" required>
  Tipo de mensaje. Debe ser `"contact_info_request"`.
</ParamField>

<ParamField body="userId" type="string" required>
  Destinatario del mensaje. Acepta un número de teléfono en formato E.164 sin el signo `+` (ej: `593999999999`) o un BSUID (ej: `US.13491208655302741918`) para usuarios con protección de número activada en WhatsApp. Consulta [Identificación del destinatario](/api/envia-mensajes/Envio-de-mensajes#identificación-del-destinatario).
</ParamField>

<ParamField body="text" type="string" required>
  Texto que acompaña al botón para compartir contacto.
</ParamField>

## Respuesta

<ResponseField name="success" type="boolean">
  `true` si el mensaje se envió correctamente.
</ResponseField>

<ResponseField name="messageId" type="string">
  Identificador del mensaje enviado.
</ResponseField>

<Note>
  **Texto del botón:** WhatsApp muestra el botón con un texto predefinido en el idioma del usuario, ya que el texto de este botón no se puede personalizar. Solo puedes configurar el mensaje que lo acompaña en el campo `text`.
</Note>

## Mejores Prácticas

<Warning>
  **Privacidad:** Siempre explica por qué necesitas la información de contacto del usuario. Sé transparente sobre cómo se usarán sus datos.
</Warning>

## Casos de Uso

* Registrar a un nuevo cliente
* Obtener datos para dar seguimiento a una solicitud
* Confirmar la identidad del usuario antes de continuar un proceso
* Actualizar la información de contacto de un cliente existente


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