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

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

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

Обновлено: 22 октября 2025 г
Веб сообщений описывает сообщения, отправленные пользователем WhatsApp компании, а также статус сообщений, отправленных компанией пользователю 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": "1749416383", "type": "text", "text": { "body": "Есть ли он в другом цвете?" } } ] }, "field": "messages" } ] } ] }
Объекты в  сообщений  type` объекта ). По этой причине для каждого типа входящего сообщения существует отдельная ссылка, доступная в меню слева.
Исходящие сообщения
Веб-хуки сообщений, описывающие сообщение, отправленное компанией пользователю WhatsApp, имеют другую структуру. Их легко идентифицировать по наличию  статусов . Например, этот веб-хук описывает сообщение, доставленное на устройство пользователя WhatsApp:
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "statuses": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI3MTE5MjVBOTE3MDk5QUVFM0YA", "status": "delivered", "timestamp": "1750263773", "recipient_id": "16505551234", "conversation": { "id": "6ceb9d929c9bdc4f90e967a32f8639b4", "origin": { "type": "service" } }, "pricing": { "billable": true, "pricing_model": "CBP", "category": "service" } } ] }, "field": "messages" } ] } ] }
Обратите внимание, что эти веб-хуки описывают не содержимое самого исходящего сообщения, а только его статус, и каждое исходящее сообщение может иметь до трех отдельных веб-хуков (один для статуса «отправлено», один для «доставлено» и один для «прочитано»).
Для вебхуков статуса также существует отдельная справочная информация .
Ошибки
Ошибки в веб-хуках сообщений могут проявляться в трех местах:
    Ошибки на системном, прикладном и учётном уровнях отображаются как  значения ( entry.changes.value.errors ). См.  по ошибкам .Ошибки входящих сообщений отображаются в  messages ( entry.changes.value.messages.errors ). Для этих веб-хуков установлен тип unsupported . См.  по unsupported .Ошибки исходящих сообщений отображаются в  статусов ( entry.changes.value.statuses.errors ). См.  статусов .
    
    
            
    
        
    
    
    
        
    
            
    
                
                
    
                    
                    
                
    
            
    
            
            
    
                                            
    
        
    
    
    

    

    
    
    

    
            
    
            
    

    
    
        
    
            
             
         
    
            
    

    
    
        
    
                    
    

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

            
    

    

    

                
    
        
    
                
    
        
    
    
    

    
    

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