Bələdçilər · 8 dəq oxu

ESP32 ilə WhatsApp mesajı göndərmək: CallMeBot ilə sensor bildirişi

ESP32 ilə WhatsApp mesajı göndərmək: CallMeBot API açarı almaq, URL kodlaşdırması, temperatur və qapı sensoru bildirişi, mesaj məhdudiyyəti və sazlama kodları.

ESP32 ilə WhatsApp mesajı göndərmək, evdəki sensor həddi aşanda telefonuna dərhal xəbər almağın ən praktik yollarından biridir. Qapı açılanda, soyuducunun temperaturu yüksələndə və ya çəndəki su azalanda ESP32 internetə qoşulur və tək bir HTTPS sorğusu ilə WhatsApp-ına mesaj buraxır. Bunun üçün ödənişli serverə və ya mürəkkəb kimlik doğrulamasına ehtiyac yoxdur: pulsuz CallMeBot xidməti sənə verdiyi API açarı ilə gələn veb sorğularını birbaşa sənin WhatsApp nömrənə ötürür.

Bu bələdçidə API açarını almağı, Azərbaycan hərfləri olan mesajların niyə və necə URL kodlaşdırması tələb etdiyini və ilk test mesajını göndərməyi öyrənəcəksən. Sonra DHT22 temperatur sensoru və reed qapı sensoru ilə real bildiriş sistemi quracaq, telefonun bildirişlərlə dolmasın deyə mesaj tezliyini məhdudlaşdıracaq, serverin cavablarını oxuyaraq xətaları sazlayacaqsan. ESP32-ni hələ tanımırsansa, əvvəlcə ESP32 nədir? yazısına nəzər sala bilərsən.

CallMeBot nədir, mesaj ESP32-dən WhatsApp-a necə gedir?

WhatsApp şəxsi hesablar üçün cihazların birbaşa istifadə edə biləcəyi açıq API təqdim etmir. CallMeBot isə arada körpü rolunu oynayır: öz WhatsApp hesabı olan bot ona icazə verən nömrələrə mesaj göndərir. Sən ESP32-dən api.callmebot.com/whatsapp.php ünvanına telefon nömrəni, API açarını və mesaj mətnini ehtiva edən GET sorğusu göndərirsən; xidmət sorğunu növbəyə qoyur və bir neçə saniyə ərzində mesaj bot nömrəsindən WhatsApp-ına düşür. Yəni ESP32 baxımından iş veb səhifə açmaqdan ibarətdir. Xidmət şəxsi istifadə üçün pulsuzdur; lakin fərdin işlətdiyi üçüncü tərəf xidməti olduğu üçün sürət limitləri və qaydalar zamanla dəyişə bilər. Buna görə yanğın və ya qaz sızması kimi həyati vəziyyətlərdə onu yeganə bildiriş kanalı kimi istifadə etmə; yanına yerli buzzer və ya ikinci kanal əlavə et.

MetodQuraşdırmaXərcUyğun olduğu hal
CallMeBot (WhatsApp)Tək mesajla API açarıŞəxsi istifadədə pulsuzÖz telefonuna sadə xəbərdarlıqlar
Telegram botuBotFather ilə token almaqPulsuzİkitərəfli komanda, foto, qrup mesajı
WhatsApp Business Cloud APIMeta biznes hesabı və təsdiqlənmiş şablonMesaj başına ödənişli ola bilərMüştərilərə kommersiya bildirişləri
E-poçt (SMTP)Tətbiq şifrəsi lazımdırPulsuzƏtraflı hesabat, gündəlik xülasə

CallMeBot API açarı necə alınır?

  1. CallMeBot saytındakı WhatsApp səhifəsində dərc olunan güncel bot nömrəsini telefonunun kontaktlarına yadda saxla; nömrə zaman-zaman dəyişdiyi üçün başqa mənbədən yox, mütləq oradan yoxla.
  2. WhatsApp-da bu kontakta I allow callmebot to send me messages cümləsini olduğu kimi göndər.
  3. Qısa müddətdə "API Activated for your phone number" ilə başlayan və APIKEY dəyərini ehtiva edən cavab gəlir; bu ədədi qeyd et.
  4. Cavab gəlməsə, eyni mesajı ardıcıl göndərmə; bir müddət (lazım gələrsə ertəsi günə qədər) gözləyib yenidən cəhd et, çünki xidmət yüklü olanda aktivləşdirmə gecikə bilər.
  5. İlk yoxlamanı ESP32 olmadan edə bilərsən: aşağıdakı formatda URL-i öz nömrən və açarınla brauzerin ünvan sətrinə yaz; mesaj gəlirsə, hesabın hazırdır.
API açarı yalnız öz nömrənə mesaj göndərməyə yarayır və şifrə kimi qorunmalıdır. Kodunu GitHub-a və ya foruma yükləyəndə nömrəni və açarı silməyi unutma; açarı ələ keçirən şəxs sənə istədiyi qədər arzuolunmaz mesaj göndərdə bilər və xidmət nömrəni blokla bilər.

Mesaj URL-i və URL kodlaşdırması

