Working with Chats and Channels


These examples assume you have read The Full API.

Joining a chat or channel

Note that Chat are normal groups, and Channel are a special form of Chat, which can also be super-groups if their megagroup member is True.

Joining a public channel

Once you have the entity of the channel you want to join to, you can make use of the JoinChannelRequest to join such channel:

from import JoinChannelRequest
await client(JoinChannelRequest(channel))

# In the same way, you can also leave such channel
from import LeaveChannelRequest
await client(LeaveChannelRequest(input_channel))

For more on channels, check the channels namespace.

Joining a private chat or channel

If all you have is a link like this one:, you already have enough information to join! The part after the, this is, AAAAAFFszQPyPEZ7wgxLtd on this example, is the hash of the chat or channel. Now you can use ImportChatInviteRequest as follows:

from import ImportChatInviteRequest
updates = await client(ImportChatInviteRequest('AAAAAEHbEkejzxUjAUCfYg'))

Adding someone else to such chat or channel

If you don’t want to add yourself, maybe because you’re already in, you can always add someone else with the AddChatUserRequest, which use is very straightforward, or InviteToChannelRequest for channels:

# For normal chats
from import AddChatUserRequest

# Note that ``user_to_add`` is NOT the name of the parameter.
# It's the user you want to add (``user_id=user_to_add``).
await client(AddChatUserRequest(
    fwd_limit=10  # Allow the user to see the 10 last messages

# For channels (which includes megagroups)
from import InviteToChannelRequest

await client(InviteToChannelRequest(

Note that this method will only really work for friends or bot accounts. Trying to mass-add users with this approach will not work, and can put both your account and group to risk, possibly being flagged as spam and limited.

Increasing View Count in a Channel

It has been asked quite a few times (really, many), and while I don’t understand why so many people ask this, the solution is to use GetMessagesViewsRequest, setting increment=True:

# Obtain `channel' through dialogs or through client.get_entity() or anyhow.
# Obtain `msg_ids' through `.get_messages()` or anyhow. Must be a list.

await client(GetMessagesViewsRequest(

Note that you can only do this once or twice a day per account, running this in a loop will obviously not increase the views forever unless you wait a day between each iteration. If you run it any sooner than that, the views simply won’t be increased.