esp32_home-assistant_telegram-bot/README.md

👀 esp32_home-assistant_telegram-bot Overview

Home Assistant controlled by telegram bot

🚀 Features

The design aims to provide real-time control and monitoring by leveraging a Telegram bot to verify collected data. This core functionality is extended to enable immediate awareness through voice notifications delivered directly via both the user's mobile device and the home system.

🔎 Preparation

1. Find your wifi's name and password

2. Open the Telegram for the Bot Token and follow these steps:

1. Open Telegram and search for @BotFather.
2. Start a chat with BotFather by typing /start.
3. Create a new bot with the /newbot command.
4. Follow the prompts to name your bot and choose a username.
5. Copy the API token provided by BotFather.

3. Get your Telegram Chat ID:

1. Open Telegram and search for @userinfobot or @get_id_bot.
2. Start a chat with the bot by typing /start.
3. The bot will reply with your numeric user ID.
4. For group chat ID:
   1. Add your bot to the group.
   2. Send a message in the group mentioning the bot.
   3. Use the API call:

      https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
      

      • Look for "chat":{"id": ...} in the JSON response.
      • The chat.id is your group chat ID (usually negative for groups, e.g., -1001234567890).

📦 Setup

1. Refer to the circuit diagram
2. Install the Arduino IDE and open 'esp32_home-assistan_telegram.ino
3. Paste your wifi, bot token and chat id inf.
4. File>Preferences>Additional Boards Manager URLs:(Click the double window button)

Paste this code

https://dl.espressif.com/dl/package_esp32_index.json

5. Click 'OK'
6. Tools>Board>Boards Manager...
7. Search 'esp32' by Espressif Systems, and install it

⚠️ Warning: Make sure you have installed the correct USB driver (CH340, CH341, FT232R / FTDI Driver, CP2102) before connecting the ESP32CAM to your computer.

8. Plug the ESP32CAM into your computer
9. Tools>Port>'Select the esp's port'
10. Tools>Manage Libraries...
11. Click the 'upload ➡️' button
    ✅ To make sure it has been uploaded successfully, you should see the message 'Done uploading'

🎉 Run

1. Disconnect the IO0-GND connection(disable programming mode)
2. Press the reset button on the esp32cam

🔒 License

📜 GPL-3.0 License