messages.startBot

Start a conversation with a bot using a deep linking parameter

 Method schema is available as of layer 41. Switch »

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
random_id long Random ID to avoid resending the same message
start_param string Deep linking parameter

Result

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.

Related pages

Deep links

Telegram clients must handle special tg:// and t.me deep links encountered in messages, link entities and in other apps by registering OS handlers.

Go up