Telegram: ESP32 Motion Detection with Notifications (Arduino IDE)

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 notified no matter where you are. The ESP board will be programmed using Arduino IDE.

ESP32 PIR Motion Sensor Telegram Send Message Notification Arduino

Project Overview

This tutorial shows how to get notifications in your Telegram account when the ESP32 detects motion.

ESP32 with PIR Motion Sensor Send Message Notification to Telegram using Arduino IDE

Here’s an overview on how the project works:

  • You’ll create a Telegram bot for your ESP32.
  • The ESP32 is connected to a PIR motion sensor.
  • When the sensor detects motion, the ESP32 sends a warning message to your telegram account.
  • You’ll be notified in your telegram account whenever motion is detected.

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.

Introducing Telegram

Telegram 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.

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“.

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).

Creating a Telegram Bot

Go to Google Play or App Store, download and install Telegram.

Install and Download Telegram

Open Telegram and follow the next steps to create a Telegram Bot. First, search for “botfather” and click the BotFather as shown below. Or open this link t.me/botfather in your smartphone.

botfather

The following window should open and you’ll be prompted to click the start button.

Telegram Start BotFather to Create a new Bot

Type /newbot and follow the instructions to create your bot. Give it a name and username.

Telegram BotFather Create a New Bot

If your bot is successfully created, you’ll receive a message with a link to access the bot and the bot token. Save the bot token because you’ll need it so that the ESP32 can interact with the bot.

Telegram BotFather Get Bot Token

Get Your Telegram User ID

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.

In your Telegram account, search for “IDBot” or open this link t.me/myidbot in your smartphone.

Telegram Get Chat ID with IDBot

Start a conversation with that bot and type /getid. You will get a reply back with your user ID. Save that user ID, because you’ll need it later in this tutorial.

Telegram Get Chat ID with IDBot getid

Preparing Arduino IDE

We’ll program the ESP32 board using Arduino IDE, so make sure you have them installed in your Arduino IDE.

Universal Telegram Bot Library

To interact with the Telegram bot, we’ll use the Universal Telegram Bot Library created by Brian Lough that provides an easy interface for the Telegram Bot API.

Follow the next steps to install the latest release of the library.

  1. Click here to download the Universal Arduino Telegram Bot library.
  2. Go to Sketch > Include Library > Add.ZIP Library...
  3. Add the library you’ve just downloaded.

Important: don’t install the library through the Arduino Library Manager because it might install a deprecated version.

For all the details about the library, take a look at the Universal Arduino Telegram Bot Library GitHub page.

ArduinoJson Library

You also have to install the ArduinoJson library. Follow the next steps to install the library.

  1. Go to Skech > Include Library > Manage Libraries.
  2. Search for “ArduinoJson”.
  3. Install the library.

We’re using ArduinoJson library version 6.5.12.

Install in Arduino IDE the ArduinoJSON library

Parts Required

For this project, you need the following parts:

Schematic Diagram

For this project you need to wire a PIR motion sensor to your ESP32 board. Follow the next schematic diagram.

ESP32 PIR Motion Sensor Wiring Diagram

In this example, we’re wiring the PIR motion sensor data pin to GPIO 27. You can use any other suitable GPIO. Read ESP32 GPIO Guide.

Telegram Motion Detection with Notifications – ESP32 Sketch

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.

/*
  Rui Santos
  Complete project details at https://RandomNerdTutorials.com/telegram-esp32-motion-detection-arduino/
  
  Project created using Brian Lough's Universal Telegram Bot Library: https://github.com/witnessmenow/Universal-Arduino-Telegram-Bot
*/

#include <WiFi.h>
#include <WiFiClientSecure.h>
#include <UniversalTelegramBot.h>
#include <ArduinoJson.h>

// Replace with your network credentials
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";

// Initialize Telegram BOT
#define BOTtoken "XXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  // your Bot Token (Get from Botfather)

// Use @myidbot to find out the chat ID of an individual or a group
// Also note that you need to click "start" on a bot before it can
// message you
#define CHAT_ID "XXXXXXXXXX"

WiFiClientSecure client;
UniversalTelegramBot bot(BOTtoken, client);

