AddMembers.md

AddMembers

dev.max.ru/docs-api/methods/POST/chats/-chatId-/members

Добавляет участников в групповой чат. Для этого могут потребоваться дополнительные права

Запрос {#request}

Поля запроса {#request-parameters}

Поле	Тип	Обязательный	Описание
ChatID	integer	Да	ID чата
UserIDs	array	Да	Массив ID добавляемых пользователей

Пример запроса {#request-example}

response, err := bot.Chats.AddMembers(
    context.Background(), 
    &models.AddMembersReq{
        ChatID:  123456789,
        UserIDs: []int{77777, 88888},
    }
)

Ответ {#response}

Поля ответа {#response-parameters}

Поле	Тип	Описание
success	boolean	true, если запрос был успешным,false — в противном случае
message	string	Объяснительное сообщение, если результат не был успешным
failed_user_ids	array	Массив ID пользователей, которых не удалось добавить
failed_user_details	object	Детальная информация об ошибках для каждого пользователя

Поля объекта FailedUserDetails {#failedUserDetails}

Поле	Тип	Описание
error_code	string	Код ошибки Возможные значения:
		add.participant.privacy — ошибки конфиденциальности при добавлении пользователей
		add.participant.not.found — пользователи не найдены
user_ids	array	ID пользователей с данной ошибкой

Пример тела ответа {#response-example-body}

Успех:

{
    "success": true,
}

Ошибка:

{
    "success": false,
    "failed_user_ids": [
        123456789
    ],
    "failed_user_details": [
        {
            "error_code": "add.participant.not.found",
            "user_ids": [
                123456789
            ]
        }
    ]
}