Method: messages.startBot

Back to methods index

Start a bot


Name Type Description Required
bot Username, chat ID, Update, Message or InputUser The bot’s ID or username Optional
peer Username, chat ID, Update, Message or InputPeer Where to start the bot (@me or group ID/username) Optional
start_param string The bot’s start parameter Yes

Return type: Updates

Can bots use this method: NO

MadelineProto Example:

if (!file_exists('madeline.php')) {
    copy('', 'madeline.php');
include 'madeline.php';

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

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

PWRTelegram HTTP API example (NOT FOR MadelineProto):

As a user:



bot - Json encoded InputUser

peer - Json encoded InputPeer

start_param - Json encoded string

Or, if you’re into Lua:

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

Errors this method can return:

Error Description
BOT_INVALID This is not a valid bot
PEER_ID_INVALID The provided peer id is invalid
START_PARAM_EMPTY The start parameter is empty
START_PARAM_INVALID Start parameter invalid