Rehberler · 8 dk okuma

ESP32 WhatsApp Mesaj Gönderme: CallMeBot ile Sensör Bildirimi

ESP32 ile WhatsApp mesaj gönderme: CallMeBot API anahtarı alma, URL kodlama, sıcaklık ve kapı sensörü bildirimi, mesaj sınırlama ve hata ayıklama kodları.

ESP32 ile WhatsApp mesaj gönderme, evdeki bir sensör eşiği aştığında telefonuna anında haber almanın en pratik yollarından biridir. Kapı açıldığında, buzdolabının sıcaklığı yükseldiğinde ya da depodaki su azaldığında ESP32 internete bağlanır ve tek bir HTTPS isteğiyle WhatsApp'ına mesaj bırakır. Bunun için ücretli bir sunucuya ya da karmaşık bir kimlik doğrulamaya gerek yoktur: ücretsiz CallMeBot servisi, sana verdiği API anahtarıyla gelen web isteklerini doğrudan senin WhatsApp numarana iletir.

Bu rehberde API anahtarını almayı, Türkçe karakterli mesajların neden ve nasıl URL kodlaması gerektirdiğini ve ilk test mesajını göndermeyi öğreneceksin. Ardından DHT22 sıcaklık sensörü ve reed kapı sensörüyle gerçek bir bildirim sistemi kuracak, telefonunun bildirimlerle dolmaması için mesaj sıklığını sınırlayacak, sunucunun yanıtlarını okuyarak hata ayıklayacaksın. ESP32'yi henüz tanımıyorsan önce ESP32 Nedir? yazısına göz atabilirsin.

CallMeBot nedir, mesaj ESP32'den WhatsApp'a nasıl gider?

WhatsApp, kişisel hesaplar için cihazların doğrudan kullanabileceği açık bir API sunmaz. CallMeBot ise araya giren bir köprüdür: kendi WhatsApp hesabı olan bir bot, ona izin veren numaralara mesaj gönderir. Sen ESP32'den api.callmebot.com/whatsapp.php adresine telefon numaranı, API anahtarını ve mesaj metnini içeren bir GET isteği yaparsın; servis isteği kuyruğa alır ve birkaç saniye içinde mesaj bot numarasından WhatsApp'ına düşer. Yani ESP32 açısından iş, bir web sayfasını açmaktan ibarettir. Servis kişisel kullanım için ücretsizdir; ancak bir bireyin işlettiği üçüncü taraf bir hizmet olduğu için hız sınırları ve kurallar zamanla değişebilir. Bu yüzden yangın ya da gaz kaçağı gibi hayati durumlarda onu tek bildirim kanalı olarak kullanma; yanına yerel bir buzzer ya da ikinci bir kanal ekle.

YöntemKurulumMaliyetUygun olduğu durum
CallMeBot (WhatsApp)Tek mesajla API anahtarıKişisel kullanımda ücretsizKendi telefonuna basit uyarılar
Telegram botuBotFather ile token almaÜcretsizÇift yönlü komut, fotoğraf, grup mesajı
WhatsApp Business Cloud APIMeta işletme hesabı ve onaylı şablonMesaj başına ücretlendirilebilirMüşterilere ticari bildirimler
E-posta (SMTP)Uygulama şifresi gerekirÜcretsizAyrıntılı rapor, günlük özet

CallMeBot API anahtarı nasıl alınır?

  1. CallMeBot'un sitesindeki WhatsApp sayfasında yayımlanan güncel bot numarasını telefonunun rehberine kaydet; numara zaman zaman değiştiği için başka bir kaynaktan değil, mutlaka oradan kontrol et.
  2. WhatsApp'ta bu kişiye I allow callmebot to send me messages cümlesini aynen gönder.
  3. Kısa süre içinde "API Activated for your phone number" ile başlayan ve APIKEY değerini içeren bir yanıt gelir; bu sayıyı not al.
  4. Yanıt gelmezse aynı mesajı art arda gönderme; bir süre (gerekirse ertesi gün) bekleyip yeniden dene, çünkü servis yoğun olduğunda aktivasyon gecikebilir.
  5. İlk denemeyi ESP32 olmadan yapabilirsin: aşağıdaki biçimdeki URL'yi kendi numaran ve anahtarınla tarayıcının adres çubuğuna yaz; mesaj geliyorsa hesabın hazırdır.
