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

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

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

Обновлено: 11 декабря 2025 г
сообщений бизнес-аккаунта WhatsApp для сообщений, содержащих стикер.

Триггеры

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

    Синтаксис

    { "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_PROFILE_NAME> " }, "wa_id": "<WHATSAPP_USER_ID> ", "identity_key_hash": "<IDENTITY_KEY_HASH> "<!-- only included if identity change check enabled --> } ], "сообщения": [ { "из": "<WHATSAPP_USER_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "type": "sticker", "sticker": { "mime_type": "<MEDIA_ASSET_MIME_TYPE> ", "sha256": "<MEDIA_ASSET_SHA256_HASH> ", "идентификатор": "<MEDIA_ASSET_ID> ", "url": "<MEDIA_ASSET_URL> ", "анимированный":<IS_ANIMATED?> },<!-- 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> ", "заголовок": "<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. Возможные значения:
    image — Обозначает рекламное изображение.
    видео — Обозначает видеорекламу.
    изображение
    <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=
    <IS_ANIMATED?>
    Логический
    Логическое значение, указывающее, является ли стикер анимированным ( true ) или нет ( false ).
    истинный
    <MEDIA_ASSET_ID>
    Нить
    Идентификатор медиафайла. Вы можете выполнить запрос GET по этому идентификатору , чтобы получить URL-адрес файла, а затем выполнить запрос GET по полученному URL-адресу (используя свой токен доступа), чтобы получить соответствующий файл.
    1003383421387256
    <MEDIA_ASSET_MIME_TYPE>
    Нить
    MIME-тип медиафайла.
    изображение/вебп
    <MEDIA_ASSET_SHA256_HASH>
    Нить
    Хэш SHA-256 медиаактива.
    SfInY0gGKTsJlUWbwxC1k+FAD0FZHvzwfpvO0zX0GUI=
    <MEDIA_ASSET_URL>
    Нить
    Данная JSON-функция будет постепенно предоставляться разработчикам в течение нескольких недель, начиная с 12 ноября 2025 года, и может быть недоступна вам сразу.
    URL медиафайла. Вы можете напрямую обратиться к этому URL-адресу, используя свой токен доступа, чтобы загрузить медиафайл .
    https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=133...
    <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.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=", "timestamp": "1744344496", "type": "sticker", "sticker": { "mime_type": "image/webp", "sha256": "wvqXMe6n7n1W0zphvLPoLj+s/NtKqmr3zZ7YzTP7xFI=", "id": "1908647269898587", "url": "https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=133...", "animated": true } } ] }, "field": "messages" } ] } ] }
    
    
            
    
        
    
    
    
        
    
            
    
                
                
    
                    
                    
                
    
            
    
            
            
    
                                            
    
        
    
    
    

    

    
    
    

    
            
    
            
    

    
    
        
    
            
             
         
    
            
    

    
    
        
    
                    
    

        
    Комментарии отсутствуют
    

            
    

    

    

                
    
        
    
                
    
        
    
    
    

    
    

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