Panduan · 9 mnt baca

Kirim Pesan WhatsApp dengan ESP32: Notifikasi Sensor lewat CallMeBot

Kirim pesan WhatsApp dengan ESP32: dapatkan API key CallMeBot, lakukan URL encoding pada teks, siapkan notifikasi sensor suhu dan pintu, batasi pesan, dan atasi error.

Mengirim pesan WhatsApp dengan ESP32 adalah salah satu cara paling praktis untuk langsung dapat kabar di ponsel ketika sensor di rumah melewati ambang. Ketika pintu terbuka, kulkas terlalu hangat, atau air di tangki menipis, ESP32 terhubung ke internet dan mengirim pesan ke WhatsApp-mu cukup dengan satu request HTTPS. Kamu tidak butuh server berbayar atau autentikasi yang rumit: layanan gratis CallMeBot meneruskan request web yang membawa API key-mu langsung ke nomor WhatsApp-mu sendiri.

Di panduan ini kamu akan belajar cara mendapatkan API key, kenapa pesan dengan karakter khusus atau beraksen butuh URL encoding dan bagaimana melakukannya, serta cara mengirim pesan uji pertamamu. Setelah itu kamu akan membuat sistem notifikasi sungguhan dengan sensor suhu DHT22 dan sensor pintu reed, membatasi frekuensi pesan supaya ponselmu tidak kebanjiran, dan mencari sumber error dengan membaca respons dari server. Kalau kamu belum kenal ESP32, lihat dulu Apa Itu ESP32?.

Apa itu CallMeBot, dan bagaimana pesan sampai dari ESP32 ke WhatsApp?

WhatsApp tidak menyediakan API terbuka yang bisa dipakai perangkat secara langsung untuk akun pribadi. CallMeBot adalah jembatan di antaranya: sebuah bot dengan akun WhatsApp sendiri mengirim pesan ke nomor-nomor yang sudah memberinya izin. Dari ESP32 kamu membuat request GET ke api.callmebot.com/whatsapp.php yang berisi nomor ponselmu, API key-mu, dan teks pesan; layanan itu memasukkan request ke antrean dan dalam beberapa detik pesan masuk ke WhatsApp-mu dari nomor bot. Jadi dari sisi ESP32, tugasnya tidak lebih dari membuka sebuah halaman web. Layanan ini gratis untuk pemakaian pribadi, tapi karena merupakan layanan pihak ketiga yang dijalankan perorangan, batas kecepatan dan aturannya bisa berubah seiring waktu. Karena itu, jangan pakai layanan ini sebagai satu-satunya saluran notifikasi untuk situasi yang menyangkut nyawa seperti kebakaran atau kebocoran gas; tambahkan buzzer lokal atau saluran kedua di sampingnya.

MetodePengaturanBiayaCocok untuk
CallMeBot (WhatsApp)API key lewat satu pesanGratis untuk pemakaian pribadiPeringatan sederhana ke ponselmu sendiri
Bot TelegramAmbil token dari BotFatherGratisPerintah dua arah, foto, pesan grup
WhatsApp Business Cloud APIAkun bisnis Meta dan template yang disetujuiBisa dikenai biaya per pesanNotifikasi komersial ke pelanggan
Email (SMTP)Butuh kata sandi aplikasiGratisLaporan detail, ringkasan harian

Bagaimana cara mendapatkan API key CallMeBot?

  1. Simpan nomor bot terbaru yang dipublikasikan di halaman WhatsApp situs CallMeBot ke kontak ponselmu; nomornya kadang berganti, jadi selalu cek di sana, bukan dari sumber lain.
  2. Kirim kalimat I allow callmebot to send me messages ke kontak ini di WhatsApp, persis seperti tertulis.
  3. Tak lama kemudian kamu akan dapat balasan yang diawali “API Activated for your phone number” dan berisi APIKEY-mu; catat angka ini.
  4. Kalau tidak ada balasan, jangan kirim pesan yang sama berulang-ulang; tunggu sebentar (kalau perlu sampai besok) lalu coba lagi, karena aktivasi bisa tertunda ketika layanan sedang ramai.
  5. Uji pertama bisa kamu lakukan tanpa ESP32: ketik URL dengan format di bawah, berisi nomor dan key-mu sendiri, ke address bar browser; kalau pesannya masuk, akunmu sudah siap.
