Location Request Messages

Send a message with a Send location button. When the contact taps it, WhatsApp opens the location picker and their answer arrives back in the conversation as a regular inbound location message.

Use this instead of asking for an address in free text: you get exact coordinates rather than a string you have to geocode and correct.

Send a Location 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: "+14155551234",
  channel: "whatsapp",
  messageType: "location_request",
  text: "To finish your order, share the delivery address."
});

Receiving the Answer

The reply is not a new message type. It arrives as a standard message.inbound webhook with messageType: "location", and content.replyToMessageId set to the ID of the request you sent. That is how you correlate the two.

JSONCopy
{
  "type": "message.inbound",
  "data": {
    "messageId": "jd7x2k3m4n5p6q7r8s9t0",
    "from": "+14155551234",
    "channel": "whatsapp",
    "messageType": "location",
    "content": {
      "latitude": -33.4489,
      "longitude": -70.6693,
      "name": "Casa",
      "address": "Av. Providencia 1234, Santiago",
      "replyToMessageId": "jd6a1b2c3d4e5f6g7h8i9",
      "replyToMessageType": "location_request"
    }
  }
}

Store the ID returned when you send the request, then match it against content.replyToMessageId on the inbound event:

TypeScriptCopy
if (
  event.type === "message.inbound" &&
  event.data.messageType === "location" &&
  event.data.content?.replyToMessageId === pendingRequestId
) {
  const { latitude, longitude } = event.data.content;
  await saveDeliveryCoordinates(orderId, latitude, longitude);
}

Specifications

Use Cases

• Confirming a delivery address before dispatch
• Sending a technician to a customer's site
• Finding the nearest branch or pickup point
• Roadside assistance and field service
• On-site check-ins