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");
}