messages.requestWebView

Open a bot mini 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.

API section: Working with Mini Bot Apps »

messages.requestWebView#269dc2c1 flags:# from_bot_menu:flags.4?true silent:flags.5?true compact:flags.7?true fullscreen:flags.8?true peer:InputPeer bot:InputUser url:flags.1?string start_param:flags.3?string theme_params:flags.2?DataJSON platform:string reply_to:flags.0?InputReplyTo send_as:flags.13?InputPeer = WebViewResult;

Parameters

NameTypeDescription
flags # Bit mask: a field written flags.N?T is present only when bit N is set.
from_bot_menu flags.4?true
silent flags.5?true Send without sound: the recipient gets no notification.
compact flags.7?true
fullscreen flags.8?true
peer InputPeer The user or chat the request is about.
bot InputUser Bot.
url flags.1?string URL.
start_param flags.3?string Parameter from a ?start=… link.
theme_params flags.2?DataJSON
platform string
reply_to flags.0?InputReplyTo What the message replies to.
send_as flags.13?InputPeer Which identity to send as — a channel or another profile.

Result

WebViewResult

Possible errors

Read out of the handler itself — this is what the server actually returns for this method.

CodeTypeWhat it means
400 URL_INVALID The URL is invalid.

Common to every call

CodeTypeWhat it means
401 AUTH_KEY_UNREGISTERED The server does not know this session: the key was revoked, expired, or the call was made before authorisation.
401 API_ID_INVALID This api_id was never issued or has been blocked. Keys come from my.ansible.su.
400 CONNECTION_LAYER_INVALID The client did not declare a layer, or declared one the server does not know.
420 FLOOD_WAIT_X Too often. Do not retry for X seconds — the number arrives in the error text.
500 INTERNAL A failure on our side. The request may be retried; if it keeps failing, it is a bug of ours.

Related pages

Types used here