Published July 11, 2026 © GPL3+

DIY ESP32 Telegram Flood Protection System - Smart Home

How to build a highly reliable, automated Flood Protection System using an ESP32 microcontroller and a Telegram Bot

BeginnerFull instructions provided3 hours67

DIY ESP32 Telegram Flood Protection System - Smart Home

Things used in this project

Hardware components

Espressif ESP32 Development Board - Developer Edition

DFRobot Photoelectric Liquid Level Sensor

Buzzer

LED (generic)

General Purpose Transistor NPN

Small 5V water pump

resistors

Software apps and online services

Arduino IDE

Hand tools and fabrication machines

Soldering iron (generic)

Solder Wire, Lead Free

Story

Recently I had an unpleasant experience in my home, specifically my ground floor was flooded as a result of a burst water pipe, and at that moment I was absent. So I decided to develop a warning system for such phenomena that would also take some action in order to prevent greater damage from occurring. For this purpose, I purchased the Gravity: Photoelectric High Accuracy Liquid Level Sensor for Arduino from DFRobot which has good sensitivity and no need for mechanical parts and is also corrosion resistant and can handle high temperature and high pressure.

The way this photoelectric sensor works is as follows:

- When the detected level is in air, due to reflect of the prism, most of light will enter receiver LED, optical level sensor will output high voltage.

- When the detected level is in water, due to refraction of the liquid, just less of light enter receiver LED, optical level sensor will output low voltage.

The level of the output voltage from this sensor is the same as the power supply, and since it can be powered by 3V3, I can connect it directly to the ESP32 Input. It can be mechanically installed in any direction, and specifically for this demonstration I made a small stand on which the sensor is mounted. The tip of the sensor should be just above the floor to detect even the slightest accumulation of water. As I mentioned earlier, I plan to use an ESP32 microcontroller for several reasons. It is cheap, has low power consumption, supports Wi-Fi and Bluetooth, and has other advantages over most Arduino boards.

A basic requirement when planning my project was the option to receive information about the current situation no matter where I am, via the mobile network on my smartphone. There are several services for this purpose, and I chose the Telegram platform because it allows the creation of bots that can perform automated tasks, and completely free of charge, so because of these conveniences it is often called a programmer's paradise.

This project is sponsored by PCBWay . From July 1st to July 31st, 2026, PCBWay is organizing 12th anniversary campaig. Grab your discount and unlock more rewards in the form of Exclusive Coupons, PCB Order for Just $5, Turnkey Electronic Design Services, Up to 50% off for 3D printing & CNC Machining, and Special Sales in PCBWay Store. Next, Join the fun with interactive games and receive your exclusive Engineer Color Personality, Click the Box to Participate in the Lucky Draw, Show Your Colorful Projects, and Vote for the Most Popular Badge.

So, if you haven't had one before, you need to open a Telegram account and create a bot.

Step-by-Step Guide: How to Create a Telegram Bot and Get Your Chat ID

Part 1: Creating the Telegram Bot

1. Download and install Telegram if you haven’t already.

2. In the Telegram search bar, type @BotFather and select the official verified account.

3. Press the "Start" button to activate BotFather.

4. In the message box, type and send: `/newbot`

5. Enter a friendly name for your new bot (for example: `micemk_wateralarm_bot`).

6. Next, choose a unique Username for your bot. Note: It must end with `_bot` (for example: `Mircemk_bot`).

7. Once the username is accepted, BotFather will instantly generate an HTTP API Token. Make sure to copy and save this token securely, as you will need it for your ESP32 code.

Part 2: Obtaining Your Chat ID

1. In the Telegram search bar, search for your newly created bot username (e.g., @Mircemk_bot) and press "Start" to initialize it.

2. Go back to the Telegram search bar and search for a utility bot named: @IDBot

3. Open the chat with @IDBot and send the command: `/getid`

4. The bot will instantly reply with your unique, numeric Chat ID. Copy and save this number to use in your Arduino configuration.

It is important that when creating a telegram bot we get two distinct unique strings of characters, one is the HTTP API Token, and the other is the ID. We need this information later when creating the ESP32 code. Having already mentioned the code, I should say that it is designed in a way that can be easily changed several parameters, including the warning text that we receive on the smartphone.

At first, the credentials from the local Wi-Fi network should be entered, and then the received Telegram Token and ID. Next is the definition of the pins that we use on the ESP32, and then the corresponding messages that we receive on the smartphone depending on the state. As I mentioned earlier, these messages can be changed according to our own wishes without any other changes to the code. It is also very important to mention that with this telegram bot we have the possibility of two-way communication, which means that in addition to receiving messages, we can also give commands via the smartphone to perform some tasks remotely. To install the code without errors, we need to select "ESP32 DEV Board" in the board manager and install the provided libraries UniversalTelegramBot-1.3.0 and ArduinoJson 6.21.6

