Сообщения с запросом местоположения | Документация для разработчиков
Сообщения с запросом местоположения
Обновлено: 3 ноября 2025 г
В сообщениях с запросом местоположения отображается текст сообщения и кнопка «Отправить местоположение» . Когда пользователь WhatsApp нажимает на эту кнопку, появляется экран обмена местоположением, с помощью которого он может поделиться своим местоположением.
Once the user shares their location, a messages webhook is triggered, containing the user's location details.
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить |
Необходимый.
Системный токен или бизнес-токен . |
|
<API_VERSION>Нить |
Необязательный.
Версия Graph API. |
v25.0 |
<BODY_TEXT>Нить |
Необходимый.
Текст сообщения. Поддерживает URL-адреса.
Максимальное количество символов: 1024. |
Начнём с места получения заказа. Вы можете либо *ввести адрес* вручную, либо *поделиться своим текущим местоположением*. |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить |
Необходимый.
Идентификатор бизнес-телефона WhatsApp. |
106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>Нить |
Необходимый.
Номер телефона пользователя WhatsApp. |
+16505551234 |
синтаксис веб-перехватчика
When a WhatsApp user shares their location in response to your message, a messages webhook is triggered containing the user's location details.
Параметры веб-перехватчика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<LOCATION_ADDRESS>Нить |
Адрес местоположения.
Этот параметр появится только в том случае, если пользователь WhatsApp решит им поделиться. |
1071 5th Ave, Нью-Йорк, Нью-Йорк 10128 |
<LOCATION_LATITUDE>Число |
Координаты местоположения (широта) в десятичных градусах. |
40.782910059774 |
<LOCATION_LONGITUDE>Число |
Координаты местоположения (долгота) в десятичных градусах. |
-73.959075808525 |
<LOCATION_NAME>Нить |
Название местоположения.
Этот параметр появится только в том случае, если пользователь WhatsApp решит им поделиться. |
Музей Соломона Р. Гуггенхайма |
<TIMESTAMP>Нить |
UNIX timestamp indicating when our servers processed the WhatsApp user's message. |
1702920965 |
<WHATSAPP_BUSINESS_ACCOUNT_ID>Нить |
Идентификатор бизнес-аккаунта WhatsApp. |
102290129340398 |
<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>Нить |
WhatsApp business phone number's display number. |
15550783881 |
<WHATSAPP_BUSINESS_PHONE_NUMBER>Нить |
Рабочий номер телефона WhatsApp. |
15550783881 |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить |
Идентификатор бизнес-телефона WhatsApp. |
106540352242922 |
<WHATSAPP_CONTEXT_MESSAGE_ID>Нить |
Идентификатор сообщения WhatsApp, на которое пользователь отвечает. |
wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA |
<WHATSAPP_MESSAGE_ID>Нить |
WhatsApp message ID of the user's message. |
wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA= |
<WHATSAPP_USER_ID>Нить |
WhatsApp user's WhatsApp ID. |
16505551234 |
<WHATSAPP_USER_NAME>Нить |
WhatsApp user's name. |
Пабло Моралес |