ESP32 & ESP8266 Connectivity · Intermediate · Notifications

ESP8266 Telegram Alert Node

A threshold that messages your phone once when it is crossed, and once when it clears.

Firmware status: Generated from this project's own pin map and compiled with arduino-cli for esp8266:esp8266:nodemcuv2 before publication; bench validation on your hardware is still required.

Board: ESP8266 (NodeMCU v3 / Wemos D1 mini) · ESP8266EX @ 80 MHz · 3.3 V logic · build for esp8266:esp8266:nodemcuv2.

What you will build

An ESP8266 watching a sensor and sending an edge-triggered message rather than a stream of them.

Components

  • ESP8266 board
  • Analog sensor
  • Telegram bot token and chat id
  • USB cable and a 5 V supply

Pin map for this build

Sketch constantPinWhat it is
PIN_SENSEA0Sensor — analog output, 3.3 V maximum

Tools

  • USB programming cable
  • Multimeter
  • Current-limited bench supply (for anything that switches a load)
  • Small screwdriver and wire cutters

Build sequence

  1. Create a bot through BotFather and get the token; send it one message so the chat id exists.
  2. Set BOT_TOKEN and CHAT_ID, flash, and confirm the online message arrives.
  3. Cross the threshold and confirm exactly one alert.
  4. Return below it and confirm exactly one recovery message.

Test and expected result

One message per crossing, one per recovery, and no messages while the value sits on one side.

Acceptance checks

alert on crossing, recovery on clearing, no repeats, token not committed

Safety and limits

The bot token is a password. Do not commit it, and revoke it from Telegram if a board with it is lost.

Hardware scope

HTTPS POST to a public API, edge detection, no continuous polling of the sensor.

Connection diagram

Connection diagram for ESP8266 Telegram Alert Node

Download the connection diagram (SVG)

Download the Arduino sketch (E21_esp8266_telegram_alert_node.ino)

Guide source: the sketch on this page was generated from the pin map above and compiled for esp8266:esp8266:nodemcuv2 before publication.

Related projects

Back to all project guides · Study the course