Сообщения с запросом местоположения | Документация для разработчиков
Сообщения с запросом местоположения
Обновлено: 3 ноября 2025 г
В сообщениях с запросом местоположения отображается текст сообщения и кнопка «Отправить местоположение» . Когда пользователь WhatsApp нажимает на эту кнопку, появляется экран обмена местоположением, с помощью которого он может поделиться своим местоположением.
После того как пользователь сообщит о своем местоположении, сообщений , содержащий информацию о местоположении пользователя.
Синтаксис запроса
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "type": "interactive", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "интерактивный": { "тип": "сообщение_запроса_местоположения", "тело": { "текст": "<BODY_TEXT> " }, "action": { "name": "send_location" } } }'Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<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 |
синтаксис веб-перехватчика
Когда пользователь WhatsApp отправляет свое местоположение в ответ на ваше сообщение, сообщений, содержащий данные о местоположении пользователя.
{ "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_NAME> " }, "wa_id": "<WHATSAPP_USER_ID> " } ], "сообщения": [ { "контекст": { "из": "<WHATSAPP_BUSINESS_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_CONTEXT_MESSAGE_ID> " }, "от": "<WHATSAPP_USER_ID> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<TIMESTAMP> ", "местоположение": { "адрес": "<LOCATION_ADDRESS> ", "широта":<LOCATION_LATITUDE> , "долгота":<LOCATION_LONGITUDE> , "имя": "<LOCATION_NAME> " }, "type": "location" } ] }, "field": "messages" } ] } ] }Параметры веб-перехватчика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<LOCATION_ADDRESS>Нить | Адрес местоположения. Этот параметр появится только в том случае, если пользователь WhatsApp решит им поделиться. | 1071 5th Ave, Нью-Йорк, Нью-Йорк 10128 |
<LOCATION_LATITUDE>Число | Координаты местоположения (широта) в десятичных градусах. | 40.782910059774 |
<LOCATION_LONGITUDE>Число | Координаты местоположения (долгота) в десятичных градусах. | -73.959075808525 |
<LOCATION_NAME>Нить | Название местоположения. Этот параметр появится только в том случае, если пользователь WhatsApp решит им поделиться. | Музей Соломона Р. Гуггенхайма |
<TIMESTAMP>Нить | Временная метка UNIX, указывающая, когда наши серверы обработали сообщение пользователя WhatsApp. | 1702920965 |
<WHATSAPP_BUSINESS_ACCOUNT_ID>Нить | Идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>Нить | Номер телефона, отображаемый в WhatsApp для бизнеса. | 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. | wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA= |
<WHATSAPP_USER_ID>Нить | Идентификатор пользователя WhatsApp. | 16505551234 |
<WHATSAPP_USER_NAME>Нить | Имя пользователя WhatsApp. | Пабло Моралес |
Пример запроса
curl 'https://graph.facebook.com/v25.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "type": "interactive", "to": "+16505551234", "interactive": { "type": "location_request_message", "body": { "text": "Давайте начнем с получения вашего заказа. Вы можете либо вручную *ввести адрес*, либо *поделиться своим текущим местоположением*." }, "action": { "name": "send_location" } } }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBJCNUQ5RUNBNTk3OEQ2M0ZEQzgA" } ] }Пример веб-перехватчика
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Pablo Morales" }, "wa_id": "16505551234" } ], "messages": [ { "context": { "from": "15550783881", "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA" }, "from": "16505551234", "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=", "timestamp": "1702920965", "location": { "address": "1071 5th Ave, New York, NY 10128", "latitude": 40.782910059774, "longitude": -73.959075808525, "name": "Музей Соломона Р. Гуггенхайма" }, "type": "location" } ] }, "field": "messages" } ] } ] }
Комментарии отсутствуют
Комментарии отсутствуют