exportchatinvitelink
exportchatinvitelink — генерирует новую основную (первичную) пригласительную ссылку для чата или канала.
📝 Назначение
Используется для получения основной пригласительной ссылки чата. При вызове этой реакции старая основная ссылка аннулируется, а новая генерируется автоматически.
Когда это нужно:
- Получить основную ссылку-приглашение для чата
- Перевыпустить ссылку, если старая была скомпрометирована
- Получить ссылку для автоматического приглашения новых участников
⚠️ Важно: В отличие от
createchatinvitelink, эта реакция работает только с основной ссылкой чата. Основная ссылка — это ссылка, которая отображается в настройках чата (не имеет срока действия и лимита участников, если не настроено иное). При каждом вызове старая основная ссылка становится недействительной.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat_id | Integer/String | ✅ Да | ID чата/канала или @username |
📍 Результат
После выполнения реакции результат доступен в переменной:
${response.result}
Тип значения: String — полная URL-ссылка для приглашения.
Пример результата:
https://t.me/joinchat/ABC123def456ghi789
🔐 Требуемые права бота
| Право | Описание |
|---|---|
| Бот — администратор чата | Обязательное условие |
| can_invite_users | Право приглашать пользователей |
⚠️ Важно: Без права
can_invite_usersреакция вызовет ошибку.
🧪 Примеры использования
Пример 1: Получение основной ссылки текущего чата
Реакции:
exportchatinvitelink→chat_id:${chat.id}SendMessage→ текст:Пригласительная ссылка: ${response.result}
Пример 2: Перевыпуск ссылки
Задача: Создать новую основную ссылку, аннулировав старую.
Реакции:
exportchatinvitelink→chat_id:${chat.id}SendMessage→ текст:Новая ссылка-приглашение создана: ${response.result}
Пример 3: Получение ссылки по команде администратора
Обработчик: Команда /getlink
Реакции:
exportchatinvitelink→chat_id:${chat.id}SendMessage→ текст:Ссылка для вступления: ${response.result}
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| Основная ссылка не была создана ранее | Генерируется новая ссылка |
| Повторный вызов | Старая ссылка аннулируется, создаётся новая |
| Бот не администратор | Реакция вызовет ошибку |
| У бота нет права can_invite_users | Реакция вызовет ошибку |
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| createchatinvitelink | Создать дополнительную ссылку с ограничениями |
| editchatinvitelink | Изменить параметры дополнительной ссылки |
| revokechatinvitelink | Отозвать дополнительную ссылку |