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.