Sorğu ünvanı üç parametrdən ibarətdir: phone (ölkə kodu ilə nömrə; Türkiyə üçün +90 ilə başlayır və nömrənin əvvəlindəki 0 yazılmır), apikey və text. Nümunə sorğu belə görünür: api.callmebot.com/whatsapp.php?phone=%2B905551234567&apikey=123456&text=Kapi%20acildi. URL-lərdə boşluq, &, ?, # və + kimi simvolların xüsusi mənası var; məsələn, mesajındakı & işarəsi mətni kəsir və sonrakı hissəni yeni parametr sayır, + işarəsi isə boşluq kimi şərh oluna bilər. Azərbaycan hərfləri UTF-8-də iki bayt tutur və URL-də birbaşa ola bilməz. Həll təhlükəsiz olmayan hər baytı faiz işarəsi və iki onaltılıq rəqəmlə yazmaqdır; buna URL kodlaşdırması (percent-encoding) deyilir.

SimvolUTF-8 baytlarıKodlaşdırılmış forma
boşluq0x20%20
+0x2B%2B
&0x26%26
ı0xC4 0xB1%C4%B1
ş0xC5 0x9F%C5%9F
ü0xC3 0xBC%C3%BC
°0xC2 0xB0%C2%B0
sətir sonu0x0A%0A

Aşağıdakı kodlarda bunu edən kiçik urlEncodeText() funksiyası var: hərf, rəqəm və - _ . ~ simvollarını olduğu kimi saxlayır, qalan hər baytı %XX formasına çevirir. Arduino IDE mənbə fayllarını UTF-8 kimi yadda saxladığı üçün koda yazdığın "Sıcaklık" sözü düzgün baytlarla gedir və WhatsApp-da düzgün görünür. Hazır həll istəsən, Library Manager-dəki UrlEncode kitabxanası da eyni işi urlEncode() funksiyası ilə görür. Mesaja yeni sətir əlavə etmək üçün mətnə \n yazmaq kifayətdir; funksiya bunu %0A-ya çevirir. WhatsApp formatlaşdırması da işləyir: sözü ulduzlar arasına alsan, qalın görünür.

İlk yoxlama: ESP32-dən WhatsApp-a salam

  1. Arduino IDE-də ESP32 plata paketini quraşdır və plata kimi ESP32 Dev Module seç.
  2. Koddakı WIFI_SSID, WIFI_PASS, PHONE və API_KEY dəyərlərini öz məlumatlarınla dəyiş; nömrəni +905551234567 formatında yaz.
  3. Kodu yüklə və Serial Monitor-u 115200 baud sürətində aç.
  4. Wi-Fi qoşulmasından sonra Serial Monitor-da HTTP 200 kodunu və CallMeBot-un cavab mətnini görməlisən; bir neçə saniyə ərzində mesaj telefonuna gəlir.