The following is a demonstration of the functionality of the system in real conditions. For this purpose, I will use a container in which I will simulate a flood and a miniature water pump to drain the water. First, I will bring power to the ESP32 via the USB port. After a few seconds, we receive a message on the smartphone that the system is active. Now let's check the status in the room where the system is installed. For this purpose, we write the command: /status. Soon we receive a system report that describes the state in detail, in this case a dry room, the valve is open, and the blue and red LEDs are OFF. These messages arrive at the smartphone via the mobile network, which means we will receive them anywhere in the world.

As I mentioned before, the communication system is two-way, which means that we can also send commands to the ESP32 from anywhere in the world via the mobile network. For this purpose, I installed a Blue LED on the microcontroller, which can be any device in the home. To activate this LED, we type Blueled on. Similarly, to turn it off, we type Blueled off. So instead of this LED, we can connect a device in the home, for example an electronic lock that we can control remotely.

Now I will simulate a flood in the house by filling this container with water. Here is how the system should behave. When the water rises to the sensor, ESP32 should automatically turn on the water pump, while the red LED will light up and the sound alarm will be activated, and at the same time we will receive a message on the smartphone that a flood has occurred. When the pump pumps the water to the required level, it automatically turns off and the user receives a message on the smartphone that the water has been removed and the room is dry. Instead of the blue LED, we can connect the solenoid valve from the main water supply via a relay and thus completely turn off the water supply remotely.

In a real situation, sensor and pump would be located below floor level in a specially designed space for that purpose.

And finally a short conclusion. Integrating a software stability filter transforms a standard DIY sensor into a robust, industrial-grade protection system. Combined with the instant notifications of a Telegram Bot, this ESP32 project offers an incredibly efficient and affordable solution for smart home safety.

Code

Code

// by mircemk May, 2025

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

// --- WIFI & TELEGRAM CONFIGURATION ---
const char* ssid = "***********";
const char* password = "*********";
#define BOTtoken "***********************************"
#define CHAT_ID "**********"

// --- PIN DEFINITIONS ---
const int sensorPin  = 23;   // FS-IR02 Water Sensor input
const int relayPin   = 25;   // Relay for Water Valve and Pump
const int buzzerPin  = 15;   // Active Buzzer pin
const int blueLedPin = 21;   // Independent LED for remote control (GPIO 21)
const int redLedPin  = 17;   // Status Indicator LED for Flood

// --- SYSTEM VARIABLES ---
bool isFloodDetected = false;
bool blueLedStatus = false;
unsigned long lastBotCheck;
int botRequestDelay = 1000; 

// Timing for non-blocking buzzer
unsigned long lastBuzzerToggle = 0;
bool buzzerState = false;

// --- STABILITY FILTER VARIABLES (TUNED) ---
unsigned long lastStateChangeTime = 0;     // Timer to check how long the signal is steady
const unsigned long stabilityDelay = 1000; // Required time in ms for a stable signal (Tuned to 1 second)
bool lastValidSensorState = LOW;           // Filtered/confirmed sensor state

WiFiClientSecure client;
UniversalTelegramBot bot(BOTtoken, client);

// -------------------------------------------------------------
//  Telegram Message Handler
// -------------------------------------------------------------
void handleNewMessages(int numNewMessages) {
  for (int i = 0; i < numNewMessages; i++) {
    String chat_id = String(bot.messages[i].chat_id);
    if (chat_id != CHAT_ID) continue; // Security check

    String text = bot.messages[i].text;
    String from_name = bot.messages[i].from_name;

    if (text == "/start") {
      String welcome = "Welcome " + from_name + " to Flood Guard Bot.\n\n";
      welcome += "COMMANDS:\n";
      welcome += "/status - Check water levels & hardware state\n";
      welcome += "/blueled on - Turn ON the remote LED (GPIO 21)\n";
      welcome += "/blueled off - Turn OFF the remote LED (GPIO 21)\n";
      bot.sendMessage(CHAT_ID, welcome, "");
    }

    // Explicit command to turn the Blue LED ON
    if (text == "/blueled on") {
      blueLedStatus = true;
      digitalWrite(blueLedPin, HIGH);
      bot.sendMessage(CHAT_ID, "External LED is now ON (High)", "");
    }

    // Explicit command to turn the Blue LED OFF
    if (text == "/blueled off") {
      blueLedStatus = false;
      digitalWrite(blueLedPin, LOW);
      bot.sendMessage(CHAT_ID, "External LED is now OFF (Low)", "");
    }

    if (text == "/status") {
      String statusMsg = "--- SYSTEM REPORT ---\n";
      statusMsg += isFloodDetected ? "💧 ALERT: FLOOD DETECTED!" : "✅ STATUS: ALL DRY";
      statusMsg += "\nValve/Pump: ";
      statusMsg += (digitalRead(relayPin) == HIGH) ? "CLOSED (Safe)" : "OPEN (Normal)";
      statusMsg += "\nRed LED (GPIO 17): ";
      statusMsg += (digitalRead(redLedPin) == HIGH) ? "ON" : "OFF";
      statusMsg += "\nRemote LED (GPIO 21): ";
      statusMsg += blueLedStatus ? "ON" : "OFF";
      bot.sendMessage(CHAT_ID, statusMsg, "");
    }
  }
}