API key-mu hanya bisa dipakai untuk mengirim pesan ke nomormu sendiri dan harus dijaga seperti kata sandi. Ketika meng-upload kodemu ke GitHub atau forum, jangan lupa hapus nomor dan key-mu; orang yang mendapatkan key itu bisa membuatmu menerima pesan tak diinginkan sebanyak yang dia mau, dan layanan bisa memblokir nomormu.

URL pesan dan URL encoding

Alamat request punya tiga parameter: phone (nomor dengan kode negara; untuk Turki diawali +90, untuk Indonesia +62, dan angka 0 di depan nomor tidak ditulis), apikey, dan text. Contoh request terlihat seperti ini: api.callmebot.com/whatsapp.php?phone=%2B905551234567&apikey=123456&text=Pintu%20terbuka. Di URL, karakter seperti spasi, &, ?, # dan + punya arti khusus; misalnya, tanda & di pesanmu memotong teks dan sisanya dianggap parameter baru, sedangkan + bisa diartikan sebagai spasi. Huruf beraksen dan huruf non-Latin memakan dua byte atau lebih di UTF-8 dan tidak boleh muncul langsung di URL. Solusinya adalah menulis setiap byte yang tidak aman sebagai tanda persen diikuti dua digit heksadesimal; ini disebut URL encoding (percent-encoding).

KarakterByte UTF-8Bentuk ter-encode
spasi0x20%20
+0x2B%2B
&0x26%26
ı0xC4 0xB1%C4%B1
ş0xC5 0x9F%C5%9F
ü0xC3 0xBC%C3%BC
°0xC2 0xB0%C2%B0
baris baru0x0A%0A

Kode di bawah memuat fungsi kecil urlEncodeText() yang melakukan ini: huruf, angka, dan karakter - _ . ~ dibiarkan apa adanya, sedangkan setiap byte lainnya diubah ke bentuk %XX. Karena Arduino IDE menyimpan file sumber sebagai UTF-8, kata seperti “Sıcaklık” (bahasa Turki untuk “suhu”) yang kamu ketik di kode akan terkirim dengan byte yang benar dan tampil dengan benar di WhatsApp. Kalau mau solusi siap pakai, library UrlEncode di Library Manager melakukan hal yang sama lewat fungsi urlEncode(). Untuk menambah baris baru di pesan, cukup tulis \n di teks; fungsi itu mengubahnya menjadi %0A. Format WhatsApp juga berfungsi: kalau kamu mengapit sebuah kata dengan tanda bintang, kata itu tampil tebal.

Uji pertama: menyapa WhatsApp dari ESP32

  1. Instal paket board ESP32 di Arduino IDE dan pilih ESP32 Dev Module sebagai board.
  2. Ganti nilai WIFI_SSID, WIFI_PASS, PHONE, dan API_KEY di kode dengan datamu sendiri; tulis nomornya dengan format +905551234567.
  3. Upload kodenya dan buka Serial Monitor di 115200 baud.
  4. Setelah koneksi Wi-Fi, kamu seharusnya melihat kode HTTP 200 dan teks balasan CallMeBot di Serial Monitor; dalam beberapa detik pesannya masuk ke ponselmu.
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}
Potongan kodeFungsinya
WiFiClientSecure + setInsecure()Membuat koneksi HTTPS terenkripsi, tapi tidak memverifikasi sertifikat server
urlEncodeText()Mengubah tanda + di nomor serta karakter khusus atau beraksen di pesan ke bentuk %XX
http.begin(client, url) (memulai permintaan HTTP)Menyiapkan request; parameter client wajib untuk HTTPS
http.GET()Mengirim request; nilai positif adalah kode HTTP, nilai negatif adalah error koneksi
http.getString()Membaca teks balasan CallMeBot; penjelasan error tertulis di sini
http.end()Menutup koneksi dan membebaskan memori yang dipakai
setInsecure() tetap mengenkripsi koneksi; hanya saja identitas server tidak diverifikasi. Ini cukup untuk notifikasi hobi dan mencegah kodemu rusak ketika sertifikat kedaluwarsa. Kalau ingin keamanan lebih ketat, kamu bisa memberikan root certificate server dengan client.setCACert(), tapi kamu harus memperbarui kode setiap kali sertifikatnya berganti.

