EnotPRO Logo EnotPRO

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: Получение основной ссылки текущего чата

Реакции:

  1. exportchatinvitelinkchat_id: ${chat.id}
  2. SendMessage → текст: Пригласительная ссылка: ${response.result}

Пример 2: Перевыпуск ссылки

Задача: Создать новую основную ссылку, аннулировав старую.

Реакции:

  1. exportchatinvitelinkchat_id: ${chat.id}
  2. SendMessage → текст: Новая ссылка-приглашение создана: ${response.result}

Пример 3: Получение ссылки по команде администратора

Обработчик: Команда /getlink

Реакции:

  1. exportchatinvitelinkchat_id: ${chat.id}
  2. SendMessage → текст: Ссылка для вступления: ${response.result}

🔄 Особенности поведения

Ситуация Поведение
Основная ссылка не была создана ранее Генерируется новая ссылка
Повторный вызов Старая ссылка аннулируется, создаётся новая
Бот не администратор Реакция вызовет ошибку
У бота нет права can_invite_users Реакция вызовет ошибку

🔗 Связанные реакции

Реакция Назначение
createchatinvitelink Создать дополнительную ссылку с ограничениями
editchatinvitelink Изменить параметры дополнительной ссылки
revokechatinvitelink Отозвать дополнительную ссылку

🔗 Ссылка на официальную документацию

exportChatInviteLink — Telegram Bot API

© 2025 EnotPRO. Все права защищены.