# Pyrofork - Telegram MTProto API Client Library for Python # Copyright (C) 2017-present Dan # Copyright (C) 2022-present Mayuri-Chan # # This file is part of Pyrofork. # # Pyrofork is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published # by the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Pyrofork is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with Pyrofork. If not, see . from datetime import datetime from typing import Union import pyrogram from pyrogram import raw, utils from pyrogram import types class CreateChatInviteLink: async def create_chat_invite_link( self: "pyrogram.Client", chat_id: Union[int, str], name: str = None, expire_date: datetime = None, member_limit: int = None, creates_join_request: bool = None, subscription_period: int = None, subscription_price: int = None ) -> "types.ChatInviteLink": """Create an additional invite link for a chat. You must be an administrator in the chat for this to work and must have the appropriate admin rights. The link can be revoked using the method :meth:`~pyrogram.Client.revoke_chat_invite_link`. .. include:: /_includes/usable-by/users-bots.rst Parameters: chat_id (``int`` | ``str``): Unique identifier for the target chat or username of the target channel/supergroup (in the format @username). You can also use chat public link in form of *t.me/* (str). name (``str``, *optional*): Invite link name. expire_date (:py:obj:`~datetime.datetime`, *optional*): Point in time when the link will expire. Defaults to None (no expiration date). member_limit (``int``, *optional*): Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999. Defaults to None (no member limit). creates_join_request (``bool``, *optional*): True, if users joining the chat via the link need to be approved by chat administrators. If True, member_limit can't be specified. subscription_period (``int``, *optional*): Date when the subscription will expire. for now, only 30 days is supported (30*24*60*60). subscription_price (``int``, *optional*): Subscription price (stars). Returns: :obj:`~pyrogram.types.ChatInviteLink`: On success, the new invite link is returned. Example: .. code-block:: python # Create a new link without limits link = await app.create_chat_invite_link(chat_id) # Create a new link for up to 3 new users link = await app.create_chat_invite_link(chat_id, member_limit=3) # Create subcription link link = await app.create_chat_invite_link(chat_id, subscription_period=60*24*60*60, subscription_price=1) """ r = await self.invoke( raw.functions.messages.ExportChatInvite( peer=await self.resolve_peer(chat_id), expire_date=utils.datetime_to_timestamp(expire_date), usage_limit=member_limit, title=name, request_needed=creates_join_request, subscription_pricing=raw.types.StarsSubscriptionPricing( period=subscription_period, amount=subscription_price ) if subscription_period and subscription_price is not None else None ) ) return types.ChatInviteLink._parse(self, r)