const int motionSensor = 27; // PIR Motion Sensor
bool motionDetected = false;

// Indicates when motion is detected
void IRAM_ATTR detectsMovement() {
  //Serial.println("MOTION DETECTED!!!");
  motionDetected = true;
}

void setup() {
  Serial.begin(115200);

  // PIR Motion Sensor mode INPUT_PULLUP
  pinMode(motionSensor, INPUT_PULLUP);
  // Set motionSensor pin as interrupt, assign interrupt function and set RISING mode
  attachInterrupt(digitalPinToInterrupt(motionSensor), detectsMovement, RISING);

  // Attempt to connect to Wifi network:
  Serial.print("Connecting Wifi: ");
  Serial.println(ssid);

  WiFi.mode(WIFI_STA);
  WiFi.begin(ssid, password);
  client.setCACert(TELEGRAM_CERTIFICATE_ROOT); // Add root certificate for api.telegram.org
  
  while (WiFi.status() != WL_CONNECTED) {
    Serial.print(".");
    delay(500);
  }

  Serial.println("");
  Serial.println("WiFi connected");
  Serial.print("IP address: ");
  Serial.println(WiFi.localIP());

  bot.sendMessage(CHAT_ID, "Bot started up", "");
}

void loop() {
  if(motionDetected){
    bot.sendMessage(CHAT_ID, "Motion detected!!", "");
    Serial.println("Motion Detected");
    motionDetected = false;
  }
}

View raw code

How the Code Works

This sections explain how the code works. Continue reading or skip to the Demonstration section.

Start by importing the required libraries.

#include <WiFi.h>
#include <WiFiClientSecure.h>
#include <UniversalTelegramBot.h>
#include <ArduinoJson.h>

Network Credentials

Insert your network credentials in the following variables.

const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";

Telegram Bot Token

Insert your Telegram Bot token you’ve got from Botfather on the BOTtoken variable.

#define BOTtoken "XXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  // your Bot Token (Get from Botfather)

Telegram User ID

Insert your chat ID. The one you’ve got from the IDBot.

#define CHAT_ID "XXXXXXXXXX"

Create a new WiFi client with WiFiClientSecure.

WiFiClientSecure client;

Create a bot with the token and client defined earlier.

UniversalTelegramBot bot(BOTtoken, client);

Motion Sensor

Define the GPIO that the motion sensor is connected to.

const int motionSensor = 27; // PIR Motion Sensor

The motionDetected boolean variable is used to indicate whether motion was detected or not. It is set to false by default.

bool motionDetected = false;

detectsMovement()

The detectsmovement() function is a callback function that will be executed when motion is detected. In this case, it simply changes the state of the motionDetected variable to true.

void IRAM_ATTR detectsMovement() {
  //Serial.println("MOTION DETECTED!!!");
  motionDetected = true;
}

setup()

In the setup(), initialize the Serial Monitor.

Serial.begin(115200);

PIR Motion Sensor Interrupt

Set the PIR motion sensor as an interrupt and set the detectsMovement() as the callback function (when motion is detected, that function will be executed):

// PIR Motion Sensor mode INPUT_PULLUP
pinMode(motionSensor, INPUT_PULLUP);
// Set motionSensor pin as interrupt, assign interrupt function and set RISING mode
attachInterrupt(digitalPinToInterrupt(motionSensor), detectsMovement, RISING);

Note: Recommended reading: ESP32 with PIR Motion Sensor using Interrupts and Timers

Init Wi-Fi

Initialize Wi-Fi and connect the ESP32 to your local network with the SSID and password defined earlier.

WiFi.mode(WIFI_STA);
WiFi.begin(ssid, password);
while (WiFi.status() != WL_CONNECTED) {
  delay(1000);
  Serial.println("Connecting to WiFi..");
}

Finally, send a message to indicate that the Bot has started up:

bot.sendMessage(CHAT_ID, "Bot started up", "");

loop()

In the loop(), check the state of the motionDetected variable.

