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.

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."
});

message = zavu.messages.send(
    to="US.13491208655302741918",
    channel="whatsapp",
    message_type="request_contact_info",
    text="Share your phone number so our team can call you back."
)

message = client.messages.send(
  to: "US.13491208655302741918",
  channel: "whatsapp",
  message_type: "request_contact_info",
  text: "Share your phone number so our team can call you back."
)

message, err := client.Messages.Send(context.TODO(), zavudev.MessageSendParams{
    To:          zavudev.String("US.13491208655302741918"),
    Channel:     zavudev.String("whatsapp"),
    MessageType: zavudev.String("request_contact_info"),
    Text:        zavudev.String("Share your phone number so our team can call you back."),
})

$message = $client->messages->send([
    'to' => 'US.13491208655302741918',
    'channel' => 'whatsapp',
    'messageType' => 'request_contact_info',
    'text' => 'Share your phone number so our team can call you back.',
]);

curl -X POST https://api.zavu.dev/v1/messages \
  -H "Authorization: Bearer zv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "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:

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

When the sender was only known by BSUID, Zavu automatically links the shared phone number to that contact. You do not need to update the contact yourself: from that point on, the phone number and the BSUID resolve to the same contact and conversation.

In Templates

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

Specifications

Property	Requirement
text	Required, max 1024 characters
content	Not used
channel	WhatsApp only
Button label	Fixed by WhatsApp, not customizable

Like every non-template message, a contact info request needs an open 24-hour conversation window. Outside the window, open the conversation with a template first.

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

Location Request Messages

Contact Messages

⌘I

Getting Started

Concepts

Guides

Contact Info Request Messages

Send a Contact Info Request

Receiving the Answer

In Templates

Specifications

Use Cases

​Send a Contact Info Request

​Receiving the Answer

​In Templates

​Specifications

​Use Cases

Send a Contact Info Request

Receiving the Answer

In Templates

Specifications

Use Cases