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

Веб-хуки для API групп | Документация для разработчиков

Веб-хуки для API групп

Обновлено: 11 февраля 2026 г
Для получения уведомлений через веб-перехватчики о метаданных ваших групп, пожалуйста, подпишитесь на следующие поля веб-перехватчика:
    group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_update

    вебхуки group_lifecycle_update

    Веб group_lifecycle_update срабатывает при создании или удалении группы.

    Группа создает и добивается успеха

    

    {
    "объект":
    
"whatsapp_business_account",
    "вход":
    
[
    
{
    "идентификатор":
    
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
    "изменения": [
            {
    "ценить": {
    "messaging_product": "WhatsApp",
    "метаданные": {
    "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
    "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID"
                },
    "группы": [
                  {
    "временная метка": "ВРЕМЕННАЯ МЕТКА",
    "group_id": "GROUP_ID",
    "тип": "group_create",
    "request_id": "REQUEST_ID",
    "предмет": "тестовая ссылка-приглашение",
    "invite_link": "https://chat.whatsapp.com/LINK_ID"
    "join_approval_mode": "JOIN_APPROVAL_MODE"
                  }
                ]
              },
    "поле": "group_lifecycle_update"
            }
          ]
        }
      ]
    }
    Создание группы не удалось
    

    

    {
    "объект":
    
"whatsapp_business_account",
    "вход":
    
[
    
{
    "идентификатор":
    
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
    "изменения": [
            {
    "ценить": {
    "messaging_product": "WhatsApp",
    "метаданные": {
    "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
    "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                  },
    "группы": [
              {
    "временная метка": "ВРЕМЕННАЯ МЕТКА",
    "тип": "group_create",
    "предмет": "GROUP_SUBJECT",
    "описание": "ОПИСАНИЕ ГРУППЫ",
    "request_id": "REQUEST_ID",
    "group_id": "GROUP_ID",
    "ошибки": [
                          {
    "код": "КОД ОШИБКИ",
    "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
    "заголовок": "ERROR_TITLE",
    "error_data": {
    "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                            }
                          }
                        ]
              }
                   ]
                },
    "поле": "group_lifecycle_update"
            }
          ]
        }
      ]
    }
    Удаление группы прошло успешно
    

    

    {
    "объект":
    
"whatsapp_business_account",
    "вход":
    
[
    
{
    "идентификатор":
    
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
    "изменения": [
            {
    "ценить": {
    "messaging_product": "WhatsApp",
    "метаданные": {
    "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
    "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                  },
    "группы": [
                      {
    "временная метка": "ВРЕМЕННАЯ МЕТКА",
    "group_id": "GROUP_ID",
    "тип": "group_delete"
    "request_id": "REQUEST_ID",
                     }
                   ]
              },
    "поле": "group_lifecycle_update"
            }
          ]
        }
      ]
    }
    Удаление группы не удаётся
    

    

    {
    "объект":
    
"whatsapp_business_account",
    "вход":
    
[
    
{
    "идентификатор":
    
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
    "изменения": [
            {
    "ценить": {
    "messaging_product": "WhatsApp",
    "метаданные": {
    "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
    "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                  },
    "группы": [
                      {
    "временная метка": "ВРЕМЕННАЯ МЕТКА",
    "group_id": "GROUP_ID",
    "тип": "group_delete",
    "request_id": "REQUEST_ID",
    "ошибки": [
                          {
    "код": "КОД ОШИБКИ",
    "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
    "заголовок": "ERROR_TITLE",
    "error_data": {
    "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                            }
                          }
                        ]
                     }
                   ]
              },
    "поле": "group_lifecycle_update"
            }
          ]
        }
      ]
    }
    вебхуки group_participants_update
    

     group_participants_update  , когда пользователь WhatsApp присоединяется к группе по ссылке-приглашению, отправляет запрос на вступление в группу, отменяет свой запрос или когда один или несколько запросов на вступление одобрены.
    

    

    

    

    Пользователь успешно присоединился к группе по ссылке-приглашению
    

    

    {
    "объект":
    
"whatsapp_business_account",
    "вход":
    
[
    
{
    "идентификатор":
    
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
    "изменения": [
            {
    "ценить": {
    "messaging_product": "WhatsApp",
    "метаданные": {
    "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
    "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                  },
    "группы": [
                      {
    "временная метка": "ВРЕМЕННАЯ МЕТКА",
    "group_id": "GROUP_ID",
    "тип": "group_participants_add",
    "причина": "invite_link",
    "added_participants": [
                            {
    "ва_ид": "WHATSAPP_ID",
                            },
                        ]
                     }
                  ]
              },
    "поле": "group_participants_update"
            }
          ]
        }
      ]
    }
    Пользователь принимает или отменяет запрос на присоединение
    

      Для запросов на присоединение:  параметр GROUP_REQUEST_TYPE устанавливается в значение group_join_request_created .Для отмены запросов:  параметр GROUP_REQUEST_TYPE устанавливается в значение group_join_request_revoked .

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "НОМЕР_ТЕЛЕФОНА_ДЛЯ_ВЕДОМЛЕНИЯ_БИЗНЕСА",
      "идентификатор_номера_телефона": "НОМЕР_ДЕЛОВОГО_ТЕЛЕФОНА"
                  },
      "группы": [
                    {
      "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
      "group_id": "GROUP_ID",
      "тип": "GROUP_REQUEST_TYPE",
      "причина": "REASON_OR_REQUEST_OUTCOME"
      "join_request_id": "JOIN_REQUEST_ID",
      "ва_ид": "ИДЕНТИФИКАТОР ПОЛЬЗОВАТЕЛЯ WHATSAPP"
                    }
                  ]
                },
      "поле": "group_participants_update"
              }
            ]
          }
        ]
      }
      Запрос на присоединение одобрен
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "НОМЕР_ТЕЛЕФОНА_ДЛЯ_ВЕДОМЛЕНИЯ_БИЗНЕСА",
      "идентификатор_номера_телефона": "НОМЕР_ДЕЛОВОГО_ТЕЛЕФОНА"
                  },
      "группы": [
                    {
      "временная метка": WEBHOOK_TRIGGER_TIMESTAMP,
      "group_id": "GROUP_ID",
      "тип": "group_participants_add",
      "причина": "invite_link",
      "added_participants": [
                        {
      "вход": "НОМЕР_ТЕЛЕФОНА_ПОЛЬЗОВАТЕЛЯ_WHATSAPP",
      "ва_ид": "ИДЕНТИФИКАТОР ПОЛЬЗОВАТЕЛЯ WHATSAPP"
                        },
                        //Дополнительные участники здесь, если одобренный в масса.
                      ]
                    }
                  ]
                },
      "поле": "group_participants_update"
              }
            ]
          }
        ]
      }
      Участник группы успешно удаляет
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                    },
      "группы": [
                        {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "group_id": "GROUP_ID",
      "тип": "group_participants_remove",
      "request_id": "REQUEST_ID",
      "удалённые_участники": [
                              // Пользователь 1 успешно удалено
                              {
      "вход": "НОМЕР_ТЕЛЕФОНА или ИДЕНТИФИКАТОР_WHATSAPP"
                              },
                              {
      "вход": "НОМЕР_ТЕЛЕФОНА или ИДЕНТИФИКАТОР_WHATSAPP"
                              },
                              ...
                          ]
                       }
      "инициировано_кем": "бизнес"
                    ]
                },
      "поле": "group_participants_update"
              }
            ]
          }
        ]
      }
      Удаление участника группы при частичном сбое участников
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                    },
      "группы": [
                        {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "group_id": "GROUP_ID",
      "тип": "group_participants_remove",
      "request_id": "REQUEST_ID",
      "инициировано_кем": бизнес,
      "удалённые_участники": [
                            // Пользователь 1 успешно удалено
                            {
      "вход": "НОМЕР_ТЕЛЕФОНА или ИДЕНТИФИКАТОР_WHATSAPP"
                            },
                            // Дополнительные пользователи удалены успешно
                            ...
                          ],
      "неудачливые_участники": [
                            // Пользователь 2 не удалено из-за ошибок
                            {
      "вход": "НОМЕР_ТЕЛЕФОНА или ИДЕНТИФИКАТОР_WHATSAPP"
      "ошибки": [
                                {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                                  }
                                }
                              ]
                            }
                          ],
      "ошибки": [
                            {
      "код": "КОД ОШИБКИ",
      "сообщение": «Не удалось исключить некоторых участников из группы»",
      "заголовок": «Не всем участникам удалось добиться успеха в удалении»,
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                              }
                            }
                          ]
                       }
      "инициировано_кем": "бизнес"
                    ]
                },
      "поле": "group_participants_update"
              }
            ]
          }
        ]
      }
      Удаление участника группы не удается
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                    },
      "группы": [
                        {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "group_id": "GROUP_ID",
      "тип": "group_participants_remove",
      "request_id": "REQUEST_ID",
      "неудачливые_участники": [
                            {
      "вход": "НОМЕР_ТЕЛЕФОНА или ИДЕНТИФИКАТОР_WHATSAPP"
                            },
                            {
      "вход": "НОМЕР_ТЕЛЕФОНА или ИДЕНТИФИКАТОР_WHATSAPP"
                            },
                            // Добавление дополнительных пользователей не удалосьбыть удален
                            ...
                          ],
      "ошибки": [
                            {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                              }
                            }
                          ]
                       }
      "инициировано_кем": "бизнес"
                    ]
                },
      "поле": "group_participants_update"
              }
            ]
          }
        ]
      }
      Участник группы покидает веб-хук
      

      Этот веб-хук отправляется, когда участник группы покидает группу.  initiated_by и только wa_id в  removed_participants будут указывать на участника, покинувшего группу.
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР_АККАУНТА_WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID",
                    },
      "группы": [
                        {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "group_id": "GROUP_ID",
      "тип": "group_participants_remove",
      "удалённые_участники": [
                            {
      "ва_ид": "WHATSAPP_ID",
                            }
                          ]
                       }
      "инициировано_кем": «участник»
                     ]
                },
      "поле": "group_participants_update"
              }
            ]
          }
        ]
      }
      веб-хуки group_settings_update
      

      

      

      

      Обновление настроек группы прошло успешно
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"<ID> ",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "DISPLAY_NUMBER",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID"
                  },
      "группы": [
                    {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "group_id": "GROUP_ID",
      "тип": "group_settings_update",
      "request_id": "REQUEST_ID",
      "profile_picture": {
      "mime_type": "image/jpeg",
      "update_successful": истинный,
      "sha256": "PHOTO_HASH",
                      },
      "group_subject": {
      "текст": "Испытуемый",
      "update_successful": истинный,
                      },
      "group_description": {
      "текст": «Описание теста»,
      "update_successful": истинный,
                      }
                    }
                  ]
                },
      "поле": "group_settings_update"
              }
            ]
          }
        ]
      }
      Обновление настроек группы частично завершилось с ошибкой
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID"
                  },
      "группы": [
                    {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "group_id": "GROUP_ID",
      "тип": "group_settings_update",
      "request_id": "REQUEST_ID",
      "profile_picture": {
      "mime_type": "image/jpeg",
      "update_successful": истинный
      "sha256": "PHOTO_HASH",
                      },
      "group_subject": {
      "текст": "Испытуемый",
      "update_successful": ЛОЖЬ,
      "ошибки": [
                          {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                            }
                          }
                        ]
                      },
      "group_description": {
      "текст": «Описание теста»,
      "update_successful": ЛОЖЬ,
      "ошибки": [
                          {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                            }
                          }
                        ]
                      },
      "ошибки": [
                        {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                          }
                        }
                      ]
                    }
                  ]
                },
      "поле": "group_settings_update"
              }
            ]
          }
        ]
      }
      Обновление настроек группы завершилось неудачей
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"<ID> ",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР ТЕЛЕФОНА"
                  },
      "группы": [
                    {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "group_id": "GROUP_ID",
      "request_id": "REQUEST_ID",
      "тип": "group_settings_update",
      "profile_picture": {
      "mime_type": "image/jpeg",
      "sha256": "PHOTO_HASH",
      "update_successful": ЛОЖЬ,
      "ошибки": [
                          {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                            }
                          }
                        ]
                      },
      "group_subject": {
      "текст": "Испытуемый",
      "update_successful": ЛОЖЬ,
      "ошибки": [
                          {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                            }
                          }
                        ]
                      },
      "group_description": {
      "текст": «Описание теста»,
      "update_successful": ЛОЖЬ,
      "ошибки": [
                          {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                            }
                          }
                        ]
                      },
      "ошибки": [
                        {
      "код": "КОД ОШИБКИ",
      "сообщение": "СООБЩЕНИЕ ОБ ОШИБКЕ",
      "заголовок": "ERROR_TITLE",
      "error_data": {
      "подробности": "ПОДРОБНОСТИ ОШИБКИ"
                          }
                        }
                      ]
                    }
                  ]
                },
      "поле": "group_settings_update"
              }
            ]
          }
        ]
      }
      вебхуки group_status_update
      

      WhatsApp использует передовые технологии машинного обучения для анализа информации о группах, включая темы обсуждений, фотографии профилей и описания групп. Мы также предоставляем пользователям простые возможности для отправки нам отчетов из любого чата.
      

      Мы можем блокировать дальнейшую активность в чатах для соблюдения наших юридических обязательств. Мы также можем блокировать дальнейшую активность в чате, если администратор группы нарушает наши правила Условия предоставления услуг⁠?.
      

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

      

      

      

      Группа отстранена
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID"
                  },
      "группы": [
                    {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "тип": "group_suspend",
      "group_id": "GROUP_ID"
                    }
                  ]
                },
      "поле": "group_status_update"
              }
            ]
          }
        ]
      }
      Отстранение от группы снято
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "ОТОБРАЖЕНИЕ_НОМЕРА_ТЕЛЕФОНА",
      "идентификатор_номера_телефона": "НОМЕР_ТЕЛЕФОНА_ID"
                  },
      "группы": [
                    {
      "временная метка": "ВРЕМЕННАЯ МЕТКА",
      "тип": "group_suspend_cleard",
      "group_id": "GROUP_ID"
                    }
                  ]
                },
      "поле": "group_status_update"
              }
            ]
          }
        ]
      }
      Веб-перехватчики статуса групповых сообщений
      

      При отправке сообщений группе вы будете получать веб-перехватчик статуса, когда сообщение будет отправлено, доставлено и прочитано. Вместо отправки нескольких веб-перехватчиков для каждого обновления статуса мы можем отправлять агрегированный веб-перехватчик.
      

      Вы можете получать два типа агрегированных веб-хуков состояния сообщений.
      

      

      

      

      Несколько участников, одно сообщение
      

      Если вы отправляете сообщение и настроены на получение нескольких  «прочитано» или «доставлено» от участников, мы отправим вам один агрегированный веб-хук, содержащий несколько объектов статуса 
      

      Каждый полученный вами веб-хук будет относиться к одному сообщению, отправленному одной группе и одному типу статуса, то есть одной группе, одному статусу от нескольких участников для одного сообщения.
      

      Сводная информация о статусе групповых сообщений
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "НОМЕР_ТЕЛЕФОНА_ДЛЯ_ВЕДОМЛЕНИЯ_БИЗНЕСА",
      "идентификатор_номера_телефона": "НОМЕР_ДЕЛОВОГО_ТЕЛЕФОНА"
                  },
      "статусы": [
                    {
      "идентификатор": "WHATSAPP_MESSAGE_ID",
      «статус»: "читать",
      "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
      "recipient_id": "GROUP_ID",
      "recipient_type": "группа",
      "recipient_participant_id": "НОМЕР ТЕЛЕФОНА УЧАСТНИКА ГРУППЫ_1",
      "беседа": {
      "идентификатор": "CONVERSATION_ID",
      "источник": {
      "тип": "КАТЕГОРИЯ_РАЗГОВОРА"
                        },
      «ценообразование»: {
      "подлежащий оплате": IS_BILLABLE,
      "pricing_model": "МОДЕЛЬ ЦЕНООБРАЗОВАНИЯ",
      "категория": "КАТЕГОРИЯ_РАЗГОВОРА"
                        }
                      }
                    },
                    {
      "идентификатор": "WHATSAPP_MESSAGE_ID",
      «статус»: "читать",
      "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
      "recipient_id": "GROUP_ID",
      "recipient_type": "группа",
      "recipient_participant_id": "НОМЕР ТЕЛЕФОНА УЧАСТНИКА ГРУППЫ_2",
      "беседа": {
      "идентификатор": "CONVERSATION_ID",
      "источник": {
      "тип": "КАТЕГОРИЯ_РАЗГОВОРА"
                        },
      «ценообразование»: {
      "подлежащий оплате": IS_BILLABLE,
      "pricing_model": "МОДЕЛЬ ЦЕНООБРАЗОВАНИЯ",
      "категория": "КАТЕГОРИЯ_РАЗГОВОРА"
                        }
                      }
                    }
                  ]
                },
      "поле": "сообщения"
              }
            ]
          }
        ]
      }
      Несколько сообщений, один участник
      

      Если вы отправляете несколько сообщений группе и настроены на получение нескольких сообщений, 'читать''читать' или доставленный Если вы получаете статусы от одного участника, мы можем отправить вам один агрегированный веб-хук, содержащий несколько таких статусов статус объекты.
      

      Каждый полученный вами веб-хук будет относиться к нескольким сообщениям, отправленным одной группе и одному типу статуса, то есть одной группе, одному статусу от одного участника для нескольких сообщений.
      

      Сводная информация о статусе групповых сообщений
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "НОМЕР_ТЕЛЕФОНА_ДЛЯ_ВЕДОМЛЕНИЯ_БИЗНЕСА",
      "идентификатор_номера_телефона": "НОМЕР_ДЕЛОВОГО_ТЕЛЕФОНА"
                  },
      "статусы": [
                    {
      "идентификатор": "WHATSAPP_MESSAGE_ID_1",
      «статус»: "доставленный",
      "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
      "recipient_id": "GROUP_ID",
      "recipient_type": "группа",
      "recipient_participant_id": "НОМЕР_ТЕЛЕФОНА_УЧАСТНИКА_ГРУППЫ",
      "беседа": {
      "идентификатор": "CONVERSATION_ID",
      "источник": {
      "тип": "КАТЕГОРИЯ_РАЗГОВОРА"
                        },
      «ценообразование»: {
      "подлежащий оплате": IS_BILLABLE,
      "pricing_model": "МОДЕЛЬ ЦЕНООБРАЗОВАНИЯ",
      "категория": "КАТЕГОРИЯ_РАЗГОВОРА"
                        }
                      }
                    },
                    {
      "идентификатор": "WHATSAPP_MESSAGE_ID_2",
      «статус»: "доставленный",
      "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
      "recipient_id": "GROUP_ID",
      "recipient_type": "группа",
      "recipient_participant_id": "НОМЕР_ТЕЛЕФОНА_УЧАСТНИКА_ГРУППЫ",
      "беседа": {
      "идентификатор": "CONVERSATION_ID",
      "источник": {
      "тип": "КАТЕГОРИЯ_РАЗГОВОРА"
                        },
      «ценообразование»: {
      "подлежащий оплате": IS_BILLABLE,
      "pricing_model": "МОДЕЛЬ ЦЕНООБРАЗОВАНИЯ",
      "категория": "КАТЕГОРИЯ_РАЗГОВОРА"
                        }
                      }
                    }
                  ]
                },
      "поле": "сообщения"
              }
            ]
          }
        ]
      }
      Групповое сообщение доставлено
      

      

      {
      "объект":
      
"whatsapp_business_account",
      "вход":
      
[
      
{
      "идентификатор":
      
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
      "изменения": [
              {
      "ценить": {
      "messaging_product": "WhatsApp",
      "метаданные": {
      "display_phone_number": "НОМЕР_ТЕЛЕФОНА_ДЛЯ_ВЕДОМЛЕНИЯ_БИЗНЕСА",
      "идентификатор_номера_телефона": "НОМЕР_ДЕЛОВОГО_ТЕЛЕФОНА"
                  },
      "статусы": [
                    {
      "идентификатор": "WHATSAPP_MESSAGE_ID",
      «статус»: "доставленный",
      "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
      "recipient_id": "GROUP_ID",
      "recipient_type": "группа",
      "participant_recipient_id": "НОМЕР_ТЕЛЕФОНА_УЧАСТНИКА_ГРУППЫ",
      "беседа": {
      "идентификатор": "CONVERSATION_ID",
      "источник": {
      "тип": "КАТЕГОРИЯ_РАЗГОВОРА"
                      }
                    },
      «ценообразование»: {
      "подлежащий оплате": IS_BILLABLE,
      "pricing_model": "МОДЕЛЬ ЦЕНООБРАЗОВАНИЯ",
      "категория": "КАТЕГОРИЯ_РАЗГОВОРА"
                      }
                    }
                  ]
                },
      "поле": "сообщения"
              }
            ]
          }
        ]
      }
      Информация о ценах
      

      Сообщения о состоянии, содержащие вебхуки с информацией о ценах, будут иметь следующую информацию:
      

        Параметр CONVERSATION_CATEGORY установлен в одно из следующих значений:

          групповой маркетинг —- Обозначает маркетинговую беседу.группа утилит —- Указывает на необходимость проведения коммунальных работ.группа_служба —- Обозначает разговор со службой поддержки.Значение IS_BILLABLE установлено в одно из следующих значений:

            истинный —- Указывает на платный разговор.ЛОЖЬ —- Указывает на разговор, не подлежащий оплате.PRICING_MODEL установлен на PMP .


            

            

            

            Групповое сообщение прочитано ( с указанием цен )
            

            

            {
            "объект":
            
"whatsapp_business_account",
            "вход":
            
[
            
{
            "идентификатор":
            
"ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
            "изменения": [
                    {
            "ценить": {
            "messaging_product": "WhatsApp",
            "метаданные": {
            "display_phone_number": "НОМЕР_ТЕЛЕФОНА_ДЛЯ_ВЕДОМЛЕНИЯ_БИЗНЕСА",
            "идентификатор_номера_телефона": "НОМЕР_ДЕЛОВОГО_ТЕЛЕФОНА"
                        },
            "статусы": [
                          {
            "идентификатор": "WHATSAPP_MESSAGE_ID",
            «статус»: "читать",
            "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
            "recipient_id": "GROUP_ID",
            "recipient_type": "группа",
            "participant_recipient_id": "НОМЕР_ТЕЛЕФОНА_УЧАСТНИКА_ГРУППЫ",
            "беседа": {
            "идентификатор": "CONVERSATION_ID",
            "источник": {
            "тип": "КАТЕГОРИЯ_РАЗГОВОРА"
                            }
                          },
            «ценообразование»: {
            "подлежащий оплате": IS_BILLABLE,
            "pricing_model": "МОДЕЛЬ ЦЕНООБРАЗОВАНИЯ",
            "категория": "КАТЕГОРИЯ_РАЗГОВОРА"
                            }
                          }
                        ]
                      },
            "поле": "сообщения"
                    }
                  ]
                }
              ]
            }
            Групповое сообщение прочитано ( без указания цены )
            

            

            {
            "объект": "whatsapp_business_account",
            "вход": [
                {
            "идентификатор": "ИДЕНТИФИКАТОР БИЗНЕС-АККАУНТА WHATSAPP",
            "изменения": [
                    {
            "ценить": {
            "messaging_product": "WhatsApp",
            "метаданные": {
            "display_phone_number": "НОМЕР_ТЕЛЕФОНА_ДЛЯ_ВЕДОМЛЕНИЯ_БИЗНЕСА",
            "идентификатор_номера_телефона": "НОМЕР_ДЕЛОВОГО_ТЕЛЕФОНА"
                        },
            "статусы": [
                          {
            "идентификатор": "WHATSAPP_MESSAGE_ID",
            «статус»: "читать",
            "временная метка": "WEBHOOK_TRIGGER_TIMESTAMP",
            "recipient_id": "GROUP_ID",
            "recipient_type": "группа"
            "participant_recipient_id": "НОМЕР_ТЕЛЕФОНА_УЧАСТНИКА_ГРУППЫ"
                          }
                        ]
                      },
            "поле": "сообщения"
                    }
                  ]
                }
              ]
            }
            
    
                    
            
    
            

            
            
        
            
    
            

    
            

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