void loop() {
  if(motionDetected){

If it’s true, it means that motion was detected. So, send a message to your Telegram account indicating that motion was detected.

bot.sendMessage(CHAT_ID, "Motion detected!!", "");

Sending a message to the bot is very simply. You just need to use the sendMessage() method on the bot object and pass as arguments the recipient’s chat ID, the message, and the parse mode.

bool sendMessage(String chat_id, String text, String parse_mode = "")

Finally, after sending the message, set the motionDetected variable to false, so it can detect motion again.

motionDetected = false;

That’s pretty much how the code works.

Demonstration

Important: go to your Telegram account and search for your bot. You need to click “start” on a bot before it can message you.

Upload the code to your ESP32 board. Don’t forget to go to Tools > Board and select the board you’re using. Go to Tools > Port and select the COM port your board is connected to.

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.

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.

ESP32 ESP8266 Motion Detected Telegram Notification

At the same time, this is what you should get on the Serial Monitor.

ESP32 ESP8266 Telegram Motion Detected Serial Monitor Demonstration

Wrapping Up

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.

With this bot, you can also use your Telegram account to send messages to the ESP32 to control its outputs or request sensor readings, for example.

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.

More projects with Telegram:

We hope you’ve found this project interesting. Learn more about the ESP32 with our resources:

Thanks for reading.



Build Web Server projects with the ESP32 and ESP8266 boards to control outputs and monitor sensors remotely. Learn HTML, CSS, JavaScript and client-server communication protocols DOWNLOAD »

Build Web Server projects with the ESP32 and ESP8266 boards to control outputs and monitor sensors remotely. Learn HTML, CSS, JavaScript and client-server communication protocols DOWNLOAD »

Recommended Resources

Build a Home Automation System from Scratch » With Raspberry Pi, ESP8266, Arduino, and Node-RED.

Home Automation using ESP8266 eBook and video course » Build IoT and home automation projects.

Arduino Step-by-Step Projects » Build 25 Arduino projects with our course, even with no prior experience!

What to Read Next…


Enjoyed this project? Stay updated by subscribing our newsletter!

51 thoughts on “Telegram: ESP32 Motion Detection with Notifications (Arduino IDE)”

  1. Hi, is this project locally or motion detected can be discovered even if my smartphone and esp32 aren’t connected to the same network (WiFi)

    Reply
    • Hi.
      The smartphone and ESP32 don’t need to be on the same network.
      You’ll be notified no matter where you are.
      Regards,
      Sara

      Reply
  2. Very good projects.
    I hope you will look into ESP32-CAM, and send a picture when motion is detected to Telegram.

    Reply
  3. Hi Sara, great tutorial, as ever! If the telegram account is set up on a smart phone is there an easy way to get the very long BotToken onto the PC for adding into the ESP32 code? Or, can the Telegram account be set up from a PC?

    Reply
  4. Hi
    I have the code uploaded to an ESP32 board, and it all seems to work. The board connects to my wifi and receives a valid IP address. I currently have a switch connected in place of the motion detector output on D27 and when the switch is operated, the “motion detected” message comes up in the serial monitor window. However, I don’t get any notification come up on the phone. I created the Bot and got an ID as instructed in the tutorial. Also the Bot token string. I put these into the sketch in the appropriate places. I can find my account ok in Telegram and I was able to start the Bot ok (I think). I have the desktop app installed as well, and I can send a message from the desktop to the phone. So what is going wrong with the ESP board sending a message to the phone. Any thoughts ?

    Reply
    • OK. Ignore that ! Got it. You have to be very VERY careful of the token string. I had mistaken an upper case “O” for a zero … Now that I have put that right, it is sending messages without a problem 🙂

      Reply
  5. Hello,

    I followed your tutorial. I use the ESP32-WROOM-32D hardware.
    I experienced a small issue – compiler errors with the JSON library.
    I installed version 5 instead of version 6 and code runs like a charm.
    Congrats with your work. I am a fan of RNT.
    Keep up the good work!

    Reply
  6. Hi Rui and Sara. I have a number of ESP32 cam boards working from your excellent tutorials, and am able to view them on my phone using the Netcam Studio platform. I have also just followed this tutorial to set up a motion detector working through a Telegram bot. I particularly like this platform, and I am very pleased with the way it works. I was wondering as both the node mcu and cam modules both have an ESP32 module on board, and the cam module has a few spare I/O’s, if the motion detect / Telegram code in this tutorial could be combined to both run on the cam board simultaneously. That would give a completely independent motion detect warning via Telegram, and then allow the camera to be opened via Netcam. What do you think ?

    Reply
  7. Hi

    I like to test this Tutorial
    – upload seams OK!
    – Telegram BOT is open and active
    – but afterward I get this message in the Serial-Monitor:

    17:03:10.817 -> ets Jun 8 2016 00:22:57
    17:03:10.817 ->
    17:03:10.817 -> rst:0x1 (POWERON_RESET),boot:0x3 (DOWNLOAD_BOOT(UART0/UART1/SDIO_REI_REO_V2))
    17:03:10.817 -> waiting for download

    what can be happen? what means,
    Important: go to your Telegram account and search for your bot. You need to click “start” on a bot before it can message you.

    click “start” where?

    Thank you for your help
    all the best, regards
    Max

    Reply
    • Hello Max, it looks like you’ve restarted your ESP32-CAM board while GPIO 0 is connected to GND.
      If you restart your ESP32-CAM when GPIO 0 is connected to GND the ESP will be in flashing/downloading/uploading mode.

      Remove GPIO 0 from GND, restart your board and it should work now.
      Regards,
      Rui

      Reply
  8. Hello Rui & Sara. Thanks for another very good ESP32/Telegram tutorial. I just setup this tutorial with a SparkFun PIR motion sensor (SEN-13285) and it sends a “Motion Detected” signal repeatedly even though the sensor is not in motion. Is there additional coding required to get this working properly? Also, I added a Adafruit SGP30 air quality sensor to your Telegram Environmental tutorial, but I’m unable to receive an air quality data from the sensor. If you have experience with this sensor, would you please tell me the coding necessary to get the data to show up in Telegraph? Thanks for all of your assistance.

    Reply
  9. Hi
    Thanks for the very interesting script.
    Have it installed for my mailbox and it works.
    Unfortunately, I can only operate ESP32 with motion detector with battery.
    To do this, I need the deep sleep mode.
    How can I include it in your script if a loop section is already programmed there?
    Is that even possible?
    Thanks for all of your assistance.

    Reply
    • Hi.
      If your ESP will be awaken by the PIR motion sensor, you can put the code to send the message in the setup.
      This way, every time it wakes up, it will send a message.
      Regards,
      Sara

      Reply
  10. Hello Sara and Rui
    incredible cool projects you are running – helped a lot to spend the lockdowns! 🙂

    I wanted to make the ESP Telegram messages a bit more lively with emoijs – the following code works and it is only a single line of code:
    bot.sendMessage(CHAT_ID, “\U00002764”, “”); // Emoji Heart
    bot.sendMessage(CHAT_ID, “\U0001F920”, “”); // Emoji Cowboy
    The length of the Emoji identifier is fixed!

    Unicode tables for the emojis can be found e.g. unicode-table.com/en/sets/faces/
    Maybe somebody wants to use emoijs – so I share the code… 😉

    Greetings
    RPI

    Reply
  11. Can Telegram on a device work with a ESP32 that are on the same WIFI but with no internet connection? I want local use only.
    Thanks, I appreciate the great tutorials!

    Reply
  12. Hello.
    I have an issue where I don’t receive any notifications on my phone nor the serial monitor for whether motion has been detected. I am able to receive the “Bot started up” notification, so I have no issues with phone notifications. I have a feeling it might be the “attachinterrupt” function, but I am not really sure what the problem is. I know its not the sensor. I have successfully used 3 motion sensors in another project, so it is not a faulty sensor. I did realize that the pin setup you have has 36 pin, where my ESP32 has 38 pins, so the pin layout is different. For example your 3V3 pin is on the bottom left of the ESP32 module. Mine is on the top right. What would you recommend me do? I feel that just trying each pin would be time consuming and possibly destructive, but effective in narrowing what pin I can and cannot use (That’s if I have an issue with pins at all).

    Reply
    • Hi Ryan.
      That pin shouldn’t be an issue.
      Have you tried using just the PIR sensor with the same pin?
      Just to make sure that the PIR works with that pin?
      Regards,
      Sara

      Reply
      • Hello Sara. Thank you for you response. I found my issue. While attempting what you recommended, I found that I could take off the white dome which revealed pin marks. I couldn’t find the markings previously so I tried to go based off of pictures. Basically user error. But its all good now. This is so cool!!!

        Reply
  13. This may be a silly question, but can the PIR motion sensor detect motion through a window? For example, the sensor is pointed at a window to detect motion from anyone looking in the window from outside, or passing by outside the window? Thanks

    Reply
  14. Dear Sara,

    How to make the bot to notify if PIR or ESP goes offline? Someone who is making this as part of the simple security system would be interested to be notified about this
    Thx

    Reply
  15. Hello guys. Thanks a lot for your instructions. I’m trying this project with VS and PlatformIO. Not sure whether this is an issue, but I’m getting the following error while connecting to WiFi:
    [E][WiFiClientSecure.cpp:127] connect(): start_ssl_client: -1

    Do you have any advice?
    Thank you

    Reply
    • I fixed the issue by setting _use_insecure to true in WiFiClientSecure::connect()
      I don’t know how does it work for others as I couldn’t find any SSL settings in UniversalTelegramBot code.
      Anyway, will work for me for now.

      Reply
  16. Dear Sara,
    Thank you for your excellent tutorials.
    I seem to be doing something wrong as I am not getting any messages on Telegram.
    All settings are as per your tutorial – created new bot, copied token and pasted it into the code, same with chat_id.
    I do get “Motion Detected on the serial monitor.
    On Telegram I click on Start when opening the bot but nothing happens, I do not get the “Bot started up” message.
    Can you please point me in the right direction?

    PS. I also followed your tutorial on “Telegram: Request ESP32/ESP8266 Sensor Readings (Arduino IDE)” but with the same result.

    Thanks
    Braam

    Reply
    • Hi Braam.
      Thanks for following our work.
      Are you sure you copied the token right? It is quite big and if you didn’t do a direct copy and paste and it very likely that there is a mistake somewhere.
      You can use Telegram on your browser to copy the token directly to your code.
      I hope this helps.
      Regards,
      Sara

      Reply
      • I too suffered a problem like this at first and spent a long frstrating time trying to get to the bottom of it, and it was indeed a fault with the enterering of the token. I had an “o” in place of a “0”. Once I finally spotted that and corrected it, I had no further problems

        Reply
        • Thanks for your advice, Geoff. I copied the token directly from Telegram but it did not solve my problem. The sketch works 100% with a 8266 NodeMcu though.
          Much appreciated!

          Reply
  17. Hi Sara,
    Thanks for getting back to me.
    I did copy the token from Telegram on my browser initially without success.
    I was successful when doing Control Outputs using Telegram – ESP32/ESP8266 Sketch on a ESP8266 NodeMcu.
    I do not think the issue is with the token or the chat_id as it works on the other sketch as I said.
    Will keep on trying.

    Reply
      • Hi Sara,
        The same sketch (with obvious modifications) works perfectly on a ESP8266 NodeMcu but will not work on the ESP32. Might be faulty hardware although other (non-Telegram) projects works well with the same ESP32.
        Regards
        Braam

        Reply
  18. Hi,
    Why the motion sensor is defined as an INPUT_PULLUP instead of just INPUT?
    Is there any difference?

    Thank you in advance!

    Reply
    • Hi.
      Is your PIR motion sensor detecting motion?
      Can you double-check that your PIR sensor is working properly?
      Regards,
      Sara

      Reply
  19. Hi Rui and Sara,

    i was wondering does it take a long time to connect to the wifi network? because mine take way too long to connect.

    Reply
  20. Yes I think I might also try this with ESP8266 ….. it would not work with ESP32. I was able to insert all information… bot token chat ID and then watch motion detected on serial monitor but nothing on the Telegram end? I was careful to cut and paste the bot token like others before me have said. Something is not right

    Reply

Leave a Reply to Rui Santos Cancel reply

Download our Free eBooks and Resources

Get instant access to our FREE eBooks, Resources, and Exclusive Electronics Projects by entering your email address below.