Ссылки-приглашения

Ссылки-приглашения

Все методы требуют право invite_users.

exportChatInviteLink

Возвращает основную ссылку чата.

GET ?method=exportChatInviteLink&chat_id=123

{ "ok": true, "result": "https://msg.kodari.ru/?invite=abc123" }

Если у чата ещё нет основной ссылки — 404 No invite link; создайте её через createChatInviteLink.

createChatInviteLink

Создаёт дополнительную ссылку с ограничениями.

{
  "chat_id": 123,
  "name": "Набор в июне",
  "expire_date": 1751328000,
  "member_limit": 50
}

Ответ:

{
  "ok": true,
  "result": {
    "id": 7,
    "chat_id": 123,
    "hash": "xyz789",
    "name": "Набор в июне",
    "created_by": 42,
    "expires_at": "2026-07-01 00:00:00",
    "member_limit": 50,
    "uses_count": 0,
    "revoked": 0,
    "invite_link": "https://msg.kodari.ru/?invite=xyz789"
  }
}

Журнал: invite_created.

revokeChatInviteLink

Отзывает ссылку — по ней больше нельзя вступить.

{ "chat_id": 123, "invite_link": "https://msg.kodari.ru/?invite=xyz789" }

В invite_link можно передать как полный URL, так и голый хэш. Журнал: invite_revoked.

Ошибки: 400 — нет chat_id или invite_link; 403 — нет права invite_users; 404 — ссылка не найдена или принадлежит другому чату.

pykodaribot

link = await bot.export_chat_invite_link(chat_id)

invite = await bot.create_chat_invite_link(
    chat_id,
    name="Набор в июне",
    expire_date=int(time.time()) + 7 * 24 * 3600,
    member_limit=50,
)
print(invite.invite_link, invite.member_limit)

await bot.revoke_chat_invite_link(chat_id, invite.invite_link)