Telegram Bot Library

Arduino MKR1000

Arduino Web Editor

Learn how to use the Telegram Bot library, host a Telegram Bot on your Arduino/Genuino Board, and use the messaging app to interact with your device.It currently works on <a href="http://www.arduino.cc/en/Main/ArduinoMKR1000">Arduino MKR1000</a>, and <a href="https://www.arduino.cc/en/Main/ArduinoBoardZero">Arduino Zero</a> with the <a href="https://www.arduino.cc/en/Main/ArduinoWiFiShield101">WiFi shield 101</a>. You can view the last released Telegram API documentation <a href="https://core.telegram.org/bots/api">here</a>.<h3 >Installing</h3>Step 1 (TelegramBot Library)Download TelegramBot Library (<a href="https://github.com/CasaJasmina/TelegramBot-Library">Download</a>).To install library, open Arduino, goto menu: Sketch / Include Library / Add .ZIP Library... and select your downloaded .ZIP file.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/269e2a66-7ea4-493b-808c-0af491ccfd84.PNG /><figcaption>Install TelegramBot Library</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/3b436c55-f2da-43b3-9b86-0350eb0aa453.PNG /><figcaption>Install TelegramBot Library</figcaption></div><blockquote >You can include a new .ZIP library into the Arduino IDE by selecting the menu: Sketch / include Library / Add .Zip library.</blockquote>Step 2 (ArduinoJson &amp; WiFi101 Library)Install ArduinoJson &amp; WiFi101 Library from Library Manager.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/1fcfdc8d-12fb-4b02-ade3-1d693ffd4dd1.PNG /><figcaption> </figcaption><img id="gallery" src=https://projects.arduinocontent.cc/a9b60990-1530-425f-b857-c1511a77d1da.PNG /><figcaption> </figcaption><img id="gallery" src=https://projects.arduinocontent.cc/38cecc4c-3702-4971-a007-344921b1173e.PNG /><figcaption> </figcaption></div><h3 >Getting started</h3>Step 1 (Create a new TelegramBot )Be sure you have installed <a href="https://telegram.org/apps">Telegram</a> on your phone or your laptop, then, in the search bar, look for @botfather.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/f72c5aa1-8d3d-4fcd-bd1b-0a87c2982257.PNG /><figcaption>Step 1: Look for @BotFather</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/e892d468-8e94-4636-afcf-cc7a531def30.PNG /><figcaption>Step 2: Type "/newbot" to create new Telegram Bot</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/4c04d895-6eb0-460f-b753-b7e54138eb08.PNG /><figcaption>Step 3: Type your bot's name</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/c1aae9da-355c-4dd3-ba94-375722b9396b.PNG /><figcaption>Step 4: type your Bot's user name</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/c7f9215a-9e4f-4407-aca1-64d2f0ab6370.PNG /><figcaption>Step 4: Notedown BotName, BotUserName and Token</figcaption></div>Talk to him and use the /newbot command to create a new bot. The BotFather will ask you for a name and username, then generate an authorization token for your new bot.The Name of your bot will be displayed in contact details and elsewhere.The Username is a short name, to be used in mentions and telegram.me links. Your bot's username must end in ‘bot’, e.g. ‘tetris_bot’ or ‘TetrisBot’.<h3 >Hello World</h3>Now that we have our new bot we can set it to do what we want.In this example we will make it turn on and off a LED by texting him a simple 'On or Off' message.<pre ><code >#include &lt;WiFi101.h&gt; #include &lt;SPI.h&gt; #include &lt;TelegramBot.h&gt; // Initialize Wifi connection to the router char ssid[] = &#34;xxxx&#34;; // your network SSID (name) char pass[] = &#34;yyyy&#34;; // your network key // Initialize Telegram BOT const char* BotToken = &#34;xxxx&#34;; // your Bot Teken WiFiSSLClient client; TelegramBot bot(BotToken,client); const int ledPin = 6; // the number of the LED pin void setup() { Serial.begin(115200); while (!Serial) {} //Start running when the serial is open delay(3000); // attempt to connect to Wifi network: Serial.print(&#34;Connecting Wifi: &#34;); Serial.println(ssid); while (WiFi.begin(ssid, pass) != WL_CONNECTED) { Serial.print(&#34;.&#34;); delay(500); } Serial.println(&#34;&#34;); Serial.println(&#34;WiFi connected&#34;); bot.begin(); pinMode(ledPin, OUTPUT); } void loop() { message m = bot.getUpdates(); // Read new messages if (m.text.equals(&#34;On&#34;)) { digitalWrite(ledPin, HIGH); Serial.println(&#34;message received&#34;); bot.sendMessage(m.chat_id, &#34;The Led is now ON&#34;); } else if (m.text.equals(&#34;Off&#34;)) { digitalWrite(ledPin, LOW); Serial.println(&#34;message received&#34;); bot.sendMessage(m.chat_id, &#34;The Led is now OFF&#34;); } } </code></pre><h3 >Let's see in action</h3><div class="se-component se-video-container __se__float-none" contenteditable="false" style="width: 100%;"><figure style="width: 100%; height: 56.25%; padding-bottom: 56.25%; margin: 0px;"><iframe frameborder="0" allowfullscreen="" src="https://www.youtube.com/embed/L1FXPcgRENs" data-proportion="true" data-percentage="100%,56.25%" data-size="100%,56.25%" data-align="none" style="width: 100%; height: 100%;" data-index="0" data-file-size="0" data-origin="100%,56.25%"></iframe></figure></div><h3 >Notes about the groups</h3>When the bot is included in a group it will be, by default, in privacy mode. Which means that it will receive only messages starting with &#34;/&#34;, the so called commands. In order to disable the privacy mode you have to chat with BotFather and go through this flow:<pre ><code >/mybots @yourBot Bot setting Group privacy Turn off </code></pre>You can also create your own list of commands using /setcommands while chatting with the BotFather. This list will appear only in the mobile view, pressing the &#34;/&#34; icon.

Telegram Bot Library

Host a Telegram Bot on your Arduino and chat with your brand new IoT device!