![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/07\/ESP32-PIR-Motion-Sensor-Telegram-Send-Message-Notification-Arduino.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nProject Overview<\/h2>\n\n\n\n
This tutorial shows how to get notifications in your Telegram account when the ESP32 detects motion. <\/p>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/07\/ESP32-PIR-Motion-Sensor-Send-Message-Notificatio-Telegram.png?resize=890%2C434&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nHere’s an overview on how the project works:<\/p>\n\n\n\n
- You’ll create a Telegram bot for your ESP32.<\/li>
- The ESP32 is connected to a PIR motion sensor.<\/li>
- When the sensor detects motion, the ESP32 sends a warning message to your telegram account.<\/li>
- You’ll be notified in your telegram account whenever motion is detected.<\/li><\/ul>\n\n\n\n
This is a simple project, but shows how you can use Telegram in your IoT and Home Automation projects. The idea is to apply the concepts learned in your own projects.<\/p>\n\n\n\n
Introducing Telegram<\/h2>\n\n\n\n
Telegram<\/a> Messenger is a cloud-based instant messaging and voice over IP service. You can easily install it in your smartphone (Android and iPhone) or computer (PC, Mac and Linux). It is free and without any ads. Telegram allows you to create bots that you can interact with.<\/p>\n\n\n\n
“Bots are third-party applications that run inside Telegram. Users can interact with bots by sending them messages, commands and inline requests. You control your bots using HTTPS requests to Telegram Bot API<\/em>“.<\/p>\n\n\n\n
The ESP32 will interact with the Telegram bot to send messages to your telegram account. Whenever motion is detected, you’ll receive a notification in your smartphone (as long as you have access to the internet).<\/p>\n\n\n\n
Creating a Telegram Bot<\/h2>\n\n\n\n
Go to Google Play or App Store, download and install Telegram<\/strong>.<\/p>\n\n\n\n
![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Install-Telegram.png?resize=354%2C269&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nOpen Telegram and follow the next steps to create a Telegram Bot. First, search for “botfather<\/strong>” and click the BotFather as shown below. Or open this link t.me\/botfather<\/a> in your smartphone.<\/p>\n\n\n\n
![\"botfather\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Telegram-Botfather.png?resize=362%2C198&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nThe following window should open and you’ll be prompted to click the start<\/strong> button.<\/p>\n\n\n\n
![\"Telegram](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/start-bot-father-telegram.png?resize=352%2C708&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nType \/newbot<\/strong> and follow the instructions to create your bot. Give it a name and username.<\/p>\n\n\n\n
![\"Telegram](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Create-bot-Telegram-Botfather_f.png?resize=354%2C396&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nIf your bot is successfully created, you’ll receive a message with a link to access the bot and the bot token<\/strong>. Save the bot token because you’ll need it so that the ESP32 can interact with the bot.<\/p>\n\n\n\n
![\"Telegram](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Bot-Token-Telegram-Bot-Father.png?resize=356%2C537&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nGet Your Telegram User ID<\/h2>\n\n\n\n
Anyone that knows your bot username can interact with it. To make sure that we ignore messages that are not from our Telegram account (or any authorized users), you can get your Telegram User ID. Then, when your telegram bot receives a message, the ESP can check whether the sender ID corresponds to your User ID and handle the message or ignore it.<\/p>\n\n\n\n
In your Telegram account, search for “IDBot” or open this link t.me\/myidbot<\/a> in your smartphone.<\/p>\n\n\n\n
![\"Telegram](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Telegram-ID-Bot.png?resize=348%2C173&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nStart a conversation with that bot and type \/getid<\/strong>. You will get a reply back with your user ID. Save that user ID<\/strong>, because you’ll need it later in this tutorial.<\/p>\n\n\n\n
![\"Telegram](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Telegram-Get-Chat-ID.png?resize=354%2C500&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nPreparing Arduino IDE<\/h2>\n\n\n\n
We\u2019ll program the ESP32<\/a> board using Arduino IDE, so make sure you have them installed in your Arduino IDE.<\/p>\n\n\n\n
- Installing the ESP32 Board in Arduino IDE (Windows, Mac OS X, Linux)<\/a><\/li><\/ul>\n\n\n\n
Universal Telegram Bot Library<\/h3>\n\n\n\n
To interact with the Telegram bot, we’ll use the Universal Telegram Bot Library<\/a> created by Brian Lough that provides an easy interface for the Telegram Bot API.<\/p>\n\n\n\n
Follow the next steps to install the latest release of the library.<\/p>\n\n\n\n
- Click here to download the Universal Arduino Telegram Bot library<\/a>.<\/li>
- Go to Sketch <\/strong>> Include Library<\/strong> > Add.ZIP Library..<\/strong>.<\/li>
- Add the library you’ve just downloaded.<\/li><\/ol>\n\n\n\n
Important: <\/strong> don’t install the library through the Arduino Library Manager because it might install a deprecated version.<\/p>\n\n\n\n
For all the details about the library, take a look at the Universal Arduino Telegram Bot Library GitHub<\/a> page.<\/p>\n\n\n\n
ArduinoJson Library<\/h3>\n\n\n\n
You also have to install the ArduinoJson<\/a> library. Follow the next steps to install the library.<\/p>\n\n\n\n
- Go to Skech <\/strong>> Include Library<\/strong> > Manage Libraries<\/strong>.<\/li>
- Search for “ArduinoJson”.<\/li>
- Install the library.<\/li><\/ol>\n\n\n\n
We’re using ArduinoJson library version 6.5.12.<\/p>\n\n\n\n
![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Install-ArduinoJson-Library.png?resize=786%2C443&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nParts Required<\/h2>\n\n\n\n
For this project, you need the following parts:<\/p>\n\n\n\n
- ESP32 board<\/a> (read Best ESP32 dev boards<\/a>)<\/li>
- <\/a>Mini PIR motion sensor (AM312)<\/a> or PIR motion sensor (HC-SR501)<\/a><\/li>
- Jumper wires<\/a><\/li>
- Breadboard<\/a><\/li><\/ul>\n\n\n\n
Schematic Diagram<\/h2>\n\n\n\n
For this project you need to wire a PIR motion sensor to your ESP32 board. Follow the next schematic diagram.<\/p>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/07\/ESP32-PIR-Motion-Sensor-Wiring-Diagram.png?resize=1024%2C649&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nIn this example, we’re wiring the PIR motion sensor data pin to GPIO 27<\/span>. You can use any other suitable GPIO. Read ESP32 GPIO Guide<\/a>.<\/p>\n\n\n\n
Telegram Motion Detection with Notifications – ESP32 Sketch<\/h2>\n\n\n\n
The following code uses your Telegram bot to send a warning message to your telegram account whenever motion is detected. To make this sketch work for you, you need to insert your network credentials (SSID and password), the Telegram Bot token and your Telegram user ID.<\/p>\n\n\n
\/*\r\n Rui Santos\r\n Complete project details at https:\/\/RandomNerdTutorials.com\/telegram-esp32-motion-detection-arduino\/\r\n \r\n Project created using Brian Lough's Universal Telegram Bot Library: https:\/\/github.com\/witnessmenow\/Universal-Arduino-Telegram-Bot\r\n*\/\r\n\r\n#include <WiFi.h>\r\n#include <WiFiClientSecure.h>\r\n#include <UniversalTelegramBot.h>\r\n#include <ArduinoJson.h>\r\n\r\n\/\/ Replace with your network credentials\r\nconst char* ssid = "REPLACE_WITH_YOUR_SSID";\r\nconst char* password = "REPLACE_WITH_YOUR_PASSWORD";\r\n\r\n\/\/ Initialize Telegram BOT\r\n#define BOTtoken "XXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \/\/ your Bot Token (Get from Botfather)\r\n\r\n\/\/ Use @myidbot to find out the chat ID of an individual or a group\r\n\/\/ Also note that you need to click "start" on a bot before it can\r\n\/\/ message you\r\n#define CHAT_ID "XXXXXXXXXX"\r\n\r\nWiFiClientSecure client;\r\nUniversalTelegramBot bot(BOTtoken, client);\r\n\r\nconst int motionSensor = 27; \/\/ PIR Motion Sensor\r\nbool motionDetected = false;\r\n\r\n\/\/ Indicates when motion is detected\r\nvoid IRAM_ATTR detectsMovement() {\r\n \/\/Serial.println("MOTION DETECTED!!!");\r\n motionDetected = true;\r\n}\r\n\r\nvoid setup() {\r\n Serial.begin(115200);\r\n\r\n \/\/ PIR Motion Sensor mode INPUT_PULLUP\r\n pinMode(motionSensor, INPUT_PULLUP);\r\n \/\/ Set motionSensor pin as interrupt, assign interrupt function and set RISING mode\r\n attachInterrupt(digitalPinToInterrupt(motionSensor), detectsMovement, RISING);\r\n\r\n \/\/ Attempt to connect to Wifi network:\r\n Serial.print("Connecting Wifi: ");\r\n Serial.println(ssid);\r\n\r\n WiFi.mode(WIFI_STA);\r\n WiFi.begin(ssid, password);\r\n client.setCACert(TELEGRAM_CERTIFICATE_ROOT); \/\/ Add root certificate for api.telegram.org\r\n \r\n while (WiFi.status() != WL_CONNECTED) {\r\n Serial.print(".");\r\n delay(500);\r\n }\r\n\r\n Serial.println("");\r\n Serial.println("WiFi connected");\r\n Serial.print("IP address: ");\r\n Serial.println(WiFi.localIP());\r\n\r\n bot.sendMessage(CHAT_ID, "Bot started up", "");\r\n}\r\n\r\nvoid loop() {\r\n if(motionDetected){\r\n bot.sendMessage(CHAT_ID, "Motion detected!!", "");\r\n Serial.println("Motion Detected");\r\n motionDetected = false;\r\n }\r\n}\r\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
How the Code Works<\/h2>\n\n\n\n
This sections explain how the code works. Continue reading or skip to the Demonstration<\/a> section. <\/p>\n\n\n\n
Start by importing the required libraries.<\/p>\n\n\n\n
#include <WiFi.h>\n#include <WiFiClientSecure.h>\n#include <UniversalTelegramBot.h>\n#include <ArduinoJson.h><\/code><\/pre>\n\n\n\nNetwork Credentials<\/h3>\n\n\n\n
Insert your network credentials in the following variables.<\/p>\n\n\n\n
const char* ssid = \"REPLACE_WITH_YOUR_SSID\";\nconst char* password = \"REPLACE_WITH_YOUR_PASSWORD\";<\/code><\/pre>\n\n\n\nTelegram Bot Token<\/h3>\n\n\n\n
Insert your Telegram Bot token you’ve got from Botfather on the BOTtoken<\/span> variable.<\/p>\n\n\n\n
#define BOTtoken \"XXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\" \/\/ your Bot Token (Get from Botfather)<\/code><\/pre>\n\n\n\nTelegram User ID<\/h3>\n\n\n\n
Insert your chat ID. The one you’ve got from the IDBot.<\/p>\n\n\n\n
#define CHAT_ID \"XXXXXXXXXX\"<\/code><\/pre>\n\n\n\nCreate a new WiFi client with WiFiClientSecure<\/span>.<\/p>\n\n\n\n
WiFiClientSecure client;<\/code><\/pre>\n\n\n\nCreate a bot<\/span> with the token and client defined earlier.<\/p>\n\n\n\n
UniversalTelegramBot bot(BOTtoken, client);<\/code><\/pre>\n\n\n\nMotion Sensor<\/h3>\n\n\n\n
Define the GPIO that the motion sensor is connected to.<\/p>\n\n\n\n
const int motionSensor = 27; \/\/ PIR Motion Sensor<\/code><\/pre>\n\n\n\nThe motionDetected<\/span> boolean variable is used to indicate whether motion was detected or not. It is set to false<\/span> by default.<\/p>\n\n\n\n
bool motionDetected = false;<\/code><\/pre>\n\n\n\ndetectsMovement()<\/h3>\n\n\n\n
The detectsmovement()<\/span> function is a callback function that will be executed when motion is detected. In this case, it simply changes the state of the motionDetected<\/span> variable to true<\/span>.<\/p>\n\n\n\n
void IRAM_ATTR detectsMovement() {\n \/\/Serial.println(\"MOTION DETECTED!!!\");\n motionDetected = true;\n}<\/code><\/pre>\n\n\n\nsetup()<\/h3>\n\n\n\n
In the setup()<\/span>, initialize the Serial Monitor.<\/p>\n\n\n\n
Serial.begin(115200);<\/code><\/pre>\n\n\n\nPIR Motion Sensor Interrupt<\/h4>\n\n\n\n
Set the PIR motion sensor as an interrupt and set the detectsMovement()<\/span> as the callback function (when motion is detected, that function will be executed):<\/p>\n\n\n\n
\/\/ PIR Motion Sensor mode INPUT_PULLUP\npinMode(motionSensor, INPUT_PULLUP);\n\/\/ Set motionSensor pin as interrupt, assign interrupt function and set RISING mode\nattachInterrupt(digitalPinToInterrupt(motionSensor), detectsMovement, RISING);<\/code><\/pre>\n\n\n\nNote: <\/strong> Recommended reading: ESP32 with PIR Motion Sensor using Interrupts and Timers<\/a><\/p>\n\n\n\n
Init Wi-Fi<\/h4>\n\n\n\n
Initialize Wi-Fi and connect the ESP32 to your local network with the SSID and password defined earlier.<\/p>\n\n\n\n
WiFi.mode(WIFI_STA);\nWiFi.begin(ssid, password);\nwhile (WiFi.status() != WL_CONNECTED) {\n delay(1000);\n Serial.println(\"Connecting to WiFi..\");\n}<\/code><\/pre>\n\n\n\nFinally, send a message to indicate that the Bot has started up:<\/p>\n\n\n\n
bot.sendMessage(CHAT_ID, \"Bot started up\", \"\");<\/code><\/pre>\n\n\n\nloop()<\/h3>\n\n\n\n
In the loop()<\/span>, check the state of the motionDetected<\/span> variable. <\/p>\n\n\n\n
void loop() {\n if(motionDetected){<\/code><\/pre>\n\n\n\nIf it’s true<\/span>, it means that motion was detected. So, send a message to your Telegram account indicating that motion was detected. <\/p>\n\n\n\n
bot.sendMessage(CHAT_ID, \"Motion detected!!\", \"\");<\/code><\/pre>\n\n\n\nSending a message to the bot is very simply. You just need to use the sendMessage()<\/span> method on the bot<\/span> object and pass as arguments the recipient\u2019s chat ID, the message, and the parse mode.<\/p>\n\n\n\n
bool sendMessage(String chat_id, String text, String parse_mode = \"\")<\/code><\/pre>\n\n\n\nFinally, after sending the message, set the motionDetected<\/span> variable to false<\/span>, so it can detect motion again. <\/p>\n\n\n\n
motionDetected = false;<\/code><\/pre>\n\n\n\nThat’s pretty much how the code works.<\/p>\n\n\n\n
Demonstration<\/h2>\n\n\n\n
Important: <\/strong> go to your Telegram account and search for your bot. You need to click “start<\/strong>” on a bot before it can message you.<\/p>\n\n\n\n
Upload the code to your ESP32 board. Don’t forget to go to Tools <\/strong>> Board <\/strong>and select the board you’re using. Go to Tools <\/strong>> Port <\/strong>and select the COM port your board is connected to.<\/p>\n\n\n\n
After uploading the code, press the ESP32 on-board EN\/RST button so that it starts running the code. Then, you can open the Serial Monitor to check what’s happening in the background.<\/p>\n\n\n\n
When your board first boots, it will send a message to your Telegram account: “Bot started up”. Then, move your hand in front of the PIR motion sensor and check that you’ve received the motion detected notification.<\/p>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/Motion-Detected-Telegram-Notification.png?resize=352%2C279&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nAt the same time, this is what you should get on the Serial Monitor.<\/p>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/06\/ESP32-Telegram-Motion-Detected-Serial-Monitor-Demonstration.png?resize=669%2C435&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nWrapping Up<\/h2>\n\n\n\n
In this tutorial you’ve learned how to create a Telegram Bot to interact with the ESP32 board. When motion is detected, a message is sent.<\/p>\n\n\n\n
With this bot, you can also use your Telegram account to send messages to the ESP32 to control its outputs<\/a> or request sensor readings<\/a>, for example.<\/p>\n\n\n\n
The great thing about using Telegram to control your ESP boards, is that as long as you have an internet connection (and your boards too), you can control and monitor them from anywhere in the world.<\/p>\n\n\n\n
More projects with Telegram:<\/p>\n\n\n\n
- Control Outputs<\/a><\/li>
- Request Sensor Readings<\/a><\/li>
- ESP8266 Motion Detection<\/a><\/li><\/ul>\n\n\n\n
We hope you’ve found this project interesting. Learn more about the ESP32 with our resources:<\/p>\n\n\n\n
- Learn ESP32 with Arduino IDE (eBook + Video Course)<\/a><\/li>
- More ESP32 Projects and Tutorials…<\/a><\/li><\/ul>\n\n\n\n
Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":"
This tutorial shows how to send notifications to your Telegram account when the ESP32 detects motion. As long as you have access to the internet in your smartphone, you’ll be … <\/p>\n
- More ESP32 Projects and Tutorials…<\/a><\/li><\/ul>\n\n\n\n
- Request Sensor Readings<\/a><\/li>
- <\/a>Mini PIR motion sensor (AM312)<\/a> or PIR motion sensor (HC-SR501)<\/a><\/li>
- Go to Sketch <\/strong>> Include Library<\/strong> > Add.ZIP Library..<\/strong>.<\/li>
- Click here to download the Universal Arduino Telegram Bot library<\/a>.<\/li>
- Installing the ESP32 Board in Arduino IDE (Windows, Mac OS X, Linux)<\/a><\/li><\/ul>\n\n\n\n