Rangkaian: pengkabelan sensor suhu dan sensor pintu

Sistem contoh ini memakai dua sensor. DHT22 mengukur suhu dengan akurasi sekitar ±0,5 °C dan memakai satu jalur data; kalau kamu memakai sensor polos, tambahkan resistor pull-up 10 kΩ antara pin data dan 3,3 V, sedangkan versi modul sudah punya resistor ini. Untuk pintu kita memakai reed switch: reed ditempel di kusen pintu dan magnet di daun pintu. Ketika pintu tertutup, magnet menutup kontak dan pin ditarik ke GND (LOW); ketika pintu terbuka, kontak terbuka dan resistor pull-up internal membuat pin menjadi HIGH. Prinsip kerja reed switch bisa kamu baca lengkap di reed switch. Karena Arduino Uno tidak punya Wi-Fi, tabel ini hanya memuat board yang punya Wi-Fi.

KoneksiESP32ESP8266 (NodeMCU)Raspberry Pi Pico W
DHT22 VCC3V33V33V3(OUT)
DHT22 DATAGPIO 4D2 (GPIO 4)GP16
DHT22 GNDGNDGNDGND
Terminal reed 1GPIO 27D5 (GPIO 14)GP15
Terminal reed 2GNDGNDGND
Pin GPIO 34, 35, 36, dan 39 di ESP32 hanya bisa berfungsi sebagai input dan tidak punya resistor pull-up internal. Kalau reed kamu sambungkan ke salah satu pin ini dan memakai INPUT_PULLUP, pin akan mengambang dan kamu terus mendapat pesan “pintu terbuka” palsu. Hindari juga menyambungkan sensor ke pin boot (strapping) seperti GPIO 0, 2, 12, dan 15; board bisa menyala dalam mode yang salah ketika diberi daya.

Notifikasi ketika ambang terlewati: alarm suhu dan pintu

Di sistem notifikasi sungguhan, pertanyaan terpenting adalah “kapan harus mengirim pesan?” Kalau kamu mengirim pesan setiap 5 detik selama suhu bertahan di atas 30 °C, kamu akan dapat 12 notifikasi per menit. Untuk mencegahnya, kode memakai dua teknik. Yang pertama adalah histeresis: alarm aktif di 30 °C, tapi tidak di-reset sebelum suhu turun ke 28 °C; jadi nilai yang naik-turun antara 29,9 dan 30,1 tidak akan membanjirimu dengan notifikasi. Yang kedua adalah jeda (cooldown): minimal harus lewat 10 menit antara dua pesan sejenis untuk suhu dan 1 menit untuk pintu. Untuk sensor pintu, kita tidak menangkap kondisi yang terus berlangsung, hanya momen peralihan dari tertutup ke terbuka. Untuk kode ini, instal library DHT sensor library (Adafruit) dari Library Manager beserta dependensinya.

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}

