Request contact info - Kapso Documentation

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

REST API

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.

{
  "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.

​What you receive

​Template button

What you receive

Template button