API anahtarı yalnızca kendi numarana mesaj göndermeye yarar ve bir şifre gibi korunmalıdır. Kodunu GitHub'a ya da bir foruma yüklerken numaranı ve anahtarını silmeyi unutma; anahtarı ele geçiren biri sana istediği kadar istenmeyen mesaj attırabilir ve servis numaranı engelleyebilir.

Mesaj URL'si ve URL kodlama

İstek adresi üç parametreden oluşur: phone (ülke koduyla birlikte numara; Türkiye için +90 ile başlar ve numaranın başındaki 0 yazılmaz), apikey ve text. Örnek bir istek şöyle görünür: api.callmebot.com/whatsapp.php?phone=%2B905551234567&apikey=123456&text=Kapi%20acildi. URL'lerde boşluk, &, ?, # ve + gibi karakterlerin özel anlamı vardır; örneğin mesajındaki bir & işareti metni keser ve sonrasını yeni bir parametre sanır, + işareti ise boşluk olarak yorumlanabilir. Türkçe harfler UTF-8'de iki bayt yer tutar ve URL'de doğrudan bulunamaz. Çözüm, güvenli olmayan her baytı yüzde işareti ve iki onaltılık haneyle yazmaktır; buna URL kodlama (percent-encoding) denir.

KarakterUTF-8 baytKodlanmış hali
boşluk0x20%20
+0x2B%2B
&0x26%26
ı0xC4 0xB1%C4%B1
ş0xC5 0x9F%C5%9F
ü0xC3 0xBC%C3%BC
°0xC2 0xB0%C2%B0
satır sonu0x0A%0A

Aşağıdaki kodlarda bunu yapan küçük bir urlEncodeText() fonksiyonu var: harf, rakam ve - _ . ~ karakterlerini olduğu gibi bırakır, geri kalan her baytı %XX biçimine çevirir. Arduino IDE kaynak dosyalarını UTF-8 olarak kaydettiği için kodun içine yazdığın "Sıcaklık" kelimesi doğru baytlarla gider ve WhatsApp'ta düzgün görünür. Hazır bir çözüm istersen Kütüphane Yöneticisi'ndeki UrlEncode kütüphanesi de aynı işi urlEncode() fonksiyonuyla yapar. Mesaja alt satır eklemek için metne \n yazman yeterlidir; fonksiyon bunu %0A'ya çevirir. WhatsApp biçimlendirmesi de çalışır: bir kelimeyi yıldızlar arasına alırsan kalın görünür.

İlk test: ESP32'den WhatsApp'a merhaba

  1. Arduino IDE'de ESP32 kart paketini kur ve kart olarak ESP32 Dev Module seç.
  2. Koddaki WIFI_SSID, WIFI_PASS, PHONE ve API_KEY değerlerini kendi bilgilerinle değiştir; numarayı +905551234567 biçiminde yaz.
  3. Kodu yükle ve Seri Monitörü 115200 baud hızında aç.
  4. Wi-Fi bağlantısından sonra Seri Monitörde HTTP 200 kodunu ve CallMeBot'un yanıt metnini görmelisin; birkaç saniye içinde mesaj telefonuna gelir.
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ıGörevi
WiFiClientSecure + setInsecure()HTTPS bağlantısını şifreli kurar ama sunucu sertifikasını doğrulamaz
urlEncodeText()Numaradaki + işaretini ve mesajdaki özel ya da Türkçe karakterleri %XX biçimine çevirir
http.begin(client, url)İsteği hazırlar; client parametresi HTTPS için şarttır
http.GET()İsteği gönderir; pozitif değer HTTP kodu, negatif değer bağlantı hatasıdır
http.getString()CallMeBot'un yanıt metnini okur; hata açıklamaları burada yazar
http.end()Bağlantıyı kapatır ve kullanılan belleği serbest bırakır
setInsecure() bağlantıyı yine şifreler, yalnızca sunucunun kimliğini doğrulamaz. Hobi bildirimleri için bu yeterlidir ve sertifikanın süresi dolduğunda kodunun bozulmasını önler. Daha sıkı güvenlik istersen sunucunun kök sertifikasını client.setCACert() ile verebilirsin; ancak sertifika değiştiğinde kodu güncellemen gerekir.

