# Method: messages.startBot

Back to methods index

Start a conversation with a bot using a deep linking parameter

# Parameters:

Name Type Description Required
bot Username, chat ID, Update, Message or InputUser The bot Optional
peer Username, chat ID, Update, Message or InputPeer The chat where to start the bot, can be the bot’s private chat or a group Optional
start_param string Deep linking parameter Yes

# Return type: Updates

# Can bots use this method: NO

# MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$Updates = $MadelineProto->messages->startBot(['bot' => InputUser, 'peer' => InputPeer, 'start_param' => 'string', ]);

Or, if you’re into Lua:

Updates = messages.startBot({bot=InputUser, peer=InputPeer, start_param='string', })

# Errors

Code Type Description
400 BOT_INVALID This is not a valid bot
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
406 AUTH_KEY_DUPLICATED An auth key with the same ID was already generated
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.