messages.requestWebView

Open a bot web app, sending over user information after user confirmation.

After calling this method, until the user closes the webview, messages.prolongWebView must be called every 60 seconds.

webViewResultUrl#c14557c query_id:long url:string = WebViewResult;
---functions---
messages.requestWebView#178b480b flags:# from_bot_menu:flags.4?true silent:flags.5?true peer:InputPeer bot:InputUser url:flags.1?string start_param:flags.3?string theme_params:flags.2?DataJSON platform:string reply_to_msg_id:flags.0?int top_msg_id:flags.9?int send_as:flags.13?InputPeer = WebViewResult;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
from_bot_menu flags.4?true Whether the webview was opened by clicking on the bot's menu button ».
silent flags.5?true Whether the inline message that will be sent by the bot on behalf of the user once the web app interaction is terminated should be sent silently (no notifications for the receivers).
peer InputPeer Dialog where the web app is being opened, and where the resulting message will be sent (see the docs for more info »).
bot InputUser Bot that owns the web app
url flags.1?string Web app URL
start_param flags.3?string If the web app was opened from the attachment menu using a attachment menu deep link, start_param should contain the data from the startattach parameter.
theme_params flags.2?DataJSON Theme parameters »
platform string Short name of the application; 0-64 English letters, digits, and underscores
reply_to_msg_id flags.0?int Whether the inline message that will be sent by the bot on behalf of the user once the web app interaction is terminated should be sent in reply to this message ID.
top_msg_id flags.9?int This field must contain the topic ID only when replying to messages in forum topics different from the "General" topic (i.e. reply_to_msg_id is set and reply_to_msg_id != topicID and topicID != 1).
If the replied-to message is deleted before the method finishes execution, the value in this field will be used to send the message to the correct topic, instead of the "General" topic.
send_as flags.13?InputPeer Open the web app as the specified peer, sending the resulting the message as the specified peer.

Result

WebViewResult

Related pages

Bot menu button

Bots can choose the behavior of the menu button shown next to the text input field.

messages.sendWebViewResultMessage

Terminate webview interaction started with messages.requestWebView, sending the specified message to the chat on behalf of the user.

Bot web apps

Bots can offer users interactive HTML5 web apps to completely replace any website.

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.

Forums

Telegram allows creating forums with multiple distinct topics.

Web Apps for Bots

messages.prolongWebView

Indicate to the server (from the user side) that the user is still using a web app.

If the method returns a QUERY_ID_INVALID error, the webview must be closed.