Devre: sıcaklık ve kapı sensörü bağlantısı

Örnek sistemde iki sensör var. DHT22 sıcaklığı yaklaşık ±0,5 °C doğrulukla ölçer ve tek veri hattı kullanır; çıplak sensör kullanıyorsan veri pini ile 3,3 V arasına 10 kΩ'luk bir pull-up direnci ekle, modül sürümlerinde bu direnç zaten vardır. Kapı için reed röle kullanıyoruz: reed kapı kasasına, mıknatıs ise kapı kanadına yapıştırılır. Kapı kapalıyken mıknatıs kontağı kapatır ve pin GND'ye çekilir (LOW); kapı açılınca kontak açılır ve dahili pull-up direnci pini HIGH yapar. Reed'in çalışma mantığını Reed Röle yazısında ayrıntılı bulabilirsin. Arduino Uno'nun Wi-Fi'ı olmadığı için tabloda yalnızca Wi-Fi'lı kartlar yer alıyor.

BağlantıESP32ESP8266 (NodeMCU)Raspberry Pi Pico W
DHT22 VCC3V33V33V3(OUT)
DHT22 DATAGPIO 4D2 (GPIO 4)GP16
DHT22 GNDGNDGNDGND
Reed 1. uçGPIO 27D5 (GPIO 14)GP15
Reed 2. uçGNDGNDGND
ESP32'nin GPIO 34, 35, 36 ve 39 pinleri yalnızca giriş olarak çalışır ve dahili pull-up dirençleri yoktur. Reed'i bu pinlerden birine bağlayıp INPUT_PULLUP kullanırsan pin havada kalır ve sürekli sahte "kapı açıldı" mesajları alırsın. Ayrıca GPIO 0, 2, 12 ve 15 gibi açılış (strapping) pinlerine sensör bağlamaktan da kaçın; kart açılışta yanlış modda başlayabilir.

Eşik aşılınca bildirim: sıcaklık ve kapı alarmı

Gerçek bir bildirim sisteminde en önemli soru "ne zaman mesaj atmalı?" sorusudur. Sıcaklık 30 °C'nin üstünde kaldığı sürece her 5 saniyede bir mesaj atarsan dakikada 12 bildirim alırsın. Bunu önlemek için kod iki teknik kullanıyor. Birincisi histerezis: alarm 30 °C'de devreye girer ama sıcaklık 28 °C'ye inmeden sıfırlanmaz; böylece 29,9 ile 30,1 arasında gidip gelen bir değer seni bildirim yağmuruna tutmaz. İkincisi bekleme süresi (cooldown): aynı türden iki mesaj arasında sıcaklık için 10 dakika, kapı için 1 dakika geçmesi gerekir. Kapı sensöründe sürekli durumu değil, yalnızca kapalıdan açığa geçiş anını yakalıyoruz. Kod için Kütüphane Yöneticisi'nden DHT sensor library (Adafruit) kütüphanesini bağımlılıklarıyla birlikte kur.

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() tabanlı zamanlama kullanıldığı için loop() hiçbir zaman uzun süre beklemez; yalnızca mesaj gönderilirken HTTPS bağlantısı 1–3 saniye sürer. sendWhatsApp() içindeki MIN_GAP_MS kontrolü, hangi sebeple olursa olsun iki istek arasında en az 15 saniye bırakır; API anahtarın yanlışsa ya da servis hata döndürüyorsa kod sunucuyu sürekli isteğe boğmaz. Bu kısa aralıkta gelen bir olay mesaj olarak gitmez, yalnızca Seri Monitöre yazılır. Sıcaklık mesajı başarıyla gönderilemezse tempAlarm bayrağı true olmadığı için sonraki ölçümlerde yeniden denenir. DHT22'yi 2 saniyeden sık okumamak gerekir; burada 5 saniyede bir okunuyor ve okuma başarısız olursa (NaN) mesaj atılmadan hata yazılıyor. Delay yerine millis kullanmanın ayrıntıları için millis ve delay yazısına bakabilirsin.

