editchatinvitelink
editchatinvitelink — изменяет параметры существующей дополнительной (вторичной) пригласительной ссылки, созданной ботом.
📝 Назначение
Используется для изменения настроек ранее созданной дополнительной пригласительной ссылки: названия, срока действия, лимита участников или режима одобрения заявок.
Когда это нужно:
- Продлить срок действия временной ссылки
- Уменьшить или увеличить лимит участников
- Изменить название ссылки для удобства администрирования
- Включить или отключить режим одобрения заявок
💡 Совет: Редактировать можно только ссылки, созданные самим ботом через
createchatinvitelink. Основную ссылку чата (получаемую черезexportchatinvitelink) изменить нельзя — только перевыпустить.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat_id | Integer/String | ✅ Да | ID группы/канала или @username |
| invite_link | String | ✅ Да | Полная ссылка-приглашение для редактирования |
| name | String | ❌ Нет | Новое название ссылки (0–32 символа) |
| expire_date | String | ❌ Нет | Новый срок, когда ссылка истечёт. Пустое значение — срок снимается |
| member_limit | Integer | ❌ Нет | Новый лимит участников (1–99999) |
| creates_join_request | Boolean | ❌ Нет | Новое значение: требуется ли одобрение заявки |
⚠️ Важно: Параметры
member_limitиcreates_join_requestвзаимоисключающие. Еслиcreates_join_requestвключён,member_limitуказывать нельзя.
⚠️ Важно: Незаполненные параметры Telegram сбрасывает к значениям по умолчанию. Реакция, меняющая только
name, заодно снимет со ссылки срок действия и лимит участников — указывайте все параметры, которые нужно сохранить.
📅 Формат expire_date
Параметр принимает срок в том же формате, что «Динамическая отсрочка» отложенных действий. Макрос для этого не нужен — достаточно написать срок прямо в поле.
| Формат | Пример | Результат |
|---|---|---|
| Относительный срок | 1h, 30m, 7d |
Через указанное время |
| Комбинированный | 1d2h30m15s |
Через день, 2 часа, 30 минут и 15 секунд |
| Полная дата и время | 12.05.2025 15:30 |
В указанный момент |
| Дата без года | 12.05 15:30 |
Ближайшее 12 мая |
| Только время | 15:30 |
Сегодня в 15:30, а если время уже прошло — завтра |
| Особые значения | завтра 08:00, выходной 10:00, будний 09:00 |
В указанный момент |
| День недели | понедельник 09:30, пн 09:30 |
Ближайший такой день |
| Unix-время | 1748880000 |
Конкретный момент, в секундах |
Единицы относительного срока: s — секунды, m — минуты, h — часы, d — дни. Можно и кириллицей: с, м, ч, д — например 1ч30м.
💡 Совет: Оставьте поле пустым, чтобы снять со ссылки срок действия. Значение
0для этого не подходит — реакция завершится ошибкой.
⚠️ Важно: Срок в прошлом реакция не примет — она завершится ошибкой, ссылка останется без изменений.
📍 Результат
После выполнения реакции результат доступен в переменной:
${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:2h
Пример 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: оставить пустымmember_limit: оставить пустым
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| Редактирование несуществующей ссылки | Telegram вернёт ошибку |
| Редактирование ссылки, созданной не ботом | Невозможно (ошибка) |
| member_limit и creates_join_request одновременно | Telegram вернёт ошибку |
| name длиннее 32 символов | Telegram вернёт ошибку |
| expire_date в прошлом | Реакция завершается ошибкой, ссылка не меняется |
| expire_date пустой | Срок действия со ссылки снимается |
| Бот не администратор | Реакция вызовет ошибку |
| У бота нет права can_invite_users | Реакция вызовет ошибку |
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| createchatinvitelink | Создать новую дополнительную ссылку |
| exportchatinvitelink | Получить основную ссылку |
| revokechatinvitelink | Отозвать дополнительную ссылку |