На этой странице собраны методы, которые позволяют создавать и редактировать групповые чаты WhatsApp по API, получать информацию о группах. Узнайте в нашей инструкции больше о том, как работают групповые чаты в Wazzup.

Создание группового чата

Метод помогает создать новый групповой чат WhatsApp и добавить в него участников.

Если кто-то из контактов запретил в настройках мессенджера добавлять его в групповые чаты, этому контакту придёт приглашение вступить в группу.

Метод POST /v2/groups

Пример запроса:

curl -L 'https://tech.wazzup24.com/v2/groups
-H 'Authorization: Bearer <client_access_token>'

{
"channel_id": "87d624ba-1cca-4ae3-a348-2dc0b56b8930",
"type": "whatsapp",
"name": "Новая группа",
"avatar_url": "https://example.com/avatar.jpg",
"members": [
{
"phone": "+79151231234",
"name": "Иван"
}
]
}

Пример ответа:

{
"data": {
"group_id": "e0de64bf-05b5-412a-a8bc-183acc307b",
"name": "Новая группа",
"avatar_url": "https://example.com/group-avatar.jpg",
"has_settings_access": true,
"members": [
{
"group_member_id": "044e21af-bab4-473c-9fb6-9b3d08023721",
"name": "Иван",
"avatar_url": "https://example.com/avatar1.jpg",
"is_admin": false,
"status": "in_group",
"is_you": true
}
]
},
"meta": {
"timestamp": 1762372409
}
}

Результат: Информация о созданном групповом чате.

Получение информации о группе

Метод помогает получить данные о группе. Также вы можете подписаться на вебхуки, чтобы сразу узнавать об изменениях в групповых чатах.

Метод GET /v2/groups/{group_id}

Path-параметры
group_id — ID группового чата

Пример запроса:

curl -L 'https://tech.wazzup24.com/v2/groups/e0de64bf-05b5-412a-a8bc-183acc307b' -H 'Authorization: Bearer <client_access_token>'

Пример ответа:

{
"data": {
"name": "Новая группа",
"avatar_url": "https://example.com/group-avatar.jpg",
"has_settings_access": true,
"members": [
{
"group_member_id": "813e884b-617c-4c17-ae8d-ba2fd0c0cb6e",
"name": "Иван",
"avatar_url": "https://example.com/avatar1.jpg",
"is_admin": false,
"status": "in_group",
"is_you": true
}
]
},
"meta": {
"timestamp": 1762372409
}
}

Результат: Информация о групповом чате.

Обновление аватара или названия группы

Метод PATCH /v2/groups/{group_id}

Path-параметры
group_id — ID группового чата

Пример запроса:

curl -L 'https://tech.wazzup24.com/v2/groups/e0de64bf-05b5-412a-a8bc-183acc307b'
-H 'Authorization: Bearer <client_access_token>'

{
"name": "Группа",
"avatar_url": "https://example.com/avatar.jpg"
}

Пример ответа:

{
"data": null,
"meta": {
"timestamp": 1762372409
}
}

Результат: Информация о групповом чате изменена.

Добавление участников в группу

Метод POST /v2/groups/{group_id}/members

Path-параметры
group_id — ID группового чата

Пример запроса:

curl -L 'https://tech.wazzup24.com/v2/groups/e0de64bf-05b5-412a-a8bc-183acc307b'
-H 'Authorization: Bearer <client_access_token>'

[
{
"phone": "+79151231234",
"name": "Иван"
}
]

Пример ответа:

{
"data": [
{
"group_member_id": "d1b504f7-2202-42c5-a799-b019f6485",
"name": "Иван",
"avatar_url": "https://example.com/avatar1.jpg",
"is_admin": false,
"status": "in_group",
"is_you": true
}
],
"meta": {
"timestamp": 1762372409
}
}

Результат В группу добавлен новый участник.

Удаление участника

Метод DELETE /v2/groups/{group_id}/members

Path-параметры
group_id — ID группового чата

Параметры запроса
group_member_id — ID участника группы. Приходит в ответе при создании группы, добавлении участника или запросе информации о групповом чате.

Пример запроса:

curl -L 'https://tech.wazzup24.com/v2/groups/e0de4bf-05b5-412a-a8bc-183ac307b'
-H 'Authorization: Bearer <client_access_token>'

[
{
"group_member_id": "579cfe-a27d-48d0-934a-a2e1e37de634"
}
]

Пример ответа:

{
"data": null,
"meta": {
"timestamp": 1762372409
}
}

Результат: Из группы удалён участник.

Изменение имени участника

В Wazzup можно переименовать участника группового чата, чтобы пользователю было проще понять, с кем он общается. Например, назвать участника Валерия «Бухгалтер Валерий». Имя участника изменится только в группе Wazzup и останется прежним в мессенджере.

Метод PATCH /v2/groups/{group_id}/members

Path-параметры
group_id — ID группового чата

Пример запроса:

curl -L 'https://tech.wazzup24.com/v2/groups/e064bf-05b5-412a-a8bc-183acc307b'
-H 'Authorization: Bearer <client_access_token>'

[
{
"group_member_id": "8bd17f-c415-4bf7-93db-a4098e8de7b9",
"name": "Иван"
}
]

Пример ответа:

{
"data": null,
"meta": {
"timestamp": 1762372409
}
}

Результат: Участник группы переименован.