messages.requestAppWebView

Open a bot web app from a named bot web app deep link, 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.

appWebViewResultUrl#3c1b4f0d url:string = AppWebViewResult;
---functions---
messages.requestAppWebView#8c5a3b3c flags:# write_allowed:flags.0?true peer:InputPeer app:InputBotApp start_param:flags.1?string theme_params:flags.2?DataJSON platform:string = AppWebViewResult;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
write_allowed flags.0?true Set this flag if the bot is asking permission to send messages to the user as specified in the named bot web app deep link docs, and the user agreed.
peer InputPeer If the client has clicked on the link in a Telegram chat, pass the chat's peer information; otherwise pass the bot's peer information, instead.
app InputBotApp The app obtained by invoking messages.getBotApp as specified in the named bot web app deep link docs.
start_param flags.1?string If the startapp query string parameter is present in the named bot web app deep link, pass it to start_param.
theme_params flags.2?DataJSON Theme parameters ยป
platform string Short name of the application; 0-64 English letters, digits, and underscores

Result

AppWebViewResult

Bots can use this method

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.

messages.getBotApp

Obtain information about a named bot web app

Bot web apps

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

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.