Mesaj sıklığını sınırlamak neden şart?

CallMeBot ücretsiz bir servistir ve kötüye kullanımı önlemek için kısa sürede çok fazla istek gönderen numaraları geçici olarak engelleyebilir. Kesin sınırlar zaman içinde değişebildiği için en güvenli yaklaşım, bildirim sistemini dakikada birkaç mesajı asla aşmayacak şekilde tasarlamaktır. Üstelik bu senin de işine gelir: sürekli ötüp duran bir telefon bir süre sonra görmezden gelinir ve gerçek bir alarm kaçırılır. İyi bir bildirim, nadir ve anlamlı olandır.

  • Olay bazlı gönder: Durum değiştiğinde (kapı açıldı, sıcaklık eşiği geçti) bir kez mesaj at; durum sürdükçe tekrar etme.
  • Histerezis bırak: Alarm ve sıfırlama eşiklerini en az 1–2 °C aralıklı seç; nem gibi oynak değerlerde aralığı daha da geniş tut.
  • Tür başına bekleme süresi: Kapı için 1 dakika, sıcaklık için 10–30 dakika gibi süreler kullan.
  • Özet mesaj: Kısa sürede çok olay olursa bunları say ve tek mesajda "son 10 dakikada kapı 7 kez açıldı" diye bildir.
  • Günlük üst sınır: Bir sayaçla günde en fazla örneğin 50 mesaja izin ver; sınır dolunca yalnızca Seri Monitöre yaz.
  • Açılış mesajını sınırla: ESP32 her resetlendiğinde "çevrimiçi" mesajı atıyorsa, güç dalgalanmalarında bildirim yağmuru oluşabilir; gerekirse bu mesajı kaldır.

Raspberry Pi Pico W ile MicroPython

Wi-Fi'lı Pico W de aynı servisi kullanabilir; MicroPython'daki urequests modülü HTTPS isteklerini destekler. Aşağıdaki kod aynı URL kodlama mantığını Python'a taşır, DHT22'yi GP16'dan, reed'i GP15'ten okur. Pico W için hazırlanan MicroPython sürümünde dht modülü yerleşik geldiği için ek dosya kopyalaman gerekmez. Wi-Fi'ı olmayan klasik Pico'da bu kod çalışmaz. MicroPython'a yeniysen MicroPython Temelleri yazısı iyi bir başlangıçtı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) ile kullanmak

ESP8266 kartlarında mantık tamamen aynıdır; yalnızca başlık dosyaları değişir. WiFi.h yerine ESP8266WiFi.h, HTTPClient.h yerine ESP8266HTTPClient.h ekle. WiFiClientSecure sınıfı ESP8266'da BearSSL tabanlıdır ve setInsecure() ile aynı şekilde kullanılır; http.begin(client, url) satırı da değişmeden çalışır. ESP8266'nın RAM'i ESP32'ye göre çok daha az olduğu için bir TLS bağlantısı belleğin önemli bir kısmını kullanır; büyük kütüphanelerle birlikte kullanıyorsan String birleştirmelerini azalt ve isteği bitirince http.end() çağırmayı unutma. Pin numaraları için tablodaki ESP8266 sütununu kullan.