Karena kode memakai pengaturan waktu berbasis millis(), loop() tidak pernah menunggu lama; hanya ketika pesan sedang dikirim, koneksi HTTPS memakan waktu 1–3 detik. Pengecekan MIN_GAP_MS di sendWhatsApp() memberi jarak minimal 15 detik antara dua request apa pun alasannya; kalau API key-mu salah atau layanan mengembalikan error, kode tidak akan membanjiri server dengan request. Kejadian yang muncul dalam selang singkat ini tidak dikirim sebagai pesan, hanya ditulis ke Serial Monitor. Kalau pesan suhu gagal terkirim, flag tempAlarm tidak diubah menjadi true, jadi pengiriman dicoba lagi pada pembacaan berikutnya. DHT22 sebaiknya tidak dibaca lebih sering dari setiap 2 detik; di sini sensor dibaca setiap 5 detik, dan kalau pembacaan gagal (NaN), error dicetak tanpa mengirim pesan. Untuk detail memakai millis sebagai pengganti delay, lihat millis() vs delay().

Kenapa membatasi frekuensi pesan itu wajib?

CallMeBot adalah layanan gratis dan bisa memblokir sementara nomor yang mengirim terlalu banyak request dalam waktu singkat untuk mencegah penyalahgunaan. Karena batas pastinya bisa berubah seiring waktu, pendekatan paling aman adalah merancang sistem notifikasi supaya tidak pernah melebihi beberapa pesan per menit. Ini juga menguntungkanmu: ponsel yang terus berbunyi lama-lama diabaikan, dan alarm sungguhan jadi terlewat. Notifikasi yang baik itu jarang dan bermakna.

  • Kirim per kejadian: Kirim satu pesan ketika kondisi berubah (pintu terbuka, ambang suhu terlewati); jangan diulang selama kondisinya masih bertahan.
  • Beri histeresis: Pilih ambang alarm dan ambang reset dengan selisih minimal 1–2 °C; untuk nilai yang suka melonjak seperti kelembapan, buat selisihnya lebih lebar lagi.
  • Jeda per jenis: Pakai waktu seperti 1 menit untuk pintu dan 10–30 menit untuk suhu.
  • Pesan ringkasan: Kalau banyak kejadian dalam waktu singkat, hitung jumlahnya dan laporkan dalam satu pesan seperti “pintu terbuka 7 kali dalam 10 menit terakhir”.
  • Batas harian: Izinkan maksimal, misalnya, 50 pesan per hari dengan sebuah penghitung; begitu batasnya tercapai, cukup tulis ke Serial Monitor.
  • Batasi pesan saat menyala: Kalau ESP32 mengirim pesan “online” setiap kali reset, gangguan daya bisa memicu banjir notifikasi; hapus pesan ini kalau perlu.

MicroPython dengan Raspberry Pi Pico W

Pico W yang punya Wi-Fi juga bisa memakai layanan yang sama; modul urequests di MicroPython mendukung request HTTPS. Kode di bawah memindahkan logika URL encoding yang sama ke Python serta membaca DHT22 dari GP16 dan reed dari GP15. Di build MicroPython untuk Pico W, modul dht sudah bawaan, jadi kamu tidak perlu menyalin file tambahan. Kode ini tidak akan jalan di Pico klasik yang tanpa Wi-Fi. Kalau kamu baru mengenal MicroPython, dasar-dasar MicroPython adalah titik awal yang bagus.

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)

Memakainya dengan ESP8266 (NodeMCU, Wemos D1 Mini)

Di board ESP8266 logikanya sama persis; hanya file header yang berubah. Sertakan ESP8266WiFi.h sebagai pengganti WiFi.h dan ESP8266HTTPClient.h sebagai pengganti HTTPClient.h. Kelas WiFiClientSecure di ESP8266 berbasis BearSSL dan dipakai dengan cara yang sama lewat setInsecure(); baris http.begin(client, url) tetap berfungsi tanpa diubah. Karena RAM ESP8266 jauh lebih kecil daripada ESP32, koneksi TLS memakai sebagian besar memori; kalau kamu memakainya bersama library besar, kurangi penggabungan String dan jangan lupa memanggil http.end() setelah request selesai. Untuk nomor pin, pakai kolom ESP8266 di tabel.

