Веб-хуки для API групп | Документация для разработчиков
Веб-хуки для API групп
Обновлено: 11 февраля 2026 г
Для получения уведомлений через веб-перехватчики о метаданных ваших групп, пожалуйста, подпишитесь на следующие поля веб-перехватчика:
group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_update
вебхуки group_lifecycle_update
Веб
group_lifecycle_update срабатывает при создании или удалении группы.Группа создает и добивается успеха
Создание группы не удалось
Удаление группы прошло успешно
Удаление группы не удаётся
вебхуки group_participants_update
group_participants_update
, когда пользователь WhatsApp присоединяется к группе по ссылке-приглашению, отправляет запрос на вступление в группу, отменяет свой запрос или когда один или несколько запросов на вступление одобрены.Пользователь успешно присоединился к группе по ссылке-приглашению
Пользователь принимает или отменяет запрос на присоединение
параметр GROUP_REQUEST_TYPE устанавливается в значение group_join_request_created .Для отмены запросов: параметр GROUP_REQUEST_TYPE устанавливается в значение group_join_request_revoked .
Запрос на присоединение одобрен
Участник группы успешно удаляет
Удаление участника группы при частичном сбое участников
Удаление участника группы не удается
Участник группы покидает веб-хук
Этот веб-хук отправляется, когда участник группы покидает группу.
initiated_by и только wa_id в removed_participants будут указывать на участника, покинувшего группу.веб-хуки group_settings_update
Обновление настроек группы прошло успешно
Обновление настроек группы частично завершилось с ошибкой
Обновление настроек группы завершилось неудачей
вебхуки group_status_update
WhatsApp использует передовые технологии машинного обучения для анализа информации о группах, включая темы обсуждений, фотографии профилей и описания групп. Мы также предоставляем пользователям простые возможности для отправки нам отчетов из любого чата.
, если администратор группы нарушает наши Условия предоставления услуг .
Вы можете получить веб-хук, если группа, которой вы управляете, будет заблокирована. Вы также можете получить веб-хук, если заблокированная группа, которой вы управляете, перестанет быть заблокированной.
Группа отстранена
Отстранение от группы снято
Веб-перехватчики статуса групповых сообщений
При отправке сообщений группе вы будете получать веб-перехватчик статуса, когда сообщение будет отправлено, доставлено и прочитано. Вместо отправки нескольких веб-перехватчиков для каждого обновления статуса мы можем отправлять агрегированный веб-перехватчик.
Вы можете получать два типа агрегированных веб-хуков состояния сообщений.
Несколько участников, одно сообщение
Если вы отправляете сообщение и настроены на получение нескольких
«прочитано» или «доставлено» от участников, мы отправим вам один агрегированный веб-хук, содержащий несколько объектов статуса Каждый полученный вами веб-хук будет относиться к одному сообщению, отправленному одной группе и одному типу статуса, то есть одной группе, одному статусу от нескольких участников для одного сообщения.
Сводная информация о статусе групповых сообщений
Несколько сообщений, один участник
Если вы отправляете несколько сообщений группе и настроены на получение нескольких статусов «прочитано» или
«доставлено» от одного участника, мы можем отправить вам один агрегированный веб-хук, содержащий несколько статуса .Каждый полученный вами веб-хук будет относиться к нескольким сообщениям, отправленным одной группе и одному типу статуса, то есть одной группе, одному статусу от одного участника для нескольких сообщений.
Сводная информация о статусе групповых сообщений
Групповое сообщение доставлено
Информация о ценах
Сообщения о состоянии, содержащие вебхуки с информацией о ценах, будут иметь следующую информацию:
Параметр CONVERSATION_CATEGORY установлен в одно из следующих значений:group_marketing - Обозначает маркетинговую дискуссию.group_utility - Указывает на разговор, связанный с утилитами.group_service — указывает на диалог между службами.Значение IS_BILLABLE установлено в одно из следующих значений:true - Указывает на платный разговор.false — Указывает на разговор, не подлежащий оплате.PRICING_MODEL установлен на PMP .