Contact Info Request Messages

Send a message with a Share Contact Info button. When the contact taps it and confirms, their phone number arrives back in the conversation as a regular inbound contact message.

This matters most for contacts who adopted a WhatsApp username and hid their phone number: it is the official way to recover a number you can call, text or verify.

Send a Contact Info Request

The prompt goes in text. There is no content object: WhatsApp owns the button, so there is nothing to configure.

TypeScriptcURLCopy
const message = await zavu.messages.send({
  to: "US.13491208655302741918",
  channel: "whatsapp",
  messageType: "request_contact_info",
  text: "Share your phone number so our team can call you back."
});

to can be a phone number or a BSUID. Asking a phone-number contact is valid too, for example to confirm the best callback number.

Receiving the Answer

The reply arrives as a standard message.inbound webhook with messageType: "contact", carrying the shared number in content.contacts:

JSONCopy
{
  "type": "message.inbound",
  "data": {
    "messageId": "msg_xyz789",
    "from": "US.13491208655302741918",
    "channel": "whatsapp",
    "messageType": "contact",
    "content": {
      "contacts": [
        {
          "name": "Sheena",
          "phones": ["+16505551234"]
        }
      ]
    }
  }
}

In Templates

Outside the 24-hour window, use a template with a request_contact_info button instead. See Template Button Types.

Specifications

Use Cases

• Recovering a callable number for a username contact known only by BSUID
• Confirming the best callback number before a support call
• Collecting a number for SMS fallback or delivery notifications
• Identity checks that require a verified phone number