WhatsApp bildirimli proje fikirleri

  • Hareket alarmı: Evde kimse yokken PIR sensörü hareket algılarsa mesaj at.
  • Gaz kaçağı uyarısı: MQ-2 gaz sensörü eşiği aşınca hem buzzer öttür hem WhatsApp'a yaz.
  • Su baskını dedektörü: Çamaşır makinesinin altına koyduğun su seviye sensörü ıslandığında haber ver.
  • Bitki sulama hatırlatıcısı: Toprak nem sensörü kuruluğu algılayınca "saksı susadı" mesajı gönder.
  • Don alarmı: Sera ya da balkon sıcaklığı 2 °C'nin altına düşünce uyar; ayrıntılar don alarmı yazısında.
  • Pille çalışan posta kutusu sensörü: ESP32'yi deep sleep modunda beklet; kapak açılınca uyansın, tek mesaj atsın ve yeniden uyusun.

Sık hatalar ve hata ayıklama

BelirtiOlası sebepÇözüm
Wi-Fi bağlantısı hiç kurulmuyorYanlış şifre ya da 5 GHz ağESP32 yalnızca 2,4 GHz ağlara bağlanır; SSID ve şifreyi kontrol et
HTTP -1 ya da connection refusedHTTPS istemcisi yok, DNS ya da internet sorunuhttp.begin(client, url) biçimini ve setInsecure() satırını kontrol et
HTTP 200 ama mesaj gelmiyorNumara biçimi hatalı ya da servis yavaş+90 ile başlayan, 0'sız numara kullan; birkaç dakika bekle ve yanıt metnini oku
Yanıtta API anahtarının geçersiz olduğu yazıyorYanlış ya da eksik anahtarAktivasyon mesajındaki sayıyı yeniden kopyala; numara ve anahtar aynı hesaba ait olmalı
Mesaj yarıda kesiliyorMetindeki & ya da # kodlanmamışTüm metni urlEncodeText() ile kodla
Türkçe harfler %C4%B1 gibi görünüyorMetin iki kez kodlanmışMetni yalnızca bir kez kodla
Mesaj gönderilirken ESP32 resetleniyorWi-Fi akım darbesinde gerilim düşüyorKaliteli USB kablo ve en az 500 mA verebilen besleme kullan
Sürekli "kapı açıldı" mesajıPull-up olmayan pin ya da gevşek kabloGPIO 27 gibi pull-up destekli bir pin kullan, bağlantıyı sağlamlaştır
Hata ayıklarken zinciri parça parça test et: oluşturulan URL'yi Seri Monitöre yazdır, kopyalayıp tarayıcıda aç. Tarayıcıda mesaj geliyorsa sorun ESP32 tarafındadır (Wi-Fi, HTTPS istemcisi, besleme); gelmiyorsa numara, anahtar ya da servisle ilgilidir. Wi-Fi sorunları için ESP32 Wi-Fi bağlanmıyor, ani resetler için ESP32 brownout yazılarına bakabilirsin. Gerçek API anahtarını içeren URL'yi kimseyle paylaşma.

WhatsApp bildirimi, sensör projelerini "ekrana bakınca anlarım" seviyesinden "nerede olursam olayım haberim olur" seviyesine taşır. Çift yönlü komutlar, fotoğraf ve grup mesajı istiyorsan ESP32 Telegram botu iyi bir sonraki adımdır. BlueGrays uygulamasında ESP32 Wi-Fi bağlantısı, HTTPClient ile hava durumu, DHT22 ölçümü ve hareket alarmı gibi projeleri adım adım devre şeması ve koduyla bulabilir, bu yazıdaki WhatsApp fonksiyonunu onlara kolayca ekleyebilirsin.

