# Web App ## Demo bot {% embed url="" %} ## Quickly start Telegram have [Web Apps](https://core.telegram.org/bots/webapps) now. So BB supports Web Apps too. {% hint style="danger" %} **WebApp** is designed for working with HTML, JavaScript, and simple JSON requests. However, if you need to make important changes, such as transferring balances or assigning game points, use [**webhooks**](https://help.bots.business/libs/webhooks-lib) instead. 🔹 [**Webhooks**](https://help.bots.business/libs/webhooks-lib) are secure URLs containing a secret key for validation.\ 🔹 **WebApp** is not protected—anyone can send any request to it. Therefore, for critical operations, always use **webhooks** instead of WebApp. {% endhint %} It is possible render text (html, css, js, json...) content to web. For example: ```javascript // command webExample // get url for Web page var url = WebApp.getUrl({ command: "webExample", // you can pass options // options: { any: "options", here: "possible" } }); // we can get page url on bot Bot.inspect(url); // html content var content = "

Hello from " + bot.name + "

" // render this command in web WebApp.render({ content: content }); ``` Go to bot and sent text `webExample`. You will have link to this page: ![](https://3310729168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVh0yg9olT-QWqi3AYt%2Fuploads%2FkwAndmXDswFCJQ1Aw1kJ%2Fimage.png?alt=media\&token=ff7f98ab-a1fb-4909-917e-44f4c6c49894) ### ### Passing data to BJS It is possible to pass data from web via url params or via options on `WebApp.getUrl`. For example your url is: api.bots.business/v2/bots/**BOT\_ID**/**web-app**/**index**?secret=SECRET you can add data with: api.bots.business/v2/bots/BOT\_ID/web-app/index?secret=SECRET**\&key=value\&another\_key=another\_value** {% hint style="info" %} **Please note:** * You can use any text for key or value * **key** and **value** must be encoded (it can not have this symbols: " ", "?", "&" and others). You can use encodeURIComponent JS method or another accord your language. {% endhint %} In BJS you can access to this data via options: ```javascript let key = options.key let anotherKey = options.another_key // or more simple: // let {key, anotherKey } = options ``` ### Templates It is hard to edit html in Java Script. Templates are a good way to organize your web application. ```javascript // command index WebApp.render({ template: "index.html" // you can pass mime type also: // mime_type: "text/html", // html by default }); ``` {% hint style="success" %} Possible [mime types](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types): `text/css, text/csv, text/javascript, text/css, text/html, application/json and etc` {% endhint %} command "`index.html`": ```html

Hello from <%bot.name%>

2 + 2 = <% 2+2 %> ``` You can use bjs tag: `<% your BJS code %>` in this template. We have: ![](https://3310729168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVh0yg9olT-QWqi3AYt%2Fuploads%2FCOTTW7XwfpndmFkcK9OY%2Fimage.png?alt=media\&token=84ef93fc-12e8-4429-b9b1-664c0d4c661d) #### Passing Variables {% hint style="info" %} **Do not use long code** in bjs tag <% %> It is bad. You can pass any vars to template {% endhint %} For example we can pass CSS file and test variable. Command "`index`": ```javascript // command index var botLink = "http://t.me/" + bot.name; var CSSFile = WebApp.getUrl({ command: "renderCSS" }) WebApp.render({ template: "index.html", options: { botLink: botLink, CSSFile: CSSFile } }); ``` command "`index.html`": ```html

Hello from <%bot.name%>

2 + 2 = <% 2+2 %> ``` command "`renderCSS`": ```javascript WebApp.render({ template: "example.css", mime_type: "text/css" }); ``` command "`example.css`": ```css // It is CSS file body { font-family: 'Share Tech', sans-serif; font-size: 15px; color: white; display: flex; jsutify-content: center; align-items: center; margin: 0; width: 100vw; height: 100vh; text-shadow: 8px 8px 10px #0000008c; background-color: #343a40; background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='28' height='49' viewBox='0 0 28 49'%3E%3Cg fill-rule='evenodd'%3E%3Cg id='hexagons' fill='%239C92AC' fill-opacity='0.25' fill-rule='nonzero'%3E%3Cpath d='M13.99 9.25l13 7.5v15l-13 7.5L1 31.75v-15l12.99-7.5zM3 17.9v12.7l10.99 6.34 11-6.35V17.9l-11-6.34L3 17.9zM0 15l12.98-7.5V0h-2v6.35L0 12.69v2.3zm0 18.5L12.98 41v8h-2v-6.85L0 35.81v-2.3zM15 0v7.5L27.99 15H28v-2.31h-.01L17 6.35V0h-2zm0 49v-8l12.99-7.5H28v2.31h-.01L17 42.15V49h-2z'/%3E%3C/g%3E%3C/g%3E%3C/svg%3E"), linear-gradient(to right top, #343a40, #2b2c31, #211f22, #151314, #000000); } h1 { margin: 40px; display: inline-grid; } ``` Our result now: ![](https://3310729168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVh0yg9olT-QWqi3AYt%2Fuploads%2FAS1TckTj9sUGkn27JbfC%2Fimage.png?alt=media\&token=8b0ffcd5-6459-4741-9d44-3da3a18f7fad) ## Deployment in Telegram You can install Web App in [several ways](https://core.telegram.org/bots/webapps#implementing-web-apps) ![](https://3310729168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVh0yg9olT-QWqi3AYt%2Fuploads%2F7XVbQPqgJbp3Fpu2UKfb%2Fimage.png?alt=media\&token=df7edd8d-19c9-42bf-8eeb-dcf69af5092b) ### Inline button ```javascript var webExample = WebApp.getUrl({ command: "webExample" }); Api.sendMessage({ text: "🤑 Try our web page", reply_markup: { inline_keyboard: [ [ // open the any web page on button pressing { text: "open Demo Page (from help)", web_app: { url: webExample } }, ] ]} }); ``` ### Keyboard button ```javascript var webExample = WebApp.getUrl({ command: "webExample" }); Api.sendMessage({ text: "It is example for BB Web App", reply_markup: { resize_keyboard: true, keyboard: [ // line 1 [ { text: "🤑 Open Web App" }, { text: "Open App", web_app: { url: webExample } } ] ] } }) ``` {% hint style="success" %} For another ways please see Telegram [Help](https://core.telegram.org/bots/webapps#implementing-web-apps) {% endhint %} ## **How to?** **Why Bot.sendMessage method is not working on Web App?** Bot.sendMessage - it is method for sending message to user in Telegram. The Web App is not a Telegram chat, so there is no user, chat, etc. - anyone can open this web app, the user can share it with other users, etc. For sending message you need to pass chat id and use something like AJAX request to bot via [Webhook](https://help.bots.business/libs/webhooks-lib) (it can be more secure) or via another Web App endpoint with [passing data](#passing-data-to-bjs). **How i can make AJAX requests from my Web App?** This question is now about web development, not bot development. We have jQuery and other methods, libraries (the list is really long). You can include any external js library in your application and use it. Go to the Internet - there is a lot of information there and our help is not the place where this question should be covered **How to use BB Libs in Web App?** BB Libs - it is bot libs not Web app Libs. You can not use libs in Web App
**How to display personal user's data on web page?** You need to pass this data via url: ```javascript // command webExample // get url for Web page var url = WebApp.getUrl({ command: "webExample", // you can pass options options: { user: user, chat: chat } }); // we can get page url on bot Bot.inspect(url); ``` So you will have this data in address and can extract it with JavaScript and window\.location.search or etc. If you want more data or if you need any dynamic content - you can use Webhook to bot (or another WebApp-endpoints) + AJAX requests.