Home › Methods › Messages › StartBot
Layer 220

MessagesStartBot

Start a conversation with a bot using a deep linking parameter

method Users
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
RandomId long Random ID to avoid resending the same message
StartParam string Deep linking parameter

Returns

Updates

Possible Errors

Code Type Description
400 BOT_INVALID This is not a valid bot.
400 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.
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.
500 RANDOM_ID_DUPLICATE You provided a random ID that was already used.
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.

Gogram Example

// MessagesStartBot - positional arguments
result, err := client.MessagesStartBot(&tg.InputUserSelf{}, &tg.InputPeerUser{UserID: int64(123456789)}, int64(0), "...")
if err != nil {
    // handle error
}
// result is *tg.Updates