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

# Request contact info

> Ask a WhatsApp user to share their phone number

Send a `request_contact_info` interactive message when you know a customer's BSUID but need their phone number.

```bash REST API icon="code" theme={null}
curl -X POST 'https://api.kapso.ai/meta/whatsapp/v24.0/647015955153740/messages' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "recipient": "US.13491208655302741918",
    "type": "interactive",
    "interactive": {
      "type": "request_contact_info",
      "body": {
        "text": "Please share your phone number so we can finish your request."
      },
      "action": {
        "name": "request_contact_info"
      }
    }
  }'
```

Use `to` instead of `recipient` when you already have the phone number.

## What you receive

When the user taps the button, WhatsApp sends a `contacts` message. Kapso stores the phone identity and keeps the BSUID identity on the same contact/conversation when available.

```json theme={null}
{
  "type": "contacts",
  "from_user_id": "US.13491208655302741918",
  "contacts": [
    {
      "origin": "contact_request",
      "phones": [
        {
          "phone": "+16505551234",
          "wa_id": "16505551234",
          "type": "CELL"
        }
      ]
    }
  ]
}
```

`origin` can be:

* `contact_request`: the user tapped your request contact info button
* `other`: the user shared a contact directly in WhatsApp

## Template button

You can also add a `REQUEST_CONTACT_INFO` button to utility or marketing templates.

The button text is fixed to `Share Contact Info`, and you do not send runtime button parameters for it.

See [template buttons](/docs/whatsapp/templates/buttons).