Управление группами | Документация для разработчиков
Управление группой
Обновлено: 25 марта 2026 г
Обзор
API для работы с группами предоставляет простые функции для управления группами на протяжении всего их жизненного цикла.
При создании новой группы создается ссылка-приглашение для приглашения участников в группу.
Поскольку добавлять участников в группу вручную невозможно, просто отправьте сообщение со ссылкой-приглашением пользователям WhatsApp, которых вы хотели бы пригласить в группу.
Функции управления группами
Чтобы узнать, как отправлять сообщения группам, обратитесь к справочнику по групповым сообщениям .
Подписаться на веб-хуки метаданных групп
Для получения уведомлений через веб-перехватчики о метаданных ваших групп, пожалуйста, подпишитесь на следующие поля веб-перехватчика:
group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_update
Для получения полной информации о веб-хуках для API групп, пожалуйста, посетите наш справочник по веб-хукам для API групп .
Создавать
группа
пригласительная_ссылкаСинтаксис запроса
ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /группыТекст запроса
{ "messaging_product": "whatsapp", "subject": "<GROUP_SUBJECT> ", "описание": "<GROUP_DESCRIPTION> ", "join_approval_mode": "<JOIN_APPROVAL_MODE> " }
Параметры запроса
| | |
| | |
| | |
| | |
Вебхуки
group_lifecycle_updateГруппа создает и добивается успеха
Создание группы не удалось
Пользователь присоединяется к группе по ссылке-приглашению
Группы, подающие заявки на вступление
Вы можете создавать группы, для присоединения к которым требуется подтверждение запроса. После включения этой функции пользователи WhatsApp, перешедшие по ссылке-приглашению в группу, смогут отправить запрос на вступление в группу или отменить ранее поданный запрос
Когда пользователь WhatsApp присоединяется к группе, отправляя запрос на вступление, срабатывает [
group_participants_update для пользователя, принявшего запрос на вступление] (/documentation/business-messaging/whatsapp/groups/webhooks#user-accepts-or-cancels-join-request). Вы также можете получить список открытых запросов на вступление через API . Используйте содержимое веб-хука или ответа API для одобрения или отклонения запросов.ПолучатьУтвердить запросы на присоединение
Запрос
синтаксис
ПОЛУЧАТЬ /<GROUP_ID> /join_requestsПараметры запроса
<GROUP_ID>Нить
Необходимый.
Идентификатор группы.
Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZDОтвет
синтаксис
{ "data": [ { "join_request_id": "<JOIN_REQUEST_ID> ", "wa_id": "<WHATSAPP_USER_ID> ", "creation_timestamp": "<JOIN_REQUEST_CREATION_TIMESTAMP"> }, // Дополнительные объекты запроса на присоединение будут добавлены, если таковые имеются ], "paging": { "cursors": { "before": "<BEFORE_CURSOR> ", "после": "<AFTER_CURSOR> " } } }
Параметры отклика
<JOIN_REQUEST_ID>Нить
MTY0NjcwNDM1OTU6MTIwMzYzNDA0Njk0MjMzODIw<WHATSAPP_USER_ID>16505551234<JOIN_REQUEST_CREATION_TIMESTAMP>1755548877<BEFORE_CURSOR>eyJvZAmZAzZAXQiOjAsInZAlcnNpb25JZACI6IjE3NTU1NTM3MDUxNzUwNTQ1MTAifQZDZD<AFTER_CURSOR>eyJvZAmZAzZAXQiOjAsInZAlcnNpb25JZACI6IjE3NTU1NTM3MDUxNzUwNTQ1MTAifQZDZDОдобрить запросы на присоединение
Синтаксис запроса
ПОЧТА /<GROUP_ID> /join_requestsТекст запроса
{ "messaging_product": "whatsapp", "join_requests": [ "<JOIN_REQUEST_ID> ", // Здесь будут указаны дополнительные идентификаторы запросов на присоединение, если они утверждаются массово ] }
Параметры запроса
| |
Синтаксис ответа
{ "messaging_product": "whatsapp", "approved_join_requests": [ "<JOIN_REQUEST_ID> ", // Здесь будут указаны дополнительные идентификаторы запросов на присоединение, они утверждаются массово ], // Включается только в случае невозможности утвердить один или несколько запросов на присоединение "failed_join_requests": [ { "join_request_id": "<JOIN_REQUEST_ID> ", "ошибки": [ { "код": "<ERROR_CODE> ", "сообщение": "<ERROR_MESSAGE> ", "заголовок": "<ERROR_TITLE> ", "error_data": { "details": "<ERROR_DETAILS> " } } ] } ], "ошибки": [ { "код": "<ERROR_CODE> ", "сообщение": "<ERROR_MESSAGE> ", "заголовок": "<ERROR_TITLE> ", "error_data": { "details": "<ERROR_DETAILS> " } } ] }
Параметры отклика
| Идентификатор одобренного запроса на присоединение или идентификатор неудачного запроса на присоединение, если мы не смогли его одобрить. |
MTY0NjcwNDM1OTU6MTIwMzYzNDA0Njk0MjMzODIw<ERROR_CODE>Целое число
Код ошибки, если подтверждение не удалось.
131203<ERROR_MESSAGE>Нить
Сообщение об ошибке, если подтверждение не удалось.
(#131203) Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности.<ERROR_TITLE>Нить
Заголовок сообщения об ошибке, если его не удалось утвердить.
Не удалось добавить участника в группу<ERROR_DETAILS>Нить
Подробности ошибки, если подтверждение не удалось.
Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности.Вебхук
group_participants_updateОтклонить запросы на присоединение
Запрос
синтаксис
УДАЛИТЬ /<GROUP_ID> /join_requestsТекст запроса
{ "messaging_product": "whatsapp", "join_requests": [ "<JOIN_REQUEST_ID> ", //Здесь будут указаны дополнительные идентификаторы запросов на присоединение, они будут отклонены массово] }
Параметры запроса
<GROUP_ID>Нить
Необходимый.
Идентификатор группы.
Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD<JOIN_REQUEST_ID>Нить
Необходимый.
Идентификатор запроса на присоединение, который необходимо отклонить.
MTY0NjcwNDM1OTU6MTIwMzYzNDA0Njk0MjMzODIwОтвет
синтаксис
{ "messaging_product": "whatsapp", "rejected_join_requests": [ "<JOIN_REQUEST_ID> ", //Здесь будут указаны дополнительные идентификаторы запросов на присоединение, так как они отклоняются одновременно ], //Включается только в том случае, если не удается отклонить один или несколько запросов на присоединение "failed_join_requests": [ { "join_request_id": "<JOIN_REQUEST_ID> ", "ошибки": [ { "код": "<ERROR_CODE> ", "сообщение": "<ERROR_MESSAGE> ", "заголовок": "<ERROR_TITLE> ", "error_data": { "details": "<ERROR_DETAILS> " } } ] } ], "ошибки": [ { "код": "<ERROR_CODE> ", "сообщение": "<ERROR_MESSAGE> ", "заголовок": "<ERROR_TITLE> ", "error_data": { "details": "<ERROR_DETAILS> " } } ] }
Параметры отклика
<JOIN_REQUEST_ID>Нить
Идентификатор отклоненного запроса на присоединение или идентификатор неудачного запроса на присоединение, если мы не смогли отклонить его.
MTY0NjcwNDM1OTU6MTIwMzYzNDA0Njk0MjMzODIw<ERROR_CODE>Целое число
Код ошибки, если отклонение невозможно.
131203<ERROR_MESSAGE>Нить
Сообщение об ошибке, если отклонить запрос не удалось.
(#131203) Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности.<ERROR_TITLE>Нить
Заголовок сообщения об ошибке, если отклонить запрос не удалось.
Не удалось добавить участника в группу<ERROR_DETAILS>Нить
Подробности ошибки, если отклонить запрос не удалось.
Получатель не принял наши новые Условия предоставления услуг и Политику конфиденциальности.Вебхук
Получать
и сбросить ссылку-приглашение в группу
| |
Получить ссылку-приглашение в группу
Синтаксис запроса
ПОЛУЧАТЬ /<GROUP_ID> /invite_linkОтветный текст
{ "messaging_product": "whatsapp", "invite_link": "https://chat.whatsapp.com/<LINK_ID> " }
пригласительная_ссылкаhttps://chat.whatsapp.com/<LINK_ID>Сбросить ссылку-приглашение в группу
Синтаксис запроса
ПОЧТА /<GROUP_ID> /invite_linkТекст запроса
{ "messaging_product": "whatsapp", }
Ответный текст
{ "messaging_product": "whatsapp", "invite_link": "https://chat.whatsapp.com/<LINK_ID> " }
Отправить шаблон сообщения со ссылкой-приглашением в группу
полезностьШаг 1. Добавьте шаблон ссылки-приглашения в группу в библиотеку шаблонов вашей учетной записи:
GET /message_template_library?category=utility&topic=group_invite_link&language=enШаг 2. Отправьте сообщение по шаблону
Синтаксис запроса
ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /сообщенияПараметры конечной точки
| |
Текст запроса
curl --location 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_PHONE_NUMBER_ID> /messages?access_token=' \ --header 'Content-Type: application/json' \ --data '{ "messaging_product": "whatsapp", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "template", "template": { "name": "<TEMPLATE_NAME> ", "язык": { "код": "<TEMPLATE_LANGUAGE> " }, "components": [ { "type": "body", "parameters": [ { "type": "group_id", "group_id": "<GROUP_ID> " }, { ...дополнительные параметры } ] } ] } }'
Вебхуки
Пользователь присоединяется к группе по ссылке-приглашению
Удалить группу
Этот конечный пункт удаляет группу и всех участников, включая компанию. Тело запроса не требуется.
Запрос
Синтаксис
УДАЛИТЬ /<GROUP_ID>Запрос свойств
<GROUP_ID>Нить
Необходимый
Y2FwaV9ncm91cDoxOTUwNTU1MDA3OToxMjAzNjMzOTQzMjAdOTY0MTUZDВебхуки
group_lifecycle_updateУдаление группы прошло успешно
Удаление группы не удаётся
Удалить участников группы
Синтаксис запроса
УДАЛИТЬ /<GROUP_ID> /участникиТекст запроса
{ "messaging_product": "whatsapp", "participants": [ { "user": "<WHATSAPP_USER_PHONE_NUMBER> или<WHATSAPP_USER_ID> " }, { "пользователь": "<WHATSAPP_USER_PHONE_NUMBER> или<WHATSAPP_USER_ID> "" }, ... ] }
Запрос свойств
| |
Вебхуки
group_participants_updateУчастник группы уходит
Получить информацию о группе
Синтаксис запроса
ПОЛУЧАТЬ /<GROUP_ID> ?fields=<FIELDS>Параметры конечной точки
| | |
| |
Доступные поля
| | |
| | |
| | |
| | |
| | |
| | |
| |
Пример ответа
{ "messaging_product": "whatsapp", "id": "<GROUP_ID> ", "предмет": "<SUBJECT> ", "creation_timestamp": "<TIMESTAMP> ", "приостановленный": "<SUSPENDED> ", "описание": "<DESCRIPTION> ", "total_participant_count": "<TOTAL_PARTICIPANT_COUNT> ", "участники": [ { "wa_id": "<WA_ID> " }, { "wa_id": "<WA_ID> " } ], "join_approval_mode": "<JOIN_APPROVAL_MODE> " }
Привлекайте активные группы
Синтаксис запроса
ПОЛУЧАТЬ /<BUSINESS_PHONE_NUMBER_ID> /группыПараметры запроса
?limit=<LIMIT> , // Необязательно &after=<AFTER_CURSOR> , // Необязательно &before=<BEFORE_CURSOR> // Необязательный
| |
| |
|
Объект ответа
{ "data": { "groups": [ {"id": "GROUP_ID", "subject": SUBJECT, "created_at": "TIMESTAMP"}, {"id": "GROUP_ID", "subject": SUBJECT, "created_at": "TIMESTAMP"} … ] }, "paging": { "cursors": { "after": "MTAxNTExOTQ1MjAwNzI5NDE=", "before": "NDMyNzQyODI3OTQw" }, "previous": "https://graph.facebook.com/VERSION/PHONE_NUMBER_ID/groups?limit=10&before=NDMyNzQyODI3OTQw", "next": "https://graph.facebook.com/VERSION/PHONE_NUMBER_ID/groups?limit=25&after=MTAxNTExOTQ1MjAwNzI5NDE=" } }
Параметры отклика
| |
|
Обновить настройки группы
Синтаксис запроса
ПОЧТА /<GROUP_ID>Текст запроса
{ "messaging_product": "whatsapp", "subject": "<GROUP_SUBJECT> ", "profile_picture_file": "<FILE_PATH> ", "описание": "<GROUP_DESCRIPTION> ", }
Запрос свойств
| | |
| | |
| |
Вебхуки
group_settings_updateОбновление настроек группы прошло успешно
Обновление настроек группы частично завершилось с ошибкой
Обновление настроек группы завершилось неудачей
Веб-хуки статуса групповых сообщений
При отправке сообщения группе вы получаете веб-перехватчик статуса, когда сообщение доставлено или прочитано участниками группы.
Веб-хуки статуса для отдельных участников группы могут быть объединены в один веб-хук, содержащий несколько веб-хуков участниковучастников Статусы генерируются приблизительно в одно и то же время и могут быть объединены в один веб-хук. Если статусы генерируются в разное время, вы можете получать отдельные веб-хуки для каждого участника.
статус объекты в статусы массив. Однако агрегирование не гарантируется. Если несколько Каждый веб-хук всегда ссылается только на одно сообщение, отправленное одной группе и имеющее один тип статуса (например,
доставлено ). Статусы для разных сообщений, групп или типов статусов никогда не объединяются в один веб-хук.Полный справочник по полезной нагрузке веб-перехватчика см. в справочнике по веб-перехватчикам сообщений о состоянии .
Информация о ценах
Сообщения о состоянии , содержащие веб-хуки с информацией о ценах, будут иметь
групповой маркетинг группа утилит группа_служба