2022-05-14 00:37:40 +02:00
<!DOCTYPE html>
<html class="">
<head>
<meta charset="utf-8">
<title>messages.setInlineBotResults</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta property="description" content="Answer an inline query, for bots only">
<meta property="og:title" content="messages.setInlineBotResults">
<meta property="og:image" content="">
<meta property="og:description" content="Answer an inline query, for bots only">
<link rel="icon" type="image/svg+xml" href="/img/website_icon.svg?4">
<link rel="apple-touch-icon" sizes="180x180" href="/img/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/img/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/img/favicon-16x16.png">
<link rel="alternate icon" href="/img/favicon.ico" type="image/x-icon" />
<link href="/css/bootstrap.min.css?3" rel="stylesheet">
2022-06-17 17:53:56 +02:00
<link href="/css/telegram.css?231" rel="stylesheet" media="screen">
2022-05-14 00:37:40 +02:00
<style>
</style>
</head>
<body class="preload">
<div class="dev_page_wrap">
<div class="dev_page_head navbar navbar-static-top navbar-tg">
<div class="navbar-inner">
<div class="container clearfix">
<ul class="nav navbar-nav navbar-right hidden-xs"><li class="navbar-twitter"><a href="https://twitter.com/telegram" target="_blank" data-track="Follow/Twitter" onclick="trackDlClick(this, event)"><i class="icon icon-twitter"></i><span> Twitter</span></a></li></ul>
<ul class="nav navbar-nav">
<li><a href="//telegram.org/">Home</a></li>
<li class="hidden-xs"><a href="//telegram.org/faq">FAQ</a></li>
<li class="hidden-xs"><a href="//telegram.org/apps">Apps</a></li>
<li class="active"><a href="/api">API</a></li>
<li class=""><a href="/mtproto">Protocol</a></li>
<li class=""><a href="/schema">Schema</a></li>
</ul>
</div>
</div>
</div>
<div class="container clearfix">
<div class="dev_page">
<div id="dev_page_content_wrap" class=" ">
<div class="dev_page_bread_crumbs"><ul class="breadcrumb clearfix"><li><a href="/api" >API</a></li><i class="icon icon-breadcrumb-divider"></i><li><a href="/methods" >All Methods</a></li><i class="icon icon-breadcrumb-divider"></i><li><a href="/method/messages.setInlineBotResults" >messages.setInlineBotResults</a></li></ul></div>
<h1 id="dev_page_title">messages.setInlineBotResults</h1>
<div id="dev_page_content"><p>Answer an inline query, for bots only</p>
<p><div class="clearfix">
<ul class="dev_layer_select slightly-pull-right nav nav-pills">
<li class="dropdown">
<a class="dropdown-toggle" onclick="return dropdownClick(this, event)" href="#">Layer 139 <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="?layer=1">1 – Base layer</a></li><li><a href="?layer=2">2 – New userpic notifications</a></li><li><a href="?layer=3">3 – Send message can trigger link change</a></li><li><a href="?layer=4">4 – Check-in chats</a></li><li><a href="?layer=5">5 – Localized SMS, localized notifications</a></li><li><a href="?layer=6">6 – Foursquare integration</a></li><li><a href="?layer=7">7 – Added wallPaperSolid</a></li><li><a href="?layer=8">8 – Added end-to-end encryption</a></li><li><a href="?layer=9">9 – Improved big files upload perfomance</a></li><li><a href="?layer=10">10 – Improved chat participants updates</a></li><li><a href="?layer=11">11 – Improved secret chats</a></li><li><a href="?layer=12">12 – New dynamic support</a></li><li><a href="?layer=13">13 – Audio, video MIME; contacts import retry; new secret actions</a></li><li><a href="?layer=14">14 – Notify settings sync, blacklist sync</a></li><li><a href="?layer=15">15 – Modified getHistory offset behaviour</a></li><li><a href="?layer=16">16 – Split sendCode into 2 parts</a></li><li><a href="?layer=17">17 – Added custom typing, introduced message flags</a></li><li><a href="?layer=18">18 – Added usernames</a></li><li><a href="?layer=23">23 – Stickers for secret chats</a></li><li><a href="?layer=105">105 – Scheduled messages, Cloud themes</a></li><li><a href="?layer=108">108 – Login with QR code</a></li><li><a href="?layer=109">109 – Polls v2</a></li><li><a href="?layer=110">110 – People Nearby 2.0, Bank card entity</a></li><li><a href="?layer=111">111 – Folders, Broadcast Stats</a></li><li><a href="?layer=112">112 – Old featured stickers, generic dice, poll timer, poll solution</a></li><li><a href="?layer=113">113 – PSA</a></li><li><a href="?layer=114">114 – Video thumbs for GIFs</a></li><li><a href="?layer=115">115 – Peek Channel Invite</a></li><li><a href="?layer=116">116 – Group Stats, Profile Videos</a></li><li><a href="?layer=117">117 – WebRTC Phone Calls</a></li><li><a href="?layer=118">118 – Callback with 2FA, Countries list</a></li><li><a href="?layer=119">119 – Comments in channels, Threads, Anonymous Admins</a></li><li><a href="?layer=120">120 – Multipins, Message Stats, GeoLive v2</a></li><li><a href="?layer=121">121 – SVG-based Outlines for Stickers</a></li><li><a href="?layer=122">122 – Voice Chats</a></li><li><a href="?layer=123">123 – Voice Chat improvements</a></li><li><a href="?layer=124">124 – Expiring Invite links</a></li><li><a href="?layer=125">125 – Voice Chats in Broadcasts</a></li><li><a href="?layer=126">126 – Ban channels in channels</a></li><li><a href="?layer=127">127 – Payments in channels</a></li><li><a href="?layer=128">128 – Microthumbs for User/Chat profile photos</a></li><li><a href="?layer=129">129 – Video Chats</a></li><li><a href="?layer=130">130 – Custom placeholder for bot reply keyboards</a></li><li><a href="?layer=131">131 – Reset 2FA Password after a week</a></li><li><a href="?layer=132">132 – Chat themes</a></li><li><a href="?layer=133">133 – 64-bit IDs for User/Chat</a></li><li><a href="?layer=134">134 – Chat Requests, Shared Media Calendar</a></li><li><a href="?layer=135">135 – Send Message As a Channel</a></li><li><a href="?layer=136">136 – Reactions</a></li><li><a href="?layer=137">137 – Translations</a></li><li><a href="?layer=138">138 – GIF Sticker Packs</a></li><li><a href="?layer=139"><strong>139 – RTMP streaming</strong></a></li>
<li class="divider"></li>
<li><a href="/api/layers">More...</a></li>
</ul>
</li>
</ul>
</div>
<pre class="page_scheme"><code><a href="/constructor/boolFalse" >boolFalse</a>#bc799737 = <a href="/type/Bool" >Bool</a>;
<a href="/constructor/boolTrue" >boolTrue</a>#997275b5 = <a href="/type/Bool" >Bool</a>;
---functions---
<a href="/method/messages.setInlineBotResults" class="current_page_link" >messages.setInlineBotResults</a>#eb5ea206 flags:<a href="/type/%23" >#</a> gallery:flags.0?true private:flags.1?true query_id:<a href="/type/long" >long</a> results:<a href="/type/Vector%20t" >Vector</a><<a href="/type/InputBotInlineResult" >InputBotInlineResult</a>> cache_time:<a href="/type/int" >int</a> next_offset:flags.2?<a href="/type/string" >string</a> switch_pm:flags.3?<a href="/type/InlineBotSwitchPM" >InlineBotSwitchPM</a> = <a href="/type/Bool" >Bool</a>;</code></pre></p>
<h3><a class="anchor" href="#parameters" id="parameters" name="parameters"><i class="anchor-icon"></i></a>Parameters</h3>
<table class="table">
<thead>
<tr>
<th>Name</th>
<th style="text-align: center;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>flags</strong></td>
<td style="text-align: center;"><a href="/type/%23">#</a></td>
<td>Flags, see <a href="/mtproto/TL-combinators#conditional-fields">TL conditional fields</a></td>
</tr>
<tr>
<td><strong>gallery</strong></td>
<td style="text-align: center;"><a href="/mtproto/TL-combinators#conditional-fields">flags</a>.0?<a href="/constructor/true">true</a></td>
<td>Set this flag if the results are composed of media files</td>
</tr>
<tr>
<td><strong>private</strong></td>
<td style="text-align: center;"><a href="/mtproto/TL-combinators#conditional-fields">flags</a>.1?<a href="/constructor/true">true</a></td>
<td>Set this flag if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query</td>
</tr>
<tr>
<td><strong>query_id</strong></td>
<td style="text-align: center;"><a href="/type/long">long</a></td>
<td>Unique identifier for the answered query</td>
</tr>
<tr>
<td><strong>results</strong></td>
<td style="text-align: center;"><a href="/type/Vector%20t">Vector</a><<a href="/type/InputBotInlineResult">InputBotInlineResult</a>></td>
<td>Vector of results for the inline query</td>
</tr>
<tr>
<td><strong>cache_time</strong></td>
<td style="text-align: center;"><a href="/type/int">int</a></td>
<td>The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300.</td>
</tr>
<tr>
<td><strong>next_offset</strong></td>
<td style="text-align: center;"><a href="/mtproto/TL-combinators#conditional-fields">flags</a>.2?<a href="/type/string">string</a></td>
<td>Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes.</td>
</tr>
<tr>
<td><strong>switch_pm</strong></td>
<td style="text-align: center;"><a href="/mtproto/TL-combinators#conditional-fields">flags</a>.3?<a href="/type/InlineBotSwitchPM">InlineBotSwitchPM</a></td>
<td>If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with a certain parameter.</td>
</tr>
</tbody>
</table>
<h3><a class="anchor" href="#result" id="result" name="result"><i class="anchor-icon"></i></a>Result</h3>
<p><a href="/type/Bool">Bool</a></p>
<h3><a class="anchor" href="#possible-errors" id="possible-errors" name="possible-errors"><i class="anchor-icon"></i></a>Possible errors</h3>
<table class="table">
<thead>
<tr>
<th>Code</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>400</td>
<td>ARTICLE_TITLE_EMPTY</td>
<td>The title of the article is empty.</td>
</tr>
<tr>
<td>400</td>
<td>AUDIO_CONTENT_URL_EMPTY</td>
<td>The remote URL specified in the content field is empty.</td>
</tr>
<tr>
<td>400</td>
<td>AUDIO_TITLE_EMPTY</td>
<td>An empty audio title was provided.</td>
</tr>
<tr>
<td>400</td>
<td>BUTTON_DATA_INVALID</td>
<td>The data of one or more of the buttons you provided is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>BUTTON_TYPE_INVALID</td>
<td>The type of one or more of the buttons you provided is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>BUTTON_URL_INVALID</td>
<td>Button URL invalid.</td>
</tr>
<tr>
<td>400</td>
<td>DOCUMENT_INVALID</td>
<td>The specified document is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>FILE_CONTENT_TYPE_INVALID</td>
<td>File content-type is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>FILE_TITLE_EMPTY</td>
<td>An empty file title was specified.</td>
</tr>
<tr>
<td>400</td>
<td>GIF_CONTENT_TYPE_INVALID</td>
<td>GIF content-type invalid.</td>
</tr>
<tr>
<td>400</td>
<td>MESSAGE_EMPTY</td>
<td>The provided message is empty.</td>
</tr>
<tr>
<td>400</td>
<td>MESSAGE_TOO_LONG</td>
<td>The provided message is too long.</td>
</tr>
<tr>
<td>400</td>
<td>NEXT_OFFSET_INVALID</td>
<td>The specified offset is longer than 64 bytes.</td>
</tr>
<tr>
<td>400</td>
<td>PHOTO_CONTENT_TYPE_INVALID</td>
<td>Photo mime-type invalid.</td>
</tr>
<tr>
<td>400</td>
<td>PHOTO_CONTENT_URL_EMPTY</td>
<td>Photo URL invalid.</td>
</tr>
<tr>
<td>400</td>
<td>PHOTO_INVALID</td>
<td>Photo invalid.</td>
</tr>
<tr>
<td>400</td>
<td>PHOTO_THUMB_URL_EMPTY</td>
<td>Photo thumbnail URL is empty.</td>
</tr>
<tr>
<td>400</td>
<td>QUERY_ID_INVALID</td>
<td>The query ID is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>REPLY_MARKUP_INVALID</td>
<td>The provided reply markup is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>RESULTS_TOO_MUCH</td>
<td>Too many results were provided.</td>
</tr>
<tr>
<td>400</td>
<td>RESULT_ID_DUPLICATE</td>
<td>You provided a duplicate result ID.</td>
</tr>
<tr>
<td>400</td>
<td>RESULT_TYPE_INVALID</td>
<td>Result type invalid.</td>
</tr>
<tr>
<td>400</td>
<td>SEND_MESSAGE_MEDIA_INVALID</td>
<td>Invalid media provided.</td>
</tr>
<tr>
<td>400</td>
<td>SEND_MESSAGE_TYPE_INVALID</td>
<td>The message type is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>START_PARAM_INVALID</td>
<td>Start parameter invalid.</td>
</tr>
<tr>
<td>400</td>
<td>STICKER_DOCUMENT_INVALID</td>
<td>The specified sticker document is invalid.</td>
</tr>
<tr>
<td>400</td>
<td>URL_INVALID</td>
<td>Invalid URL provided.</td>
</tr>
<tr>
<td>403</td>
<td>USER_BOT_INVALID</td>
<td>This method can only be called by a bot.</td>
</tr>
<tr>
<td>400</td>
<td>VIDEO_TITLE_EMPTY</td>
<td>The specified video title is empty.</td>
</tr>
<tr>
<td>400</td>
<td>WEBDOCUMENT_INVALID</td>
<td>Invalid webdocument URL provided.</td>
</tr>
<tr>
<td>400</td>
<td>WEBDOCUMENT_MIME_INVALID</td>
<td>Invalid webdocument mime type provided.</td>
</tr>
<tr>
<td>400</td>
<td>WEBDOCUMENT_SIZE_TOO_BIG</td>
<td>Webdocument is too big!</td>
</tr>
<tr>
<td>400</td>
<td>WEBDOCUMENT_URL_INVALID</td>
<td>The specified webdocument URL is invalid.</td>
</tr>
</tbody>
</table>
<h3><a class="anchor" href="#bots-can-use-this-method" id="bots-can-use-this-method" name="bots-can-use-this-method"><i class="anchor-icon"></i></a>Bots can use this method</h3></div>
</div>
</div>
</div>
<div class="footer_wrap">
<div class="footer_columns_wrap footer_desktop">
<div class="footer_column footer_column_telegram">
<h5>Telegram</h5>
<div class="footer_telegram_description"></div>
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
</div>
<div class="footer_column">
<h5><a href="//telegram.org/faq">About</a></h5>
<ul>
<li><a href="//telegram.org/faq">FAQ</a></li>
2022-09-09 12:10:24 +02:00
<li><a href="//telegram.org/privacy">Privacy</a></li>
2022-09-09 23:58:59 +02:00
<li><a href="//telegram.org/press">Press</a></li>
2022-05-14 00:37:40 +02:00
</ul>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/apps#mobile-apps">Mobile Apps</a></h5>
<ul>
<li><a href="//telegram.org/dl/ios">iPhone/iPad</a></li>
2022-09-09 23:58:59 +02:00
<li><a href="//telegram.org/android">Android</a></li>
<li><a href="//telegram.org/dl/web">Mobile Web</a></li>
2022-05-14 00:37:40 +02:00
</ul>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/apps#desktop-apps">Desktop Apps</a></h5>
<ul>
<li><a href="//desktop.telegram.org/">PC/Mac/Linux</a></li>
<li><a href="//macos.telegram.org/">macOS</a></li>
<li><a href="//telegram.org/dl/web">Web-browser</a></li>
</ul>
</div>
<div class="footer_column footer_column_platform">
<h5><a href="/">Platform</a></h5>
<ul>
<li><a href="/api">API</a></li>
<li><a href="//translations.telegram.org/">Translations</a></li>
<li><a href="//instantview.telegram.org/">Instant View</a></li>
</ul>
</div>
</div>
<div class="footer_columns_wrap footer_mobile">
<div class="footer_column">
<h5><a href="//telegram.org/faq">About</a></h5>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/blog">Blog</a></h5>
</div>
<div class="footer_column">
<h5><a href="//telegram.org/apps">Apps</a></h5>
</div>
<div class="footer_column">
<h5><a href="/">Platform</a></h5>
</div>
<div class="footer_column">
<h5><a href="https://twitter.com/telegram" target="_blank" data-track="Follow/Twitter" onclick="trackDlClick(this, event)">Twitter</a></h5>
</div>
</div>
</div>
</div>
<script src="/js/main.js?46"></script>
<script>backToTopInit("Go up");
removePreloadInit();
</script>
</body>
</html>
