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

Справочник веб-перехватчиков сообщений о местоположении

Обновлено: 22 октября 2025 г

сообщений бизнес-аккаунта WhatsApp , содержащих информацию о местоположении.

Триггеры

Пользователь WhatsApp отправляет сообщение с указанием местоположения компании.Пользователь WhatsApp отправляет местоположение компании через рекламное объявление, размещенное по принципу «Кликни в WhatsApp».

Синтаксис

{
"object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "contacts": [ { "profile": { "name": "<WHATSAPP_USER_PROFILE_NAME>" }, "wa_id": "<WHATSAPP_USER_ID>", "identity_key_hash": "<IDENTITY_KEY_HASH>" <!-- only included if identity change check enabled --> } ], "messages": [ { "from": "<WHATSAPP_USER_PHONE_NUMBER>", "id": "<WHATSAPP_MESSAGE_ID>", "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>", "location": { "address": "<LOCATION_ADDRESS>", "latitude": <LOCATION_LATITUDE>, "longitude": <LOCATION_LONGITUDE>, "name": "<LOCATION_NAME>", "url": "<LOCATION_URL>" }, "type": "location", <!-- only included if message sent via a Click to WhatsApp ad --> "referral": { "source_url": "<AD_URL>", "source_id": "<AD_ID>", "source_type": "ad", "body": "<AD_PRIMARY_TEXT>", "headline": "<AD_HEADLINE>", "media_type": "<AD_MEDIA_TYPE>", "image_url": "<AD_IMAGE_URL>", "video_url": "<AD_VIDEO_URL>", "thumbnail_url": "<AD_VIDEO_THUMBNAIL>", "ctwa_clid": "<AD_CLICK_ID>", "welcome_message": { "text": "<AD_GREETING_TEXT>" } } } ] }, "field": "messages" } ] } ] }

Параметры

Заполнитель Описание Пример значения

<AD_CLICK_ID>

Нить

Идентификатор клика по рекламе в WhatsApp.

Он ctwa_clid Для сообщений, исходящих из рекламы в статусе WhatsApp, это свойство полностью опущеноРазмещение рекламы в статусе WhatsApp⁠?).

Aff-n8ZTODiE79d22KtAwQKj9e_mIEOOj27vDVwFjN80dp4_0NiNhEgpGo0AhemvuSoifXaytfTzcchptiErTKCqTrJ5nW1h7IHYeYymGb5K5J5iTROpBhWAGaIAeUzHL50

<AD_GREETING_TEXT>

Нить

Нажмите, чтобы открыть приветственное сообщение в WhatsApp.

Здравствуйте! Дайте нам знать, чем мы можем вам помочь!

<AD_HEADLINE>

Нить

Нажмите, чтобы открыть заголовок рекламного объявления WhatsApp.

Пообщайтесь с нами

<AD_ID>

Нить

Нажмите, чтобы открыть рекламный ID WhatsApp.

120226305854810726

<AD_IMAGE_URL>

Нить

Нажмите, чтобы перейти по ссылке на изображение в рекламе WhatsApp. Эта ссылка отображается только в том случае, если это графическая реклама.

https://scontent.xx.fbcdn.net/v/t45.1...

<AD_MEDIA_TYPE>

Нить

Тип медиафайла для рекламы в WhatsApp: Click to ad. Возможные значения:

изображение —- Обозначает рекламное изображение.

видео —- Обозначает видеоролик.

изображение

<AD_PRIMARY_TEXT>

Нить

Нажмите, чтобы открыть основной текст объявления в WhatsApp.

Летние суккуленты уже здесь!

<AD_URL>

Нить

Перейдите по ссылке, чтобы перейти к рекламному объявлению в WhatsApp.

https://fb.me/3cr4Wqqkv

<AD_VIDEO_THUMBNAIL>

Нить

Нажмите, чтобы перейти по ссылке на миниатюру рекламного видео WhatsApp. Эта ссылка отображается только в том случае, если это видеореклама.

https://scontent.xx.fbcdn.net/v/t45.3...

<AD_VIDEO_URL>

Нить

Нажмите, чтобы перейти по ссылке на видеоролик в рекламе WhatsApp. Эта ссылка отображается только в том случае, если реклама является видеорекламой.

https://scontent.xx.fbcdn.net/v/t45.2...

<BUSINESS_DISPLAY_PHONE_NUMBER>

Нить

Номер телефона компании, отображаемый на экране.

15550783881

<BUSINESS_PHONE_NUMBER_ID>

Нить

Идентификатор номера служебного телефона.

106540352242922

<IDENTITY_KEY_HASH>

Нить

Хэш ключа идентификации. Включается только в том случае, если включена проверки изменений идентификатора .

DF2lS5v2W6x=

<LOCATION_ADDRESS>

Нить

Адрес местоположения.

101 Forest Ave, Пало-Альто, Калифорния 94301

<LOCATION_LATITUDE>

Плавать

Координаты местоположения (широта) в десятичных градусах.

37.44221496582

<LOCATION_LONGITUDE>

Плавать

Координаты местоположения (долгота) в десятичных градусах.

-122.16165924072

<LOCATION_NAME>

Нить

Название местоположения.

Philz Coffee

<LOCATION_URL>

Нить

URL-адрес местоположения. Обычно указывается только для адресов предприятий.

https://philzcoffee.com/

<WEBHOOK_TRIGGER_TIMESTAMP>

Нить

Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.

1739321024

<WHATSAPP_BUSINESS_ACCOUNT_ID>

Нить

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

102290129340398

<WHATSAPP_MESSAGE_ID>

Нить

Идентификатор сообщения WhatsApp.

wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=

<WHATSAPP_USER_ID>

Нить

Идентификатор пользователя WhatsApp. Обратите внимание, что WhatsApp ~~пользователь'~~пользователь'Идентификационный номер и номер телефона могут не всегда совпадать.

16505551234

<WHATSAPP_USER_PHONE_NUMBER>

Нить

Номер телефона пользователя WhatsApp. Это то же самое значение, которое возвращает API вход Значение при отправке сообщения пользователю WhatsApp. Обратите внимание, что WhatsApp ~~пользователь'~~пользователь'Номер телефона и удостоверение личности могут не всегда совпадать.

+16505551234

<WHATSAPP_USER_PROFILE_NAME>

Нить

WhatsApp ~~пользователь'~~пользователь'Имя, как оно отображается в профиле пользователя в приложении WhatsApp.

Шина Нельсон

Пример

{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Sheena Nelson" }, "wa_id": "16505551234" } ], "messages": [ { "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "timestamp": "1744344496", "location": { "address": "101 Forest Ave, Palo Alto, CA 94301", "latitude": 37.44221496582, "longitude": -122.16165924072, "name": "Philz Coffee", "url": "https://philzcoffee.com/" }, "type": "location" } ] }, "field": "messages" } ] } ] }