Ide proyek dengan notifikasi WhatsApp

  • Alarm gerakan: Kirim pesan kalau sensor PIR mendeteksi gerakan ketika tidak ada orang di rumah.
  • Peringatan kebocoran gas: Ketika sensor gas MQ-2 melewati ambangnya, bunyikan buzzer dan kirim pesan WhatsApp sekaligus.
  • Detektor banjir: Dapatkan notifikasi ketika sensor level air yang diletakkan di bawah mesin cuci menjadi basah.
  • Pengingat menyiram tanaman: Kirim pesan “potnya haus” ketika sensor kelembapan tanah mendeteksi tanah kering.
  • Alarm embun beku: Beri peringatan ketika suhu rumah kaca atau balkon turun di bawah 2 °C; detailnya ada di artikel alarm embun beku.
  • Sensor kotak surat bertenaga baterai: Biarkan ESP32 menunggu dalam mode deep sleep; ESP32 bangun ketika tutupnya terbuka, mengirim satu pesan, lalu tidur lagi.

Kesalahan umum dan cara mengatasinya

GejalaKemungkinan penyebabSolusi
Wi-Fi tidak pernah terhubungKata sandi salah atau jaringan 5 GHzESP32 hanya bisa terhubung ke jaringan 2,4 GHz; cek SSID dan kata sandinya
HTTP -1 atau “connection refused”Tidak ada klien HTTPS, masalah DNS, atau masalah internetCek bentuk http.begin(client, url) dan baris setInsecure()
HTTP 200 tapi pesan tidak masukFormat nomor salah atau layanan lambatPakai nomor yang diawali +90 (atau +62) tanpa angka 0; tunggu beberapa menit dan baca teks balasannya
Balasan menyebut API key tidak validKey salah atau tidak adaSalin ulang angka dari pesan aktivasi; nomor dan key harus milik akun yang sama
Pesan terpotong di tengahTanda & atau # di teks tidak di-encodeEncode seluruh teks dengan urlEncodeText()
Huruf tampil sebagai %C4%B1Teks di-encode dua kaliEncode teks hanya sekali
ESP32 reset ketika mengirimTegangan turun ketika ada lonjakan arus Wi-FiPakai kabel USB yang bagus dan catu daya yang mampu memberi minimal 500 mA
Pesan “pintu terbuka” terus-menerusPin tanpa pull-up atau kabel kendurPakai pin yang mendukung pull-up seperti GPIO 27 dan kencangkan sambungannya
Ketika mencari sumber masalah, uji rantainya bagian demi bagian: cetak URL yang dibuat ke Serial Monitor, salin, lalu buka di browser. Kalau pesan masuk dari browser, masalahnya ada di sisi ESP32 (Wi-Fi, klien HTTPS, catu daya); kalau tidak, masalahnya ada di nomor, key, atau layanannya. Untuk masalah Wi-Fi lihat ESP32 tidak mau terhubung ke Wi-Fi, dan untuk reset mendadak lihat brownout ESP32. Jangan pernah membagikan URL yang berisi API key aslimu kepada siapa pun.

Notifikasi WhatsApp membawa proyek sensor dari level “aku tahu kalau melihat layar” ke level “aku tahu di mana pun aku berada”. Kalau kamu ingin perintah dua arah, foto, dan pesan grup, bot Telegram ESP32 adalah langkah berikutnya yang bagus. Di aplikasi BlueGrays kamu akan menemukan proyek seperti koneksi Wi-Fi ESP32, cuaca dengan HTTPClient, pengukuran DHT22, dan alarm gerakan, langkah demi langkah lengkap dengan skema rangkaian dan kodenya, dan kamu bisa dengan mudah menambahkan fungsi WhatsApp dari artikel ini ke proyek-proyek itu.

Pertanyaan umum

Bisakah mengirim pesan WhatsApp dari ESP32 secara gratis?

