Automation With Telegram and ESP32

About: Do you like technology? Follow my channel on Youtube and my Blog. In them I put videos every week of microcontrollers, arduinos, networks, among other subjects. New tutorials on Tuesdays and Fridays.

Today, we will create a bot on ESP8266 / ESP32 to serve as a contact on the Telegram. Thus, we can modify / check the state of a relay, and check the temperature and humidity according to messages we send to it. It is as if this contact was a real person who was executing their commands, which were sent by the program of message exchanges.

Step 1: Assembly

Step 2: Update the ESP8266 Core

In case of problems with ESP8266, in the Arduino IDE go to:

Tools-> Board-> Manage Plates...

Update the ESP8266 (in this case, we use version 2.4.2)

Step 3: ArduinoJson Library

In the Arduino IDE, go to Sketch-> Include Library-> Manage Libraries...

Install ArduinoJson (in this case, we use version 5.13.2)

Step 4: UniversalTelegramBot Library

In the Arduino IDE, go to Sketch-> Include Library-> Manage Libraries...

Install UniversalTelegramBot

Step 5: SimpleDHT Library

In the Arduino IDE, go to Sketch-> Include Library-> Manage Libraries...

Install SimpleDHT

Step 6: Creating a Bot in Telegram

1. Open the Telegram and search for botfather. Select the one with the blue mark

2. On this screen, click on GETTING STARTED

3. BotFather will show you some options

4. Type / newbot

5. Enter the name you want for your bot

6. Enter the username for your bot. It should end with bot (Example: TestFKBot).

Save the generated token to replace in source .ino

Step 7: TelegramBot.ino

Declarations and variables

#if defined(ESP8266)
#include <ESP8266WiFi.h> #else #include <WiFi.h> #endif #include <WiFiClientSecure.h>

#include <UniversalTelegramBot.h>

#include <SimpleDHT.h>

//Pino onde está o Relê #define RELAY_PIN 5 //Pino onde está o DHT22 #define DHT_PIN 4 //Intervalo entre as checagens de novas mensagens #define INTERVAL 1000 //Token do seu bot. Troque pela que o BotFather te mostrar #define BOT_TOKEN "000000000:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" //Troque pelo ssid e senha da sua rede WiFi #define SSID "SSID" #define PASSWORD "12345678"

Commands and settings

//Comandos aceitos
const String LIGHT_ON = "ligar a luz"; const String LIGHT_OFF = "desligar a luz"; const String CLIMATE = "clima"; const String STATS = "status"; const String START = "/start"; //Objeto que realiza a leitura da temperatura e umidade SimpleDHT22 dht; //Estado do relê int relayStatus = HIGH; //Cliente para conexões seguras WiFiClientSecure client; //Objeto com os métodos para comunicarmos pelo Telegram UniversalTelegramBot bot(BOT_TOKEN, client); //Tempo em que foi feita a última checagem uint32_t lastCheckTime = 0; //Quantidade de usuários que podem interagir com o bot #define SENDER_ID_COUNT 2 //Ids dos usuários que podem interagir com o bot. //É possível verificar seu id pelo monitor serial ao enviar uma mensagem para o bot String validSenderIds[SENDER_ID_COUNT] = {"012345678", "123456789"};

Setup