Sıkça sorulan sorular

ESP32 ile WhatsApp mesajı ücretsiz gönderilebilir mi?

Evet. CallMeBot servisi kişisel kullanımda ücretsizdir ve yalnızca bir API anahtarı ister; ESP32 tek bir HTTPS GET isteğiyle kendi numarana mesaj gönderir. Resmi WhatsApp Business Cloud API ise işletme hesabı ve onaylı şablonlar gerektirir ve mesaj başına ücretlendirilebilir.

CallMeBot API anahtarı gelmezse ne yapmalıyım?

Önce bot numarasının CallMeBot sitesindeki güncel numara olduğunu ve aktivasyon cümlesini aynen yazdığını kontrol et. Yanıt birkaç dakika içinde gelmezse mesajı art arda gönderme; bir süre, gerekirse ertesi güne kadar bekleyip tekrar dene. Servis yoğun olduğunda aktivasyon gecikebilir.

CallMeBot ile başka bir numaraya mesaj atılabilir mi?

Her API anahtarı, aktivasyonu yapan tek bir numaraya bağlıdır ve yalnızca o numaraya mesaj gönderir. Ailenden birinin de bildirim alması için o kişinin de botu etkinleştirip kendi anahtarını alması gerekir; ESP32 kodu iki ayrı istek gönderebilir. Gruplara bildirim göndermek istiyorsan Telegram botu daha uygun bir seçenektir.

ESP32 WhatsApp mesajında Türkçe karakter nasıl gönderilir?

Mesaj metnini URL'ye eklemeden önce UTF-8 baytlarını URL kodlamasıyla %XX biçimine çevirmen gerekir; örneğin ı harfi %C4%B1 olarak gider. Bu yazıdaki urlEncodeText() fonksiyonu ya da UrlEncode kütüphanesi bunu otomatik yapar. Metni iki kez kodlamamaya dikkat et, yoksa WhatsApp'ta harf yerine kodlar görürsün.

ESP32 bildirimleri için WhatsApp mı Telegram mı daha iyi?

Yalnızca kendi telefonuna kısa uyarılar göndereceksen CallMeBot ile WhatsApp en hızlı kurulumdur. Telefondan ESP32'ye komut göndermek, fotoğraf paylaşmak ya da gruba mesaj atmak istiyorsan Telegram Bot API resmi, ücretsiz ve çok daha esnek bir çözümdür.

Arduino Uno ile WhatsApp mesajı gönderilebilir mi?

Arduino Uno'nun Wi-Fi'ı olmadığı için tek başına gönderemez. Uno'ya ESP-01 gibi bir Wi-Fi modülü eklemek mümkündür ama HTTPS isteği bu yapıda zahmetlidir. En pratik çözüm doğrudan ESP32 ya da ESP8266 kullanmak veya Uno'nun sensör verisini seri hatla bir ESP32'ye aktarmaktır.

Tüm projeleri gör
ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)
ES-25İleri

ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)

Bu projede ESP32'yi Station (STA) modunda evdeki Wi-Fi ağına güvenli ve hata toleranslı şekilde bağlıyoruz. SSID/şifreyi secrets.h dosyasına ayırarak Git'e sızmasını önlüyor, otomatik yeniden bağlanma mekanizması kuruyor, RSSI sinyal seviyesini ve IP adresini I2C LCD ekranda gösteriyoruz. Dahili LED durum göstergesi olarak çalışır. Üretim seviyesi bir bağlantı yöneticisidir.

4.4(21)
38
ESP32 HTTPClient + Hava Durumu API (LCD Ekranlı)
ES-31İleri
Premium

ESP32 HTTPClient + Hava Durumu API (LCD Ekranlı)