Bisa. Layanan CallMeBot gratis untuk pemakaian pribadi dan hanya meminta API key; ESP32 mengirim pesan ke nomormu sendiri dengan satu request HTTPS GET. Sebaliknya, WhatsApp Business Cloud API resmi butuh akun bisnis dan template yang disetujui, serta bisa dikenai biaya per pesan.

Apa yang harus kulakukan kalau API key CallMeBot tidak datang?

Pertama, cek apakah nomor bot sudah sesuai dengan nomor terbaru di situs CallMeBot dan apakah kalimat aktivasi sudah kamu ketik persis. Kalau dalam beberapa menit tidak ada balasan, jangan kirim pesannya berulang-ulang; tunggu sebentar, kalau perlu sampai besok, lalu coba lagi. Aktivasi bisa tertunda ketika layanan sedang ramai.

Bisakah CallMeBot mengirim pesan ke nomor lain?

Setiap API key terikat pada satu nomor yang melakukan aktivasi dan hanya mengirim pesan ke nomor itu. Supaya anggota keluargamu juga dapat notifikasi, dia perlu mengaktifkan bot dan mendapatkan key-nya sendiri; kode ESP32 bisa mengirim dua request terpisah. Kalau kamu ingin mengirim notifikasi ke grup, bot Telegram adalah pilihan yang lebih baik.

Bagaimana cara mengirim karakter beraksen atau khusus di pesan WhatsApp ESP32?

Sebelum menambahkan teks pesan ke URL, kamu perlu mengubah byte UTF-8-nya ke bentuk %XX dengan URL encoding; misalnya, huruf ı dikirim sebagai %C4%B1. Fungsi urlEncodeText() di artikel ini atau library UrlEncode melakukannya secara otomatis. Hati-hati jangan sampai teks di-encode dua kali, karena nanti kamu akan melihat kode, bukan huruf, di WhatsApp.

Untuk notifikasi ESP32, lebih baik WhatsApp atau Telegram?

Kalau kamu hanya ingin mengirim peringatan singkat ke ponselmu sendiri, WhatsApp dengan CallMeBot adalah pengaturan paling cepat. Kalau kamu ingin mengirim perintah dari ponsel ke ESP32, berbagi foto, atau mengirim pesan ke grup, Telegram Bot API adalah solusi resmi, gratis, dan jauh lebih fleksibel.

Bisakah mengirim pesan WhatsApp dengan Arduino Uno?

Arduino Uno tidak punya Wi-Fi, jadi tidak bisa mengirimnya sendirian. Kamu bisa menambahkan modul Wi-Fi seperti ESP-01 ke Uno, tapi request HTTPS cukup merepotkan dengan susunan itu. Solusi paling praktis adalah langsung memakai ESP32 atau ESP8266, atau meneruskan data sensor dari Uno lewat serial ke ESP32.

Lihat semua proyek
Koneksi Wi-Fi STA ESP32 (dengan Layar LCD)
ES-25Mahir

Koneksi Wi-Fi STA ESP32 (dengan Layar LCD)

Di proyek ini, kita menyambungkan ESP32 ke jaringan Wi-Fi rumah dalam mode Station (STA) dengan cara yang aman dan tahan gangguan. Kita menyimpan SSID dan kata sandi di file secrets.h terpisah agar tidak bocor ke Git, menyiapkan mekanisme sambung ulang otomatis, dan menampilkan tingkat sinyal RSSI dan alamat IP di layar LCD I2C. LED bawaan bekerja sebagai indikator status. Ini adalah pengelola koneksi kelas produksi.

4.4(21)
38
HTTPClient + API Cuaca ESP32 (dengan Layar LCD)
ES-31Mahir
Premium

HTTPClient + API Cuaca ESP32 (dengan Layar LCD)

