telegram api method · layer 229 · #cbc6d107
messages.addChatUser
Adds a user to a chat and sends a service message on it.
definition
messages.addChatUser#cbc6d107 chat_id:long user_id:InputUser fwd_limit:int = messages.InvitedUsers;
parameters
| name | type | description |
|---|---|---|
chat_id | long | Chat ID |
user_id | InputUser | User ID to be added |
fwd_limit | int | Number of last messages to be forwarded |
returns
errors (20)
| code | error | description |
|---|---|---|
| 400 | BOT_GROUPS_BLOCKED | This bot can't be added to groups. |
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 400 | CHAT_ID_INVALID | The provided chat id is invalid. |
| 400 | CHAT_INVALID | Invalid chat. |
| 400 | CHAT_MEMBER_ADD_FAILED | Could not add participants. |
| 400 | INPUT_USER_DEACTIVATED | The specified user was deleted. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | USER_ALREADY_PARTICIPANT | The user is already in the group. |
| 400 | USER_ID_INVALID | The provided user ID is invalid. |
| 400 | USER_IS_BLOCKED | You were blocked by this user. |
| 400 | USER_NOT_MUTUAL_CONTACT | The provided user is not a mutual contact. |
| 400 | USERS_TOO_MUCH | The maximum number of users has been exceeded (to create a chat, for example). |
| 400 | YOU_BLOCKED_USER | You blocked this user. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 403 | CHAT_WRITE_FORBIDDEN | You can't write in this chat. |
| 403 | USER_NOT_MUTUAL_CONTACT | The provided user is not a mutual contact. |
| 403 | USER_PRIVACY_RESTRICTED | The user's privacy settings do not allow you to do this. |
history
present in layers 2–229 · constructor id changed 3×
| id | layers |
|---|---|
| #2ee9ee9e | 2–23 |
| #f9a0aa09 | 46–132 |
| #f24753e3 | 133–176 |
| #cbc6d107 | 177–229 |