Bu projede ESP32 ile internet üzerinden hava durumu API'sine (wttr.in) HTTPClient.h kullanarak REST API çağrısı yapıyoruz. ArduinoJson v7 ile gelen JSON cevabını çözümleyip şehir, sıcaklık, nem, hava durumu ve rüzgâr bilgilerini I2C LCD ekranda gösteriyoruz. wttr.in API anahtarı istemez; istediğin şehrin adını yazman yeterli.

4.7(13)
20
ESP32 Hareket Alarm Sistemi (PIR + Buzzer + LED + Telegram)
ES-41İleri
Premium

ESP32 Hareket Alarm Sistemi (PIR + Buzzer + LED + Telegram)

PIR sensörü hareket algıladığında buzzer'ı ve LED'i çalıştıran, aynı anda Telegram üzerinden sahibine anlık bildirim gönderen akıllı bir güvenlik alarm sistemi. Tekrarlayan alarmların sıklığını sınırlamak için 30 saniyelik bekleme süresi (cooldown) vardır; bu süre PIR sensörünün yanlış algılamalarını ortadan kaldırmaz. Ev, garaj, depo veya çalışma odası gibi alanlarda kullanılabilir.

9
ESP32 DHT22 Sıcaklık ve Nem (LCD Ekranlı)
ES-15Orta

ESP32 DHT22 Sıcaklık ve Nem (LCD Ekranlı)

DHT22 sensörü ile ortam sıcaklığını ve nem oranını ölçüp 16x2 I2C LCD ekranda gerçek zamanlı olarak gösteren bir projedir. Adafruit DHT kütüphanesi kullanılarak tek kablo (one-wire) protokolü ile sensörden veri okunur. Bu proje, IoT hava istasyonu, akıllı ev otomasyonu veya seralarda ortam takip sistemlerinin temelini oluşturur. ESP32'nin GPIO 4 pini üzerinden DHT22 ile haberleşme sağlanır.

4.8(38)
57
ESP32 MQ-2 Gaz/Duman Dedektörü Alarmı
ES-20Orta

ESP32 MQ-2 Gaz/Duman Dedektörü Alarmı

Bu projede MQ-2 gaz sensörü modülü ile yanıcı gaz (LPG, metan, propan) ve duman tespiti yapılır; tespit anında pasif buzzer üzerinden siren benzeri bir alarm sesi çalınır. Sensörün dijital eşik çıkışı (DO) ESP32'nin GPIO 4 pinine bağlanır; gaz ya da duman eşik değeri aştığında DO LOW olur ve alarm tetiklenir. Hassasiyet modül üzerindeki potansiyometre ile ayarlanır. Pasif buzzer tone() fonksiyonu ile sürülerek iki frekans arasında geçişli siren efekti üretilir.

4.7(29)
44
Reed Röle Kapı Sensörü
AR-38Başlangıç
Premium

Reed Röle Kapı Sensörü

Kapın açık mı kapalı mı, bir ışığa bakarak anla. Kapıya küçük bir mıknatıs, kasaya da mıknatısı hisseden bir anahtar takarsın; kapı kapalıyken ikisi yan yana durur ve yeşil LED yanar, kapı açılıp…

4.7(34)
44
ESP32 Sıcaklık Loglayıcı (DHT22 + DS1307 RTC + microSD + OLED)
ES-40İleri
Premium

ESP32 Sıcaklık Loglayıcı (DHT22 + DS1307 RTC + microSD + OLED)

ESP32 ile zamanlı sıcaklık ve nem kayıt sistemi kur! Bu projede DHT22 sensörüyle dakikada bir sıcaklık ve nem okuyup DS1307 RTC modülünden aldığın gerçek zaman etiketiyle microSD karta CSV formatında kaydediyoruz. OLED ekranda büyük yazıyla son sıcaklık değeri, nem yüzdesi, zaman damgası ve toplam kayıt sayısı canlı gösterilir.

4.7(7)
12