Управление группами | Документация для разработчиков
Управление группой
Обновлено: 25 марта 2026 г
Обзор
API для работы с группами предоставляет простые функции для управления группами на протяжении всего их жизненного цикла.
При создании новой группы создается ссылка-приглашение для приглашения участников в группу.
Поскольку добавлять участников в группу вручную невозможно, просто отправьте сообщение со ссылкой-приглашением пользователям WhatsApp, которых вы хотели бы пригласить в группу.
Функции управления группами
Чтобы узнать, как отправлять сообщения группам, обратитесь к справочнику по групповым сообщениям .
Подписаться на веб-хуки метаданных групп
Для получения уведомлений через веб-перехватчики о метаданных ваших групп, пожалуйста, подпишитесь на следующие поля веб-перехватчика:
group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_update
Для получения полной информации о веб-хуках для API групп, пожалуйста, посетите наш справочник по веб-хукам для API групп .
Группы, подающие заявки на вступление
Вы можете создавать группы, для присоединения к которым требуется подтверждение запроса. После включения этой функции пользователи WhatsApp, перешедшие по ссылке-приглашению в группу, смогут отправить запрос на вступление в группу или отменить ранее поданный запрос
Когда пользователь WhatsApp присоединяется к группе, отправляя запрос на вступление, срабатывает [
group_participants_update для пользователя, принявшего запрос на вступление] (/documentation/business-messaging/whatsapp/groups/webhooks#user-accepts-or-cancels-join-request). Вы также можете получить список открытых запросов на вступление через API . Используйте содержимое веб-хука или ответа API для одобрения или отклонения запросов.Одобрить запросы на присоединение
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<GROUP_ID>Нить |
Необходимый.
Идентификатор группы. |
Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD |
Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<JOIN_REQUEST_ID>Нить |
Идентификатор одобренного запроса на присоединение или идентификатор неудачного запроса на присоединение, если мы не смогли его одобрить. |
MTY0NjcwNDM1OTU6MTIwMzYzNDA0Njk0MjMzODIw |
<ERROR_CODE>Целое число |
Код ошибки, если подтверждение не удалось. |
131203 |
<ERROR_MESSAGE>Нить |
Сообщение об ошибке, если подтверждение не удалось. |
(#131203) Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности. |
<ERROR_TITLE>Нить |
Заголовок сообщения об ошибке, если его не удалось утвердить. |
Не удалось добавить участника в группу |
<ERROR_DETAILS>Нить |
Подробности ошибки, если подтверждение не удалось. |
Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности. |
Отклонить запросы на присоединение
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<GROUP_ID>Нить |
Необходимый.
Идентификатор группы. |
Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD |
<JOIN_REQUEST_ID>Нить |
Необходимый.
Идентификатор запроса на присоединение, который необходимо отклонить. |
MTY0NjcwNDM1OTU6MTIwMzYzNDA0Njk0MjMzODIw |
Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<JOIN_REQUEST_ID>Нить |
Идентификатор отклоненного запроса на присоединение или идентификатор неудачного запроса на присоединение, если мы не смогли отклонить его. |
MTY0NjcwNDM1OTU6MTIwMzYzNDA0Njk0MjMzODIw |
<ERROR_CODE>Целое число |
Код ошибки, если отклонение невозможно. |
131203 |
<ERROR_MESSAGE>Нить |
Сообщение об ошибке, если отклонить запрос не удалось. |
(#131203) Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности. |
<ERROR_TITLE>Нить |
Заголовок сообщения об ошибке, если отклонить запрос не удалось. |
Не удалось добавить участника в группу |
<ERROR_DETAILS>Нить |
Подробности ошибки, если отклонить запрос не удалось. |
Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности. |
Удалить группу
Этот конечный пункт удаляет группу и всех участников, включая компанию. Тело запроса не требуется.
Запрос свойств
| Заполнитель | Описание | Пример значения |
|---|---|---|
<GROUP_ID>Нить |
Необходимый
Идентификатор группы, которую вы хотите удалить. |
Y2FwaV9ncm91cDoxOTUwNTU1MDA3OToxMjAzNjMzOTQzMjAdOTY0MTUZD |
Веб-хуки статуса групповых сообщений
При отправке сообщения группе вы получаете веб-перехватчик статуса, когда сообщение доставлено или прочитано участниками группы.
Веб-хуки статусов для отдельных участников группы могут быть объединены в один веб-хук, содержащий несколько объектов
статуса statuses . Однако агрегирование не гарантируется. Если статусы нескольких участников генерируются приблизительно в одно и то же время, они могут быть объединены в один веб-хук. Если статусы генерируются в разное время, вы можете получать отдельные веб-хуки для каждого участника.Каждый веб-хук всегда ссылается только на одно сообщение, отправленное одной группе и имеющее один тип статуса (например,
доставлено ). Статусы для разных сообщений, групп или типов статусов никогда не объединяются в один веб-хук.Полный справочник по полезной нагрузке веб-перехватчика см. в справочнике по веб-перехватчикам сообщений о состоянии .
Информация о ценах
Сообщения о состоянии , содержащие веб-хуки с информацией о ценах, будут иметь
group_marketing - Обозначает групповое маркетинговое обсуждение.group_utility — указывает на групповой разговор.group_service — указывает на групповой диалог службы.
Комментарии отсутствуют
Комментарии отсутствуют