editchatinvitelink
editchatinvitelink — изменяет параметры существующей дополнительной (вторичной) пригласительной ссылки, созданной ботом.
📝 Назначение
Используется для изменения настроек ранее созданной дополнительной пригласительной ссылки: названия, срока действия, лимита участников или режима одобрения заявок.
Когда это нужно:
- Продлить срок действия временной ссылки
- Уменьшить или увеличить лимит участников
- Изменить название ссылки для удобства администрирования
- Включить или отключить режим одобрения заявок
💡 Совет: Редактировать можно только ссылки, созданные самим ботом через
createchatinvitelink. Основную ссылку чата (получаемую черезexportchatinvitelink) изменить нельзя — только перевыпустить.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat_id | Integer/String | ✅ Да | ID группы/канала или @username |
| invite_link | String | ✅ Да | Полная ссылка-приглашение для редактирования |
| name | String | ❌ Нет | Новое название ссылки (0–32 символа) |
| expire_date | Integer | ❌ Нет | Новый Unix timestamp, когда ссылка истечёт |
| member_limit | Integer | ❌ Нет | Новый лимит участников (1–99999) |
| creates_join_request | Boolean | ❌ Нет | Новое значение: требуется ли одобрение заявки |
⚠️ Важно: Параметры
member_limitиcreates_join_requestвзаимоисключающие. Еслиcreates_join_requestвключён,member_limitуказывать нельзя.
📍 Результат
После выполнения реакции результат доступен в переменной:
${response.result}
Структура результата — объект ChatInviteLink с полями:
| Поле | Описание |
|---|---|
invite_link |
Ссылка-приглашение |
name |
Название ссылки |
expire_date |
Дата истечения (Unix timestamp) |
member_limit |
Лимит участников |
creates_join_request |
Требуется ли одобрение заявки |
is_primary |
Основная ли ссылка (false для дополнительных) |
is_revoked |
Отозвана ли ссылка |
🔐 Требуемые права бота
| Право | Описание |
|---|---|
| Бот — администратор чата | Обязательное условие |
| can_invite_users | Право приглашать пользователей |
⚠️ Важно: Без права
can_invite_usersреакция вызовет ошибку.
🧪 Примеры использования
Пример 1: Изменение срока действия ссылки
Задача: Продлить срок действия ссылки на 2 часа.
Параметры editchatinvitelink:
chat_id:${chat.id}invite_link:${invite_link}expire_date:!{time|value:now; plus:2h; output_format:unix}
Пример 2: Изменение лимита участников
Задача: Увеличить лимит участников до 100 человек.
Параметры editchatinvitelink:
chat_id:${chat.id}invite_link:${invite_link}member_limit:100
Пример 3: Изменение названия ссылки
Задача: Дать ссылке понятное имя для администрирования.
Параметры editchatinvitelink:
chat_id:${chat.id}invite_link:${invite_link}name:Новая ссылка для мероприятия
Пример 4: Включение режима одобрения заявок
Задача: Сделать так, чтобы все вступления по ссылке требовали одобрения администратора.
Параметры editchatinvitelink:
chat_id:${chat.id}invite_link:${invite_link}creates_join_request:true
Пример 5: Снятие всех ограничений
Задача: Удалить временные ограничения и лимит участников.
Параметры editchatinvitelink:
chat_id:${chat.id}invite_link:${invite_link}expire_date:0member_limit:0
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| Редактирование несуществующей ссылки | Telegram вернёт ошибку |
| Редактирование ссылки, созданной не ботом | Невозможно (ошибка) |
| member_limit и creates_join_request одновременно | Telegram вернёт ошибку |
| name длиннее 32 символов | Telegram вернёт ошибку |
| expire_date в прошлом | Ссылка станет недействительной |
| Бот не администратор | Реакция вызовет ошибку |
| У бота нет права can_invite_users | Реакция вызовет ошибку |
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| createchatinvitelink | Создать новую дополнительную ссылку |
| exportchatinvitelink | Получить основную ссылку |
| revokechatinvitelink | Отозвать дополнительную ссылку |