# Method: messages.startBot
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');
$MadelineProto->start();
$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.