telegram api method · layer 229 · #e6df7378

messages.startBot

usable by users

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

nametypedescription
botInputUserThe bot
peerInputPeerThe chat where to start the bot, can be the bot's private chat or a group
random_idlongRandom ID to avoid resending the same message
start_paramstringDeep linking parameter

returns

Updates

errors (12)

codeerrordescription
400BOT_INVALIDThis is not a valid bot.
400BUSINESS_CONNECTION_NOT_ALLOWEDThis 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.
400CHAT_ADMIN_REQUIREDYou must be an admin in this chat to do this.
400INPUT_USER_DEACTIVATEDThe specified user was deleted.
400MSG_ID_INVALIDInvalid message ID provided.
400PEER_ID_INVALIDThe provided peer id is invalid.
400START_PARAM_EMPTYThe start parameter is empty.
400START_PARAM_INVALIDStart parameter invalid.
400START_PARAM_TOO_LONGStart parameter is too long.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403CHAT_WRITE_FORBIDDENYou can't write in this chat.
500RANDOM_ID_DUPLICATEYou provided a random ID that was already used.

history

present in layers 46–229

idlayers
#e6df737846–229