// -------------------------------------------------------------
//  Setup
// -------------------------------------------------------------
void setup() {
  Serial.begin(115200);
  
  pinMode(sensorPin, INPUT_PULLUP);
  pinMode(relayPin, OUTPUT);
  pinMode(buzzerPin, OUTPUT);
  pinMode(blueLedPin, OUTPUT);
  pinMode(redLedPin, OUTPUT);
  
  digitalWrite(relayPin, LOW);   // Valve starts open
  digitalWrite(buzzerPin, LOW);  // Buzzer starts silent
  digitalWrite(blueLedPin, LOW); // Remote LED starts OFF
  digitalWrite(redLedPin, LOW);  // Red LED starts OFF

  WiFi.begin(ssid, password);
  client.setInsecure(); 

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  
  Serial.println("\nWiFi Connected!");
  bot.sendMessage(CHAT_ID, "System V0.3 Online: Monitoring with 1s Stability Filter...", "");
}

// -------------------------------------------------------------
//  Main Loop
// -------------------------------------------------------------
void loop() {
  // Read instant physical sensor state (HIGH = Water, LOW = Dry)
  int currentRawInput = digitalRead(sensorPin);

  // --- STABILITY FILTER (DEBOUNCE) LOGIC ---
  if (currentRawInput != lastValidSensorState) {
    if (lastStateChangeTime == 0) {
      lastStateChangeTime = millis(); // Start counting
    }
    
    // If the signal stays changed continuously for 1 full second (1000ms)
    if (millis() - lastStateChangeTime >= stabilityDelay) {
      lastValidSensorState = currentRawInput; // Lock in the new state
      lastStateChangeTime = 0;                // Reset timer
    }
  } else {
    // Noise or temporary fluctuation detected, reset timer
    lastStateChangeTime = 0;
  }

  // --- AUTOMATIC FLOOD RESPONSE (Based on Filtered State) ---
  if (lastValidSensorState == HIGH) { 
    // Confirmed Flood Event
    digitalWrite(relayPin, HIGH);  // Activate water valve / pump
    digitalWrite(redLedPin, HIGH); // Light up flood indicator
    
    // Non-blocking rapid buzzer beep (Tuned to 100ms intervals)
    if (millis() - lastBuzzerToggle >= 100) {
      lastBuzzerToggle = millis();
      buzzerState = !buzzerState;
      digitalWrite(buzzerPin, buzzerState);
    }

    // Send single alert message to Telegram
    if (!isFloodDetected) {
      bot.sendMessage(CHAT_ID, "⚠️ ALERT: 💧 FLOOD DETECTED! Water valve closed and pump activated.", "");
      isFloodDetected = true;
    }
  } 
  else {
    // Confirmed Dry Conditions
    digitalWrite(relayPin, LOW);   // Reset valve/pump
    digitalWrite(buzzerPin, LOW);  // Turn off buzzer
    digitalWrite(redLedPin, LOW);  // Turn off flood indicator
    
    if (isFloodDetected) {
      bot.sendMessage(CHAT_ID, "✅ System Clear: Water level back to normal.", "");
      isFloodDetected = false;
    }
  }

  // --- CHECK TELEGRAM COMMANDS ---
  if (millis() > lastBotCheck + botRequestDelay) {
    int numNewMessages = bot.getUpdates(bot.last_message_received + 1);
    while (numNewMessages) {
      handleNewMessages(numNewMessages);
      numNewMessages = bot.getUpdates(bot.last_message_received + 1);
    }
    lastBotCheck = millis();
  }
}