> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/russkii/api-1msg/gruppovye-chaty-group-messaging-api-beta.md).

# Групповые чаты (Group Messaging API)⚡️Beta

**Group Messaging API** — beta-функциональность WhatsApp Business API, позволяющая создавать групповые чаты и обмениваться сообщениями с несколькими участниками через API.

Функциональность расширяет стандартные 1:1-диалоги WhatsApp и предназначена для ограниченных сценариев группового взаимодействия.

{% hint style="warning" %}

## Условия доступа  

Для использования Group Messaging API должны выполняться следующие условия:

* WhatsApp Business аккаунт имеет статус[ **Official Business Account (OBA)** ](https://help.1msg.io/docs/russkii/whatsapp/poluchenie-zelenoi-galochki)✅
* Лимит бизнес-инициированных сообщений: **не менее 100 000 сообщений за 24 часа.** Проверить ваш лимит можете при помощи метода[ /status. ](https://docs.1msg.io/#tag/Channel/operation/getStatus)
  {% endhint %}

### Создание и подключение к группам

{% stepper %}
{% step %}

### Создание группы

Группа создаётся через API 1MSG. \
При создании формируется **уникальная ссылка-приглашение**.
{% endstep %}

{% step %}

### Вступление в группу

**Вступление в группу возможно только по ссылке-приглашению**

Вы отправляете ссылку приглашение нужным номерам, пользователь самостоятельно принимает решение о вступлении в группу.

Пока принимаются только до 8 участников на группу. 
{% endstep %}

{% step %}

### Обмен сообщениями в группе

Отправка сообщений в группу выполняется через стандартный endpoint, как при стандартных 1:1-диалоге. Единственное chatID меняет длину и оканчивается на @g.us
{% endstep %}

{% step %}

### Получение сообщений и статусов

Входящие сообщения из групп поступают на стандартный webhook
{% endstep %}
{% endstepper %}

### Ограничения ( от WABA) 

#### Ограничения по группам: 

* Максимальное количество участников в группе: **до 8**
* Максимальное количество групп на один номер: **до 10 000**
* Поддерживаемые типы сообщений: 
  * текстовые сообщения;
  * медиа-сообщения;
  * шаблонные сообщения (text / media templates).

### Поддержка

Group Messaging API находится в стадии **beta-тестирования. Функциональность не рекомендуется для критичных бизнес-процессов.** 

Если вы столкнулись с ошибками или нестабильной работой Group Messaging AP  — **обратитесь в службу поддержки**

### Методы Groups API 1msg.io

Раздел **Groups** содержит методы для управления групповыми чатами. Все методы работают через API и позволяют создавать, изменять, просматривать и удалять группы, а также управлять участниками и ссылками-приглашениями.

Ссылка на документацию:

{% embed url="<https://docs.1msg.io/#tag/Groups>" %}

Кратко по методам:

**Create a Group:** создаёт новую группу. Возвращает идентификатор созданной группы и другие метаданные.

**Get Groups List:** возвращает список всех групп, созданных на текущем канале.

**Get Group Info:** получает подробную информацию о конкретной группе по её идентификатору.

**Update Group:** обновляет параметры существующей группы (например, название, описание).

**Delete Group:** удаляет группу.

**Get Invite Link:** возвращает текущую ссылку-приглашение для доступа к группе (для приглашения участников).

**Reset Invite Link:** генерирует новую ссылку-приглашение для группы, заменяя старую. Полезно для блокировки предыдущих приглашений.

**Remove Participants:** удаляет одного или нескольких участников из группы.