Di proyek ini, kita memakai ESP32 untuk melakukan panggilan REST API ke API cuaca (wttr.in) lewat internet dengan HTTPClient.h. Kita mengurai respons JSON yang diterima dengan ArduinoJson v7 dan menampilkan kota, suhu, kelembapan, cuaca, dan informasi angin di layar LCD I2C dalam bahasa Turki dan Inggris. wttr.in gratis dan tidak butuh kunci API; kamu cukup memasukkan nama kota apa pun untuk mengambil kondisi cuaca terkini kota itu. Data diperbarui otomatis setiap 30 menit.

4.7(13)
20
Sistem Alarm Gerakan ESP32 (PIR + Buzzer + LED + Telegram)
ES-41Mahir
Premium

Sistem Alarm Gerakan ESP32 (PIR + Buzzer + LED + Telegram)

Sistem alarm keamanan pintar yang menyalakan buzzer dan LED ketika sensor PIR mendeteksi gerakan, sekaligus mengirim notifikasi instan ke pemilik lewat Telegram. Cooldown 30 detik membatasi seberapa sering alarm berulang; mekanisme ini tidak memvalidasi deteksi PIR atau menghilangkan pemicu palsu. Cocok untuk rumah, garasi, gudang, atau ruang kerja. Dengan ESP32-CAM bisa ditambahkan notifikasi berfoto; dengan ESP32 DevKit V1 klasik, notifikasinya berupa teks.

9
Suhu dan Kelembapan DHT22 ESP32 (dengan Layar LCD)
ES-15Menengah

Suhu dan Kelembapan DHT22 ESP32 (dengan Layar LCD)

Proyek ini mengukur suhu dan kelembapan sekitar dengan sensor DHT22 dan menampilkan datanya secara real-time di LCD I2C 16x2. Data dibaca dari sensor dengan protokol satu kabel lewat library Adafruit DHT. Proyek ini menjadi dasar untuk stasiun cuaca IoT, otomasi rumah pintar, atau sistem pemantauan lingkungan di rumah kaca. Komunikasi dengan DHT22 dilakukan lewat pin GPIO 4 ESP32.

4.8(38)
57
Alarm Detektor Gas/Asap MQ-2 ESP32
ES-20Menengah

Alarm Detektor Gas/Asap MQ-2 ESP32

Di proyek ini, gas mudah terbakar (LPG, metana, propana) dan asap dideteksi memakai modul sensor gas MQ-2, dan alarm mirip sirene diputar lewat buzzer pasif ketika terdeteksi. Output ambang digital (DO) sensor disambung ke GPIO 4 ESP32; ketika gas atau asap melewati ambang, DO menjadi LOW dan alarm terpicu. Kepekaan diatur lewat potensiometer modul. Buzzer pasif digerakkan dengan tone() untuk menghasilkan efek sirene dua frekuensi.

4.7(29)
44
Sensor Pintu dengan Sakelar Reed
AR-38Pemula
Premium

Sensor Pintu dengan Sakelar Reed

Ketahui apakah pintumu terbuka atau tertutup hanya dengan melihat lampu. Kamu menempelkan magnet kecil di pintu dan sakelar peka magnet di kusennya; ketika pintu tertutup keduanya bersebelahan dan…

4.7(34)
44
Pencatat Data Suhu ESP32 (DHT22 + RTC DS1307 + microSD + OLED)
ES-40Mahir
Premium

Pencatat Data Suhu ESP32 (DHT22 + RTC DS1307 + microSD + OLED)

Buat pencatat suhu bercap waktu dengan ESP32! Baca suhu/kelembapan DHT22 setiap menit, ambil waktu sebenarnya dari RTC DS1307, dan catat ke kartu microSD sebagai CSV. OLED menampilkan suhu langsung (font besar), kelembapan, cap waktu, dan penghitung catatan. File /temp_log.csv bisa dibuka di Excel, Google Sheets, atau Python pandas; cocok untuk rumah kaca, suhu kamar, data laboratorium, penyimpanan makanan, atau sarang lebah.

4.7(7)
12