telegram api method · layer 229 · #e6df7378
messages.startBot
Start a conversation with a bot using a deep linking parameter
definition
messages.startBot#e6df7378 bot:InputUser peer:InputPeer random_id:long start_param:string = Updates;
parameters
| name | type | description |
|---|---|---|
bot | InputUser | The bot |
peer | InputPeer | The chat where to start the bot, can be the bot's private chat or a group |
random_id | long | Random ID to avoid resending the same message |
start_param | string | Deep linking parameter |
returns
errors (12)
| code | error | description |
|---|---|---|
| 400 | BOT_INVALID | This is not a valid bot. |
| 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 | 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 | START_PARAM_EMPTY | The start parameter is empty. |
| 400 | START_PARAM_INVALID | Start parameter invalid. |
| 400 | START_PARAM_TOO_LONG | Start parameter is too long. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | CHAT_WRITE_FORBIDDEN | You can't write in this chat. |
| 500 | RANDOM_ID_DUPLICATE | You provided a random ID that was already used. |
history
present in layers 46–229
| id | layers |
|---|---|
| #e6df7378 | 46–229 |