void setup()
{ Serial.begin(115200); //Inicializa o WiFi e se conecta à rede setupWiFi(); //Coloca o pino do relê como saída e enviamos o estado atual pinMode(RELAY_PIN, OUTPUT); digitalWrite(RELAY_PIN, relayStatus); }

SetupWiFi

void setupWiFi()
{ Serial.print("Connecting to SSID: "); Serial.println(SSID); //Inicia em modo station e se conecta à rede WiFi WiFi.mode(WIFI_STA); WiFi.begin(SSID, PASSWORD); //Enquanto não estiver conectado à rede while (WiFi.status() != WL_CONNECTED) { Serial.print("."); delay(500); } //Se chegou aqui está conectado Serial.println(); Serial.println("Connected"); }

Loop

void loop()
{ //Tempo agora desde o boot uint32_t now = millis(); //Se o tempo passado desde a última checagem for maior que o intervalo determinado if (now - lastCheckTime > INTERVAL) { //Coloca o tempo de útlima checagem como agora e checa por mensagens lastCheckTime = now; int numNewMessages = bot.getUpdates(bot.last_message_received + 1); handleNewMessages(numNewMessages); } }

handleNewMessages

void handleNewMessages(int numNewMessages)
{ for (int i=0; i<numNewMessages; i++) //para cada mensagem nova

{ String chatId = String(bot.messages[i].chat_id); //id do chat String senderId = String(bot.messages[i].from_id); //id do contato Serial.println("senderId: " + senderId); //mostra no monitor serial o id de quem mandou a mensagem boolean validSender = validateSender(senderId); //verifica se é o id de um remetente da lista de remetentes válidos if(!validSender) //se não for um remetente válido { bot.sendMessage(chatId, "Desculpe mas você não tem permissão", "HTML"); //envia mensagem que não possui permissão e retorna sem fazer mais nada continue; //continua para a próxima iteração do for (vai para próxima mensgem, não executa o código abaixo) } String text = bot.messages[i].text; //texto que chegou if (text.equalsIgnoreCase(START)) { handleStart(chatId, bot.messages[i].from_name); //mostra as opções } else if (text.equalsIgnoreCase(LIGHT_ON)) { handleLightOn(chatId); //liga o relê } else if(text.equalsIgnoreCase(LIGHT_OFF)) { handleLightOff(chatId); //desliga o relê } else if(text.equalsIgnoreCase(CLIMATE)) { handleClimate(chatId); //envia mensagem com a temperatura e umidade } else if (text.equalsIgnoreCase(STATS)) { handleStatus(chatId); //envia mensagem com o estado do relê, temperatura e umidade } else { handleNotFound(chatId); //mostra mensagem que a opção não é válida e mostra as opções } }//for }

validateSender

boolean validateSender(String senderId)
{ //Para cada id de usuário que pode interagir com este bot for(int i=0; i<SENDER_ID_COUNT; i++)

{ //Se o id do remetente faz parte do array retornamos que é válido if(senderId == validSenderIds[i]) { return true; } } //Se chegou aqui significa que verificou todos os ids e não encontrou no array return false; }

handleStart

void handleStart(String chatId, String fromName)
{ //Mostra Olá e o nome do contato seguido das mensagens válidas String message = "<b>Olá" + fromName + ".</b>\n";

message += getCommands();

bot.sendMessage(chatId, message, "HTML"); }

getCommands

String getCommands()
{ //String com a lista de mensagens que são válidas e explicação sobre o que faz String message = "Os comandos disponíveis são:\n\n"; message += "<b>" + LIGHT_ON + "<b>: Para ligar a luz\n"; message += "<b>" + LIGHT_OFF + "<b>: Para desligar a luz\n"; message += "<b>" + CLIMATE + "<b>: Para verificar o clima\n"; message += "<b>" + STATS + "<b>: Para verificar o estado da luz e a temperatura"; return message; }

handleLightOn

void handleLightOn(String chatId)
{ //Liga o relê e envia mensagem confirmando a operação relayStatus = LOW; //A lógica do nosso relê é invertida digitalWrite(RELAY_PIN, relayStatus); bot.sendMessage(chatId, "A luz está <b>acesa</b>", "HTML"); }

handleLightOff

void handleLightOff(String chatId)
{ //Desliga o relê e envia mensagem confirmando a operação relayStatus = HIGH; //A lógica do nosso relê é invertida digitalWrite(RELAY_PIN, relayStatus); bot.sendMessage(chatId, "A luz está <b>apagada</b>", "HTML"); }

handleClimate

void handleClimate(String chatId)
{ //Envia mensagem com o valor da temperatura e da umidade bot.sendMessage(chatId, getClimateMessage(), ""); }

getClimateMessage

String getClimateMessage()
{ //Faz a leitura da temperatura e da umidade float temperature, humidity; int status = dht.read2(DHT_PIN, &temperature, &humidity, NULL); //Se foi bem sucedido if (status == SimpleDHTErrSuccess) { //Retorna uma string com os valores String message = ""; message += "A temperatura é de " + String(temperature)+ " °C e "; message += "a umidade é de " + String(humidity) + "%"; return message; } //Se não foi bem sucedido retorna um mensagem de erro return "Erro ao ler temperatura e umidade"; }

handleStatus

void handleStatus(String chatId)
{ String message = ""; //Verifica se o relê está ligado ou desligado e gera a mensagem de acordo if(relayStatus == LOW) //A lógica do nosso relê é invertida { message += "A luz está acesa\n"; } else { message += "A luz está apagada\n"; } //Adiciona à mensagem o valor da temperatura e umidade message += getClimateMessage(); //Envia a mensagem para o contato bot.sendMessage(chatId, message, ""); }

handleNotFound

void handleNotFound(String chatId)
{ //Envia mensagem dizendo que o comando não foi encontrado e mostra opções de comando válidos String message = "Comando não encontrado\n"; message += getCommands(); bot.sendMessage(chatId, message, "HTML"); }

Step 8: Interacting With Bot on the Telegram

Go to BotFather and click on the link to talk to the bot

Click on START

Send the commands and check the messages that the bot returns

Step 9: Files

Download the files

PDF

INO

Share

    Recommendations

    • Paper Contest

      Paper Contest
    • Sweet Treats Challenge

      Sweet Treats Challenge
    • Epilog X Contest

      Epilog X Contest

    Discussions