export_chat_invite_link()

Generate a new primary invite link for a chat; any previously generated primary link is revoked.

You must be an administrator in the chat for this to work and must have the appropriate admin rights.

Note

Each administrator in a chat generates their own invite links. Bots can’t use invite links generated by other administrators. If you want your bot to work with invite links, it will need to generate its own link using this method – after this the link will become available to the bot via the get_chat() method. If your bot needs to generate a new invite link replacing its previous one, use this method again.

Usable by Users Bots

  • 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/<username> (str).

  • 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).

ChatInviteLink – On success, the invite link is returned.

Example

# Generate a new primary link
link = await app.export_chat_invite_link(chat_id)