C++ (Arduino IDE)
1#include <WiFi.h>
2#include <WiFiClientSecure.h>
3#include <HTTPClient.h>
4
5const char* WIFI_SSID = "WIFI_ADIN";       // Wi-Fi ağ adı / Wi-Fi network name
6const char* WIFI_PASS = "WIFI_SIFREN";     // Wi-Fi şifresi / Wi-Fi password
7const char* PHONE     = "+905551234567";   // ülke kodlu numaran / your number with country code
8const char* API_KEY   = "123456";          // CallMeBot API anahtarı / CallMeBot API key
9
10// UTF-8 metni URL için kodlar / URL-encodes UTF-8 text
11String urlEncodeText(const String &s) {
12  const char *digits = "0123456789ABCDEF";
13  String out;
14  out.reserve(s.length() * 3);
15  for (unsigned int i = 0; i < s.length(); i++) {
16    uint8_t c = (uint8_t)s[i];
17    bool safe = (c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') ||
18                (c >= '0' && c <= '9') || c == '-' || c == '_' || c == '.' || c == '~';
19    if (safe) {
20      out += (char)c;
21    } else {
22      out += '%';
23      out += digits[c >> 4];
24      out += digits[c & 0x0F];
25    }
26  }
27  return out;
28}
29
30// WhatsApp mesajı gönderir / sends a WhatsApp message
31bool sendWhatsApp(const String &message) {
32  if (WiFi.status() != WL_CONNECTED) {
33    Serial.println("Wi-Fi yok / no Wi-Fi");
34    return false;
35  }
36  WiFiClientSecure client;
37  client.setInsecure();                      // sertifika doğrulaması yok / no certificate check
38  HTTPClient http;
39  String url = String("https://api.callmebot.com/whatsapp.php?phone=") +
40               urlEncodeText(PHONE) + "&apikey=" + API_KEY +
41               "&text=" + urlEncodeText(message);
42  if (!http.begin(client, url)) {
43    Serial.println("Baglanti baslatilamadi / begin failed");
44    return false;
45  }
46  http.setTimeout(10000);                    // 10 sn zaman aşımı / 10 s timeout
47  int code = http.GET();
48  if (code > 0) {
49    Serial.printf("HTTP %d\n", code);
50    Serial.println(http.getString());        // CallMeBot yanıtı / CallMeBot reply
51  } else {
52    Serial.printf("Hata / error: %s\n", HTTPClient::errorToString(code).c_str());
53  }
54  http.end();
55  return code == 200;
56}
57
58void setup() {
59  Serial.begin(115200);
60  WiFi.mode(WIFI_STA);
61  WiFi.begin(WIFI_SSID, WIFI_PASS);
62  Serial.print("Wi-Fi baglaniyor / connecting");
63  unsigned long start = millis();
64  while (WiFi.status() != WL_CONNECTED && millis() - start < 20000) {
65    delay(500);
66    Serial.print(".");
67  }
68  Serial.println();
69  if (WiFi.status() == WL_CONNECTED) {
70    Serial.print("IP: ");
71    Serial.println(WiFi.localIP());
72    sendWhatsApp("Merhaba! ESP32 çevrimiçi.\nSıcaklık testi: 24,5 °C");
73  } else {
74    Serial.println("Wi-Fi baglantisi kurulamadi / Wi-Fi failed");
75  }
76}
77
78void loop() {
79}
Kod parçasıVəzifəsi
WiFiClientSecure + setInsecure()HTTPS əlaqəsini şifrələnmiş qurur, lakin server sertifikatını yoxlamır
urlEncodeText()Nömrədəki + işarəsini və mesajdakı xüsusi və ya Azərbaycan hərflərini %XX formasına çevirir
http.begin(client, url)Sorğunu hazırlayır; client parametri HTTPS üçün vacibdir
http.GET()Sorğunu göndərir; müsbət dəyər HTTP kodudur, mənfi dəyər əlaqə xətasıdır
http.getString()CallMeBot-un cavab mətnini oxuyur; xəta izahları burada yazılır
http.end()Əlaqəni bağlayır və istifadə olunan yaddaşı azad edir
setInsecure() əlaqəni yenə şifrələyir, yalnız serverin kimliyini yoxlamır. Həvəskar bildirişlər üçün bu kifayətdir və sertifikatın müddəti bitəndə kodunun pozulmasının qarşısını alır. Daha sərt təhlükəsizlik istəsən, serverin kök sertifikatını client.setCACert() ilə verə bilərsən; lakin sertifikat dəyişəndə kodu yeniləməlisən.

Dövrə: temperatur və qapı sensorunun qoşulması

Nümunə sistemdə iki sensor var. DHT22 temperaturu təxminən ±0,5 °C dəqiqliklə ölçür və tək məlumat xətti istifadə edir; çılpaq sensor işlədirsənsə, məlumat pini ilə 3,3 V arasına 10 kΩ-luq pull-up rezistoru əlavə et, modul versiyalarında bu rezistor onsuz da var. Qapı üçün reed rele istifadə edirik: reed qapı çərçivəsinə, maqnit isə qapı qanadına yapışdırılır. Qapı bağlı olanda maqnit kontaktı bağlayır və pin GND-yə çəkilir (LOW); qapı açılanda kontakt açılır və daxili pull-up rezistoru pini HIGH edir. Reed-in iş məntiqini Reed rele yazısında ətraflı tapa bilərsən. Arduino Uno-nun Wi-Fi-ı olmadığı üçün cədvəldə yalnız Wi-Fi-lı platalar yer alır.

QoşulmaESP32ESP8266 (NodeMCU)Raspberry Pi Pico W
DHT22 VCC3V33V33V3(OUT)
DHT22 DATAGPIO 4D2 (GPIO 4)GP16
DHT22 GNDGNDGNDGND
Reed 1-ci ucuGPIO 27D5 (GPIO 14)GP15
Reed 2-ci ucuGNDGNDGND
ESP32-nin GPIO 34, 35, 36 və 39 pinləri yalnız giriş kimi işləyir və daxili pull-up rezistorları yoxdur. Reed-i bu pinlərdən birinə qoşub INPUT_PULLUP istifadə etsən, pin havada qalır və daim saxta "qapı açıldı" mesajları alırsan. Həmçinin GPIO 0, 2, 12 və 15 kimi açılış (strapping) pinlərinə sensor qoşmaqdan da çəkin; plata açılışda yanlış rejimdə başlaya bilər.

Hədd aşılanda bildiriş: temperatur və qapı həyəcanı

Real bildiriş sistemində ən vacib sual "nə vaxt mesaj göndərməli?" sualıdır. Temperatur 30 °C-dən yüksək qaldığı müddətcə hər 5 saniyədən bir mesaj göndərsən, dəqiqədə 12 bildiriş alarsan. Bunun qarşısını almaq üçün kod iki texnika istifadə edir. Birincisi histerezis: həyəcan 30 °C-də işə düşür, lakin temperatur 28 °C-yə enmədən sıfırlanmır; beləliklə 29,9 ilə 30,1 arasında gedib-gələn dəyər səni bildiriş yağışına tutmur. İkincisi gözləmə müddəti (cooldown): eyni növdən iki mesaj arasında temperatur üçün 10 dəqiqə, qapı üçün 1 dəqiqə keçməlidir. Qapı sensorunda daimi vəziyyəti deyil, yalnız bağlıdan açığa keçid anını tuturuq. Kod üçün Library Manager-dən DHT sensor library (Adafruit) kitabxanasını asılılıqları ilə birlikdə quraşdır.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <WiFiClientSecure.h>
3#include <HTTPClient.h>
4#include <DHT.h>
5
6const char* WIFI_SSID = "WIFI_ADIN";
7const char* WIFI_PASS = "WIFI_SIFREN";
8const char* PHONE     = "+905551234567";
9const char* API_KEY   = "123456";
10
11#define DHT_PIN  4      // DHT22 veri pini / DHT22 data pin
12#define DOOR_PIN 27     // reed röle / reed switch
13
14DHT dht(DHT_PIN, DHT22);
15
16const float TEMP_HIGH  = 30.0;                // alarm eşiği / alarm threshold
17const float TEMP_RESET = 28.0;                // sıfırlama eşiği (histerezis) / reset threshold (hysteresis)
18const unsigned long READ_MS     = 5000;       // ölçüm aralığı / read interval
19const unsigned long TEMP_GAP_MS = 600000UL;   // sıcaklık mesajları arası 10 dk / 10 min between temp messages
20const unsigned long DOOR_GAP_MS = 60000UL;    // kapı mesajları arası 1 dk / 1 min between door messages
21const unsigned long MIN_GAP_MS  = 15000UL;    // iki istek arası en az 15 sn / at least 15 s between requests
22
23bool tempAlarm = false;
24bool lastDoorOpen = false;
25unsigned long lastRead = 0;
26unsigned long lastTempMsg = 0;
27unsigned long lastDoorMsg = 0;
28unsigned long lastRequest = 0;
29
30// UTF-8 metni URL için kodlar / URL-encodes UTF-8 text
31String urlEncodeText(const String &s) {
32  const char *digits = "0123456789ABCDEF";
33  String out;
34  out.reserve(s.length() * 3);
35  for (unsigned int i = 0; i < s.length(); i++) {
36    uint8_t c = (uint8_t)s[i];
37    bool safe = (c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') ||
38                (c >= '0' && c <= '9') || c == '-' || c == '_' || c == '.' || c == '~';
39    if (safe) {
40      out += (char)c;
41    } else {
42      out += '%';
43      out += digits[c >> 4];
44      out += digits[c & 0x0F];
45    }
46  }
47  return out;
48}
49
50bool sendWhatsApp(const String &message) {
51  if (WiFi.status() != WL_CONNECTED) {         // ESP32 kendisi yeniden bağlanır / ESP32 reconnects itself
52    Serial.println("Wi-Fi yok / no Wi-Fi");
53    return false;
54  }
55  if (lastRequest != 0 && millis() - lastRequest < MIN_GAP_MS) {
56    Serial.println("Cok sik istek, atlandi / too frequent, skipped");
57    return false;
58  }
59  lastRequest = millis();
60  WiFiClientSecure client;
61  client.setInsecure();
62  HTTPClient http;
63  String url = String("https://api.callmebot.com/whatsapp.php?phone=") +
64               urlEncodeText(PHONE) + "&apikey=" + API_KEY +
65               "&text=" + urlEncodeText(message);
66  if (!http.begin(client, url)) {
67    return false;
68  }
69  http.setTimeout(10000);
70  int code = http.GET();
71  if (code > 0) {
72    Serial.printf("HTTP %d: %s\n", code, http.getString().c_str());
73  } else {
74    Serial.printf("Hata / error: %s\n", HTTPClient::errorToString(code).c_str());
75  }
76  http.end();
77  return code == 200;
78}
79
80void setup() {
81  Serial.begin(115200);
82  pinMode(DOOR_PIN, INPUT_PULLUP);             // kapalı kapı = LOW / closed door = LOW
83  dht.begin();
84  WiFi.mode(WIFI_STA);
85  WiFi.begin(WIFI_SSID, WIFI_PASS);
86  unsigned long start = millis();
87  while (WiFi.status() != WL_CONNECTED && millis() - start < 20000) {
88    delay(500);
89    Serial.print(".");
90  }
91  Serial.println(WiFi.status() == WL_CONNECTED ? "\nWi-Fi OK" : "\nWi-Fi yok / no Wi-Fi");
92  lastDoorOpen = digitalRead(DOOR_PIN) == HIGH; // açılıştaki durum / initial state
93}
94
95void loop() {
96  unsigned long now = millis();
97
98  // Kapı: yalnızca kapalı -> açık geçişi / door: only closed -> open edge
99  bool doorOpen = digitalRead(DOOR_PIN) == HIGH;
100  if (doorOpen && !lastDoorOpen) {
101    if (lastDoorMsg == 0 || now - lastDoorMsg >= DOOR_GAP_MS) {
102      if (sendWhatsApp("Kapı açıldı!")) {
103        lastDoorMsg = millis();
104      }
105    } else {
106      Serial.println("Kapi acildi, bekleme suresinde / door opened, in cooldown");
107    }
108  }
109  lastDoorOpen = doorOpen;
110
111  // Sıcaklık: 5 sn'de bir oku / temperature: read every 5 s
112  if (now - lastRead >= READ_MS) {
113    lastRead = now;
114    float t = dht.readTemperature();
115    if (isnan(t)) {
116      Serial.println("DHT22 okunamadi / read failed");
117    } else {
118      Serial.printf("Sicaklik / temp: %.1f C\n", t);
119      if (!tempAlarm && t >= TEMP_HIGH) {
120        if (lastTempMsg == 0 || now - lastTempMsg >= TEMP_GAP_MS) {
121          String msg = String("Uyarı: sıcaklık ") + String(t, 1) + " °C (eşik " + String(TEMP_HIGH, 1) + " °C)";
122          if (sendWhatsApp(msg)) {
123            tempAlarm = true;
124            lastTempMsg = millis();
125          }
126        }
127      } else if (tempAlarm && t <= TEMP_RESET) {
128        tempAlarm = false;                       // alarm sıfırlandı / alarm reset
129        sendWhatsApp(String("Sıcaklık normale döndü: ") + String(t, 1) + " °C");
130      }
131    }
132  }
133  delay(20);
134}

Kodda millis() əsaslı zamanlama istifadə olunduğu üçün loop() heç vaxt uzun müddət gözləmir; yalnız mesaj göndərilərkən HTTPS əlaqəsi 1–3 saniyə çəkir. sendWhatsApp() daxilindəki MIN_GAP_MS yoxlaması hansı səbəbdən olursa olsun iki sorğu arasında ən azı 15 saniyə qoyur; API açarın səhvdirsə və ya xidmət xəta qaytarırsa, kod serveri daimi sorğuya basmır. Bu qısa aralıqda baş verən hadisə mesaj kimi getmir, yalnız Serial Monitor-a yazılır. Temperatur mesajı uğurla göndərilə bilməsə, tempAlarm bayrağı true olmadığı üçün sonrakı ölçmələrdə yenidən cəhd edilir. DHT22-ni 2 saniyədən tez-tez oxumaq lazım deyil; burada hər 5 saniyədən bir oxunur və oxuma uğursuz olsa (NaN), mesaj göndərilmədən xəta yazılır. Delay əvəzinə millis istifadəsinin təfərrüatları üçün millis və delay yazısına bax.

Mesaj tezliyini məhdudlaşdırmaq niyə şərtdir?

CallMeBot pulsuz xidmətdir və sui-istifadənin qarşısını almaq üçün qısa müddətdə çox sorğu göndərən nömrələri müvəqqəti blokla bilər. Dəqiq limitlər zamanla dəyişə bildiyi üçün ən təhlükəsiz yanaşma bildiriş sistemini dəqiqədə bir neçə mesajı heç vaxt aşmayacaq şəkildə qurmaqdır. Üstəlik bu sənin də xeyrinədir: daim səslənən telefona bir müddət sonra fikir verilmir və real həyəcan qaçırılır. Yaxşı bildiriş nadir və mənalı olandır.

  • Hadisə əsasında göndər: Vəziyyət dəyişəndə (qapı açıldı, temperatur həddi keçildi) bir dəfə mesaj göndər; vəziyyət davam etdikcə təkrarlama.
  • Histerezis burax: Həyəcan və sıfırlama hədlərini ən azı 1–2 °C aralı seç; rütubət kimi dəyişkən dəyərlərdə aralığı daha da geniş tut.
  • Növ üzrə gözləmə müddəti: Qapı üçün 1 dəqiqə, temperatur üçün 10–30 dəqiqə kimi müddətlər istifadə et.
  • Xülasə mesajı: Qısa müddətdə çox hadisə olarsa, onları say və tək mesajla "son 10 dəqiqədə qapı 7 dəfə açıldı" kimi bildir.
  • Gündəlik yuxarı hədd: Sayğacla gündə ən çoxu, məsələn, 50 mesaja icazə ver; hədd dolanda yalnız Serial Monitor-a yaz.
  • Açılış mesajını məhdudlaşdır: ESP32 hər sıfırlananda "onlayn" mesajı göndərirsə, qida dalğalanmalarında bildiriş yağışı yarana bilər; lazım gələrsə bu mesajı sil.

Raspberry Pi Pico W ilə MicroPython

Wi-Fi-lı Pico W da eyni xidmətdən istifadə edə bilər; MicroPython-dakı urequests modulu HTTPS sorğularını dəstəkləyir. Aşağıdakı kod eyni URL kodlaşdırma məntiqini Python-a keçirir, DHT22-ni GP16-dan, reed-i GP15-dən oxuyur. Pico W üçün hazırlanmış MicroPython versiyasında dht modulu daxili gəldiyi üçün əlavə fayl köçürməyə ehtiyac yoxdur. Wi-Fi-ı olmayan klassik Pico-da bu kod işləmir. MicroPython-a yenisənsə, MicroPython əsasları yazısı yaxşı başlanğıcdır.

MicroPython
1import network
2import time
3import urequests
4import dht
5from machine import Pin
6
7SSID = "WIFI_ADIN"
8PASSWORD = "WIFI_SIFREN"
9PHONE = "+905551234567"     # ülke kodlu numara / number with country code
10API_KEY = "123456"          # CallMeBot API anahtarı / CallMeBot API key
11
12TEMP_HIGH = 30.0            # alarm eşiği / alarm threshold
13TEMP_RESET = 28.0           # sıfırlama eşiği / reset threshold
14DOOR_GAP = 60000            # kapı mesajları arası 1 dk / 1 min between door messages
15
16sensor = dht.DHT22(Pin(16))
17door = Pin(15, Pin.IN, Pin.PULL_UP)   # kapalı kapı = 0 / closed door = 0
18
19def url_encode(s):
20    out = ""
21    for b in s.encode("utf-8"):
22        if 48 <= b <= 57 or 65 <= b <= 90 or 97 <= b <= 122 or b in (45, 46, 95, 126):
23            out += chr(b)
24        else:
25            out += "%{:02X}".format(b)
26    return out
27
28def send_whatsapp(msg):
29    url = ("https://api.callmebot.com/whatsapp.php?phone=" + url_encode(PHONE)
30           + "&apikey=" + API_KEY + "&text=" + url_encode(msg))
31    try:
32        r = urequests.get(url)
33        ok = r.status_code == 200
34        print("HTTP", r.status_code, r.text)
35        r.close()
36        return ok
37    except Exception as e:
38        print("Hata / error:", e)
39        return False
40
41wlan = network.WLAN(network.STA_IF)
42wlan.active(True)
43wlan.connect(SSID, PASSWORD)
44for _ in range(40):                    # en fazla 20 sn bekle / wait up to 20 s
45    if wlan.isconnected():
46        break
47    time.sleep(0.5)
48print("IP:", wlan.ifconfig()[0])
49
50last_open = door.value() == 1
51last_door_msg = None
52temp_alarm = False
53last_read = time.ticks_ms()
54
55while True:
56    now = time.ticks_ms()
57    is_open = door.value() == 1
58    if is_open and not last_open:      # kapalı -> açık / closed -> open
59        if last_door_msg is None or time.ticks_diff(now, last_door_msg) >= DOOR_GAP:
60            if send_whatsapp("Kapı açıldı! (Pico W)"):
61                last_door_msg = time.ticks_ms()
62    last_open = is_open
63
64    if time.ticks_diff(now, last_read) >= 5000:
65        last_read = now
66        try:
67            sensor.measure()
68            t = sensor.temperature()
69            print("Sicaklik / temp:", t)
70            if not temp_alarm and t >= TEMP_HIGH:
71                if send_whatsapp("Uyarı: sıcaklık {:.1f} °C".format(t)):
72                    temp_alarm = True
73            elif temp_alarm and t <= TEMP_RESET:
74                temp_alarm = False
75                send_whatsapp("Sıcaklık normale döndü: {:.1f} °C".format(t))
76        except OSError:
77            print("DHT22 okunamadi / read failed")
78    time.sleep_ms(50)

ESP8266 (NodeMCU, Wemos D1 Mini) ilə istifadə

ESP8266 platalarında məntiq tamamilə eynidir; yalnız başlıq faylları dəyişir. WiFi.h əvəzinə ESP8266WiFi.h, HTTPClient.h əvəzinə ESP8266HTTPClient.h əlavə et. WiFiClientSecure sinfi ESP8266-da BearSSL əsaslıdır və setInsecure() ilə eyni şəkildə istifadə olunur; http.begin(client, url) sətri də dəyişmədən işləyir. ESP8266-nın RAM-ı ESP32-yə nisbətən çox az olduğu üçün TLS əlaqəsi yaddaşın mühüm hissəsini istifadə edir; böyük kitabxanalarla birlikdə işlədirsənsə, String birləşdirmələrini azalt və sorğu bitəndə http.end() çağırmağı unutma. Pin nömrələri üçün cədvəldəki ESP8266 sütunundan istifadə et.

WhatsApp bildirişli layihə ideyaları

  • Hərəkət həyəcanı: Evdə heç kim yoxkən PIR sensoru hərəkət aşkarlasa, mesaj göndər.
  • Qaz sızması xəbərdarlığı: MQ-2 qaz sensoru həddi aşanda həm buzzer səsləndir, həm WhatsApp-a yaz.
  • Su basqını detektoru: Paltaryuyan maşının altına qoyduğun su səviyyə sensoru islananda xəbər ver.
  • Bitki suvarma xatırlatması: Torpaq rütubət sensoru quruluğu aşkarlayanda "güldan susayıb" mesajı göndər.
  • Şaxta həyəcanı: Istixana və ya balkon temperaturu 2 °C-dən aşağı düşəndə xəbərdar et; təfərrüatlar şaxta həyəcanı yazısındadır.
  • Batareya ilə işləyən poçt qutusu sensoru: ESP32-ni deep sleep rejimində gözlət; qapaq açılanda oyansın, tək mesaj göndərsin və yenidən yatsın.

Tez-tez edilən səhvlər və sazlama

ƏlamətMümkün səbəbHəll
Wi-Fi əlaqəsi heç qurulmurSəhv şifrə və ya 5 GHz şəbəkəESP32 yalnız 2,4 GHz şəbəkələrə qoşulur; SSID və şifrəni yoxla
HTTP -1 və ya connection refusedHTTPS müştərisi yoxdur, DNS və ya internet problemihttp.begin(client, url) formasını və setInsecure() sətrini yoxla
HTTP 200-dür, amma mesaj gəlmirNömrə formatı səhvdir və ya xidmət yavaşdır+90 ilə başlayan, 0-sız nömrə istifadə et; bir neçə dəqiqə gözlə və cavab mətnini oxu
Cavabda API açarının yararsız olduğu yazılırSəhv və ya çatışmayan açarAktivləşdirmə mesajındakı ədədi yenidən kopyala; nömrə və açar eyni hesaba aid olmalıdır
Mesaj yarımçıq kəsilirMətndəki & və ya # kodlaşdırılmayıbBütün mətni urlEncodeText() ilə kodlaşdır
Hərflər %C4%B1 kimi görünürMətn iki dəfə kodlaşdırılıbMətni yalnız bir dəfə kodlaşdır
Mesaj göndərilərkən ESP32 sıfırlanırWi-Fi cərəyan zərbəsində gərginlik düşürKeyfiyyətli USB kabel və ən azı 500 mA verə bilən qida mənbəyi istifadə et
Daim "qapı açıldı" mesajı gəlirPull-up olmayan pin və ya boş naqilGPIO 27 kimi pull-up dəstəkli pin istifadə et, qoşulmanı möhkəmləndir
Sazlayarkən zənciri hissə-hissə yoxla: yaranan URL-i Serial Monitor-a yazdır, kopyalayıb brauzerdə aç. Brauzerdə mesaj gəlirsə, problem ESP32 tərəfindədir (Wi-Fi, HTTPS müştərisi, qida); gəlmirsə, nömrə, açar və ya xidmətlə bağlıdır. Wi-Fi problemləri üçün ESP32 Wi-Fi-a qoşulmur, qəfil sıfırlanmalar üçün ESP32 brownout yazılarına bax. Real API açarını ehtiva edən URL-i heç kimlə paylaşma.

WhatsApp bildirişi sensor layihələrini "ekrana baxanda başa düşərəm" səviyyəsindən "harada olsam da xəbərim olar" səviyyəsinə qaldırır. İkitərəfli komanda, foto və qrup mesajı istəyirsənsə, ESP32 Telegram botu yaxşı növbəti addımdır. BlueGrays tətbiqində ESP32 Wi-Fi əlaqəsi, HTTPClient ilə hava proqnozu, DHT22 ölçməsi və hərəkət həyəcanı kimi layihələri addım-addım dövrə sxemi və kodu ilə tapa bilərsən, bu yazıdakı WhatsApp funksiyasını onlara asanlıqla əlavə edə bilərsən.

Tez-tez verilən suallar

ESP32 ilə WhatsApp mesajı pulsuz göndərmək olarmı?

Bəli. CallMeBot xidməti şəxsi istifadədə pulsuzdur və yalnız API açarı istəyir; ESP32 tək bir HTTPS GET sorğusu ilə öz nömrənə mesaj göndərir. Rəsmi WhatsApp Business Cloud API isə biznes hesabı və təsdiqlənmiş şablonlar tələb edir və mesaj başına ödənişli ola bilər.

CallMeBot API açarı gəlməsə nə etməliyəm?

Əvvəlcə bot nömrəsinin CallMeBot saytındakı güncel nömrə olduğunu və aktivləşdirmə cümləsini olduğu kimi yazdığını yoxla. Cavab bir neçə dəqiqə ərzində gəlməsə, mesajı ardıcıl göndərmə; bir müddət, lazım gələrsə ertəsi günə qədər gözləyib yenidən cəhd et. Xidmət yüklü olanda aktivləşdirmə gecikə bilər.

CallMeBot ilə başqa nömrəyə mesaj göndərmək olarmı?

Hər API açarı aktivləşdirməni edən tək bir nömrəyə bağlıdır və yalnız həmin nömrəyə mesaj göndərir. Ailə üzvlərindən birinin də bildiriş alması üçün o şəxs də botu aktivləşdirib öz açarını almalıdır; ESP32 kodu iki ayrı sorğu göndərə bilər. Qruplara bildiriş göndərmək istəyirsənsə, Telegram botu daha uyğun seçimdir.

ESP32 WhatsApp mesajında Azərbaycan hərfləri necə göndərilir?

Mesaj mətnini URL-ə əlavə etməzdən əvvəl UTF-8 baytlarını URL kodlaşdırması ilə %XX formasına çevirməlisən; məsələn, ı hərfi %C4%B1 kimi gedir. Bu yazıdakı urlEncodeText() funksiyası və ya UrlEncode kitabxanası bunu avtomatik edir. Mətni iki dəfə kodlaşdırmamağa diqqət et, əks halda WhatsApp-da hərf əvəzinə kodlar görərsən.

ESP32 bildirişləri üçün WhatsApp yoxsa Telegram daha yaxşıdır?

Yalnız öz telefonuna qısa xəbərdarlıqlar göndərəcəksənsə, CallMeBot ilə WhatsApp ən sürətli quraşdırmadır. Telefondan ESP32-yə komanda göndərmək, foto paylaşmaq və ya qrupa mesaj yazmaq istəyirsənsə, Telegram Bot API rəsmi, pulsuz və daha çevik həlldir.

Arduino Uno ilə WhatsApp mesajı göndərmək olarmı?

Arduino Uno-nun Wi-Fi-ı olmadığı üçün tək başına göndərə bilməz. Uno-ya ESP-01 kimi Wi-Fi modulu əlavə etmək mümkündür, amma HTTPS sorğusu bu quruluşda əziyyətlidir. Ən praktik həll birbaşa ESP32 və ya ESP8266 istifadə etmək və ya Uno-nun sensor məlumatını serial xətlə ESP32-yə ötürməkdir.

Bütün layihələrə bax
ESP32 Wi-Fi STA qoşulması (LCD ekranlı)
ES-25Qabaqcıl

ESP32 Wi-Fi STA qoşulması (LCD ekranlı)

Bu layihədə ESP32-ni Station (STA) rejimində evdəki Wi-Fi şəbəkəsinə təhlükəsiz və xətaya davamlı şəkildə qoşuruq. SSID/şifrəni secrets.h faylına ayıraraq Git-ə sızmasının qarşısını alır, avtomatik yenidən qoşulma mexanizmi qurur, RSSI siqnal səviyyəsini və IP ünvanını I2C LCD ekranda göstəririk. Daxili LED vəziyyət göstəricisi kimi işləyir. İstehsal səviyyəli qoşulma meneceridir.

4.4(21)
38
ESP32 HTTPClient + hava proqnozu API (LCD ekranlı)
ES-31Qabaqcıl
Premium

ESP32 HTTPClient + hava proqnozu API (LCD ekranlı)

Bu layihədə ESP32 ilə internet üzərindən hava proqnozu API-sinə (wttr.in) HTTPClient.h istifadə edərək REST API sorğusu göndəririk. ArduinoJson v7 ilə gələn JSON cavabını emal edib şəhər, temperatur, rütubət, hava vəziyyəti və külək məlumatlarını I2C LCD ekranda göstəririk. wttr.in API açarı tələb etmir; istədiyin şəhərin adını yazmaq kifayətdir.

4.7(13)
20
ESP32 hərəkət siqnalizasiya sistemi (PIR + buzzer + LED + Telegram)
ES-41Qabaqcıl
Premium

ESP32 hərəkət siqnalizasiya sistemi (PIR + buzzer + LED + Telegram)

PIR sensoru hərəkət aşkarlayanda buzzer-i və LED-i işə salan, eyni zamanda Telegram vasitəsilə sahibinə ani bildiriş göndərən ağıllı təhlükəsizlik siqnalizasiyası. Təkrarlanan həyəcanların tezliyini məhdudlaşdırmaq üçün 30 saniyəlik gözləmə müddəti (cooldown) var; bu müddət PIR sensorunun yanlış aşkarlamalarını aradan qaldırmır. Ev, qaraj, anbar və ya iş otağı kimi yerlərdə istifadə oluna bilər.

9
ESP32 DHT22 temperatur və rütubət (LCD ekranlı)
ES-15Orta

ESP32 DHT22 temperatur və rütubət (LCD ekranlı)

DHT22 sensoru ilə mühitin temperaturunu və rütubət nisbətini ölçüb 16x2 I2C LCD ekranda real vaxtda göstərən layihədir. Adafruit DHT kitabxanasından istifadə edilərək tək naqilli (one-wire) protokolla sensordan məlumat oxunur. Bu layihə IoT hava stansiyası, ağıllı ev avtomatlaşdırması və ya istixanalarda mühit izləmə sistemlərinin əsasını təşkil edir. DHT22 ilə əlaqə ESP32-nin GPIO 4 pini üzərindən təmin olunur.

4.8(38)
57
ESP32 MQ-2 qaz/tüstü detektoru həyəcan siqnalı
ES-20Orta

ESP32 MQ-2 qaz/tüstü detektoru həyəcan siqnalı

Bu layihədə MQ-2 qaz sensoru modulu ilə yanıcı qaz (LPG, metan, propan) və tüstü aşkarlanır; aşkarlama anında passiv buzzer vasitəsilə siren kimi həyəcan səsi çalınır. Sensorun rəqəmsal hədd çıxışı (DO) ESP32-nin GPIO 4 pininə qoşulur; qaz və ya tüstü həddi aşanda DO LOW olur və həyəcan siqnalı işə düşür. Həssaslıq modul üzərindəki potensiometrlə tənzimlənir. Passiv buzzer tone() funksiyası ilə idarə olunaraq iki tezlik arasında keçidli siren effekti yaradılır.

4.7(29)
44
Reed rele qapı sensoru
AR-38Başlanğıc
Premium

Reed rele qapı sensoru

Qapının açıq, yoxsa bağlı olduğunu işığa baxaraq anla. Qapıya kiçik maqnit, çərçivəyə isə maqniti hiss edən açar taxırsan; qapı bağlı olanda ikisi yan-yana durur və yaşıl LED yanır, qapı açılıb…

4.7(34)
44
ESP32 temperatur loqqeri (DHT22 + DS1307 RTC + microSD + OLED)
ES-40Qabaqcıl
Premium

ESP32 temperatur loqqeri (DHT22 + DS1307 RTC + microSD + OLED)

ESP32 ilə zaman etiketli temperatur və rütubət qeydiyyat sistemi qur! Bu layihədə DHT22 sensoru ilə dəqiqədə bir temperatur və rütubət oxuyub DS1307 RTC modulundan aldığın real zaman etiketi ilə microSD karta CSV formatında yazırıq. OLED ekranda iri yazı ilə son temperatur, rütubət faizi, zaman damğası və ümumi qeyd sayı canlı göstərilir.

4.7(7)
12