Перейти к основному содержимому

Сообщения с запросом местоположения | Документация для разработчиков

Сообщения с запросом местоположения

Обновлено: 3 ноября 2025 г
В сообщениях с запросом местоположения отображается текст сообщения и кнопка «Отправить местоположение» . Когда пользователь WhatsApp нажимает на эту кнопку, появляется экран обмена местоположением, с помощью которого он может поделиться своим местоположением.

Once the user shares their location, a сообщения webhook is triggered, containing the пользователь'пользователь's location details.

Запрос синтаксис

Используйте ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения endpoint to send a location request message to a WhatsApp user.
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>


Нить





Необходимый.







EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD






<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 сообщения webhook is triggered containing the пользователь'пользователь's location details.




{

"объект":

"whatsapp_business_account",

"вход":

[ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_NAME>" }, "wa_id": "<WHATSAPP_USER_ID>" } ], "messages": [ { "context": { "from": "<WHATSAPP_BUSINESS_PHONE_NUMBER>", "id": "<WHATSAPP_CONTEXT_MESSAGE_ID>" }, "from": "<WHATSAPP_USER_ID>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<TIMESTAMP>", "location": { "address": "<LOCATION_ADDRESS>", "latitude": <LOCATION_LATITUDE>, "longitude": <LOCATION_LONGITUDE>, "name": "<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 timestamp indicating when our servers processed the WhatsApp пользователь'пользователь's message.





1702920965






<WHATSAPP_BUSINESS_ACCOUNT_ID>


Нить





Идентификатор бизнес-аккаунта WhatsApp.





102290129340398






<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>


Нить





WhatsApp business phone число'число'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 пользователь'пользователь's message.





wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=






<WHATSAPP_USER_ID>


Нить





WhatsApp пользователь'пользователь's WhatsApp ID.





16505551234






<WHATSAPP_USER_NAME>


Нить





WhatsApp пользователь'пользователь's name.





Пабло Моралес






Пример
запрос
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" } ] } ] }

    
        

    


            

        

    


    


    
    

        

             Вернуться наверх