# Групповые чаты (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:** удаляет одного или нескольких участников из группы.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.1msg.io/docs/russkii/api-1msg/gruppovye-chaty-group-messaging-api-beta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.