В данной статье мы рассмотрим как отправлять сообщения на номера WhatsApp, используя ESP32 и ESP-IDF с помощью бесплатного API-сервиса Callmeboot. Callmeboot предоставляет HTTP REST API, который можно использовать для отправки сообщений WhatsApp. Мы будем использовать библиотеку HTTP-клиента, доступную в ESP-IDF, для выполнения HTTP GET-запросов к этому API сообщений. Кроме того, вы также можете использовать этот бесплатный сервис для отправки уведомлений об обнаружении движения, открытии двери и т.д. на свой номер.
Мы будем программировать ESP32 с помощью ESP-IDF в VS Code. Прежде чем продолжить, убедитесь, что у вас установлена последняя версия VS Code и настроено расширение ESP-IDF:
- Установка ESP32 ESP-IDF на Windows и его интеграция с Visual Studio Code
- Установка ESP32 ESP-IDF на Linux Ubuntu
Также взаимодействие с мессенджером WhatsApp мы рассматривали в следующих проектах на нашем сайте:
- установка WhatsApp на Raspberry Pi;
- WhatsApp бот на Raspberry Pi для проекта автоматизации дома;
- передача сообщений WhatsApp с помощью Arduino;
- передача сообщений WhatsApp с помощью ESP8266 NodeMCU.
Что такое WhatsApp
WhatsApp — это кроссплатформенный сервис обмена мгновенными сообщениями и голосовой связи через Интернет (VoIP), принадлежащий Facebook. Приложение позволяет пользователям отправлять текстовые и голосовые сообщения, совершать голосовые и видеозвонки, а также обмениваться изображениями, документами, местоположением и другими медиафайлами. WhatsApp также поддерживает сквозное шифрование всех сообщений и звонков, что означает, что только отправитель и получатель могут читать или прослушивать сообщение, и никто другой, даже WhatsApp, не может получить доступ к содержимому сообщения. WhatsApp был впервые выпущен в 2009 году и с тех пор стал одним из самых популярных мессенджеров в мире, насчитывая более 2 миллиардов активных пользователей в месяц. Он доступен для загрузки на различных платформах, включая Android, iOS, Windows и macOS, а также в виде веб-приложения.
API CallMeBot
CallMeBot — это веб-сервис, позволяющий пользователям совершать телефонные звонки и отправлять сообщения WhatsApp. Это сторонний сервис, который может быть интегрирован в другие приложения и веб-сайты с помощью API (интерфейса прикладного программирования). API позволяет разработчикам получать доступ к функциональности сервиса CallMeBot и использовать его в своих собственных приложениях, например, добавляя кнопку «Позвоните мне» на веб-сайты для обслуживания клиентов или продаж. Доступ к API обычно осуществляется с помощью уникального ключа API и позволяет отправлять сообщения WhatsApp через набор RESTful веб-сервисов.
CallMeBot — это бесплатный и простой в использовании API для отправки сообщений WhatsApp путем простого вызова API с вашего ESP32 с помощью библиотеки HTTP-клиента, доступной во фреймворке ESP-IDF. Эти API представляют собой сервис, позволяющий отправлять себе сообщения в режиме реального времени. Вам нужно только зарегистрировать свой телефон и записать ключ API. Для отправки сообщения необходимо выполнить HTTP GET-запрос с ESP32.
Как получить ключ API CallMeBot
Для начала нам нужно получить API-ключ от CallMebot. Выполните следующие шаги, чтобы получить API-ключ и зарегистрировать свой номер:
- Добавьте этот номер телефона +34611011637 в список контактов вашего телефона. (Назовите его как хотите)
- Отправьте это сообщение “I allow callmebot to send me messages“ («Я разрешаю callmebot отправлять мне сообщения») новому созданному контакту (разумеется, через WhatsApp).
- Дождитесь сообщения от бота «API активирован для вашего номера телефона. Ваш APIKEY — 123123».
- Примечание: если вы не получили ApiKey в течение 2 минут, пожалуйста, попробуйте еще раз через 24 часа.
- В сообщении WhatsApp от бота будет содержаться ключ API, необходимый для отправки сообщений с использованием API. Для получения более подробной информации вы можете перейти по этой ссылке.

Как отправить SMS-сообщение в WhatsApp с помощью CallMeBot
Это API используется для отправки сообщений через WhatsApp с помощью сервиса WhatABot.
|
1 |
http://api.whatabot.net/whatsapp/sendMessage?text=" + (message) + "&apikey=" + api_key + "&phone=" + mobile_number; |
API принимает три параметра: «message», «api_key» и «mobile_number». Параметр «message» — это текст сообщения, которое вы хотите отправить, «api_key» — ваш уникальный ключ API для доступа к сервису WhatABot, а «mobile_number» — номер телефона, на который будет отправлено сообщение. Когда вы отправляете GET-запрос к этой конечной точке API с указанными параметрами в строке запроса, API отправит указанное сообщение на указанный номер телефона через WhatsApp.
Создание проекта в ESP-IDF для отправки сообщений с ESP32 на номер WhatsApp
В этом разделе давайте создадим проект ESP-IDF для отправки сообщений на номер WhatsApp.
Создание примера проекта
Откройте VS Code и перейдите в меню View > Command Palette («Вид» > «Палитра команд»). Введите в строке поиска ESP-IDF: New Project и нажмите Enter.
Укажите название проекта и каталог, а также плату и целевое устройство ESP-IDF. Мы назвали наш проект «esp32_whatsapp». Для платы ESP-IDF мы выбрали опцию custom board ("пользовательская плата"). Для целевого устройства ESP-IDF мы выбрали модуль ESP32. Нажмите кнопку ‘Choose Template’ ("Выбрать шаблон"), чтобы продолжить.
В разделе «Расширение» выберите опцию ESP-IDF:
На вкладке get-started («Начало работы») мы щелкнем по пункту «sample_project». Затем нажмем ‘Create project using template sample_project’) («Создать проект, используя шаблон sample_project»).
Вы получите уведомление о создании проекта. Чтобы открыть проект в новом окне, нажмите «Да».
Это откроет проект, который мы создали на вкладке «Проводник». Внутри папки проекта находится несколько папок. Это справедливо для каждого проекта, который вы будете создавать с помощью ESP-IDF Explorer.
Код ESP32 для отправки сообщений на номер WhatsApp
Этот код представляет собой программу, написанную на языке C для ESP32 с использованием фреймворка ESP-IDF, которая отправляет сообщение WhatsApp, используя API CallMeBot. Скопируйте следующий код в файл main.c вашего проекта esp-idf.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 |
#include <stdio.h> #include <string.h> #include <stdlib.h> #include "esp_log.h" #include "nvs_flash.h" #include "esp_event.h" #include "esp_netif.h" #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "esp_system.h" #include "esp_http_client.h" #include "connect_wifi.h" static const char *TAG = "HTTP_CLIENT"; char api_key[] = "replace_with_your_api_key"; char whatsapp_num[] = "replace_with_your_whatsapp_number"; char whatsapp_messgae[] = "WhatsApp Message Test!"; char *url_encode(const char *str) { static const char *hex = "0123456789abcdef"; static char encoded[1024]; char *p = encoded; while (*str) { if (isalnum(*str) || *str == '-' || *str == '_' || *str == '.' || *str == '~') { *p++ = *str; } else { *p++ = '%'; *p++ = hex[*str >> 4]; *p++ = hex[*str & 15]; } str++; } *p = '\0'; return encoded; } static void send_whatsapp_message(void *pvParameters) { char callmebot_url[] = "https://api.callmebot.com/whatsapp.php?phone=%s&text=%s&apikey=%s"; char URL[strlen(callmebot_url)]; sprintf(URL, callmebot_url, whatsapp_num, url_encode(whatsapp_messgae), api_key); ESP_LOGI(TAG, "URL = %s", URL); esp_http_client_config_t config = { .url = URL, .method = HTTP_METHOD_GET, }; esp_http_client_handle_t client = esp_http_client_init(&config); esp_err_t err = esp_http_client_perform(client); if (err == ESP_OK) { int status_code = esp_http_client_get_status_code(client); if (status_code == 200) { ESP_LOGI(TAG, "Message sent Successfully"); } else { ESP_LOGI(TAG, "Message sent Failed"); } } else { ESP_LOGI(TAG, "Message sent Failed"); } esp_http_client_cleanup(client); vTaskDelete(NULL); } void app_main(void) { esp_err_t ret = nvs_flash_init(); if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) { ESP_ERROR_CHECK(nvs_flash_erase()); ret = nvs_flash_init(); } ESP_ERROR_CHECK(ret); connect_wifi(); if (wifi_connect_status) { xTaskCreate(&send_whatsapp_message, "send_whatsapp_message", 8192, NULL, 5, NULL); } } |
Как работает код?
Эти строки кода содержат несколько заголовочных файлов, таких как «stdio.h», «string.h» и «stdlib.h», которые предоставляют базовые операции ввода/вывода, обработку строк и функции выделения памяти соответственно.
В него также входят заголовочные файлы, специфичные для микроконтроллера ESP32, такие как «esp_log.h», «nvs_flash.h», «esp_event.h» и «esp_netif.h». Эти заголовочные файлы предоставляют функции для ведения журналов, энергонезависимой памяти, обработки событий и управления сетевым интерфейсом.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
#include <stdio.h> #include <string.h> #include <stdlib.h> #include "esp_log.h" #include "nvs_flash.h" #include "esp_event.h" #include "esp_netif.h" #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "esp_system.h" #include "esp_http_client.h" #include "connect_wifi.h" |
Определите несколько глобальных переменных, таких как «api_key», которая является ключом API для сервиса CallMeBot, «whatsapp_num», номер телефона, на который нужно отправить сообщение, и «whatsapp_message», содержимое отправляемого сообщения.
|
1 2 3 4 |
static const char *TAG = "HTTP_CLIENT"; char api_key[] = "replace_with_your_api_key"; char whatsapp_num[] = "replace_with_your_whatsapp_number"; char whatsapp_messgae[] = "WhatsApp Message Test!"; |
Функция для генерации сообщений в формате URLEncoded.
Определите функцию с именем «url_encode», которая принимает один параметр — указатель на строку, завершающуюся нулевым символом, под названием «str».
|
1 |
char *url_encode(const char *str) |
Функция сначала объявляет статический массив с именем «encoded», который будет использоваться для хранения закодированной версии входной строки. Она также объявляет два статических указателя с именами «hex» и «p», которые указывают на строку «0123456789abcdef» и начало массива encoded соответственно.
|
1 2 3 |
static const char *hex = "0123456789abcdef"; static char encoded[1024]; char *p = encoded; |
Затем функция переходит в цикл while, который перебирает каждый символ во входной строке. Внутри цикла, если текущий символ является буквенно-цифровым или одним из указанных символов '-', '_', '.' или '~', он напрямую добавляется к закодированной строке. В противном случае символ кодируется путем добавления сначала символа '%', а затем сложения соответствующих шестнадцатеричных значений старших и младших 4 бит символа.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
while (*str) { if (isalnum(*str) || *str == '-' || *str == '_' || *str == '.' || *str == '~') { *p++ = *str; } else { *p++ = '%'; *p++ = hex[*str >> 4]; *p++ = hex[*str & 15]; } str++; } |
После цикла к закодированной строке добавляется нулевой символ-терминатор, и функция возвращает указатель на начало закодированной строки. Эта функция закодирует любую переданную ей строку, чтобы её можно было использовать в качестве допустимой части URL-адреса.
|
1 2 |
*p = '\0'; return encoded; |
Функция отправки сообщений в WhatsApp
Эта функция отвечает за отправку сообщения WhatsApp на указанный номер с использованием API Callmebot. Функция «send_whatsapp_message» принимает один параметр «pvParameters» (который в данной функции не используется).
|
1 |
static void send_whatsapp_message(void *pvParameters) |
Во-первых, эта функция объявляет переменную «callmebot_url», которая представляет собой строку, содержащую шаблон URL-адреса для API Callmebot. Затем она объявляет переменную «URL», которая представляет собой массив символов той же длины, что и «callmebot_url». После этого она использует функцию «sprintf» для форматирования URL-адреса, заменяя определенные заполнители в «callmebot_url» фактическими значениями «whatsapp_num» (это должен быть номер телефона получателя), «url_encode(whatsapp_message)» (это сообщение, которое необходимо отправить) и «api_key» (это ключ API пользователя) соответственно.
|
1 2 3 4 5 |
char callmebot_url[] = "https://api.callmebot.com/whatsapp.php?phone=%s&text=%s&apikey=%s"; char URL[strlen(callmebot_url)]; sprintf(URL, callmebot_url, whatsapp_num, url_encode(whatsapp_messgae), api_key); ESP_LOGI(TAG, "URL = %s", URL); |
Теперь объявляется структура с именем «config», которая используется для настройки HTTP-клиента с указанием URL-адреса и метода «HTTP_METHOD_GET». Затем создается дескриптор HTTP-клиента с помощью функции «esp_http_client_init» и структуры «config».
|
1 2 3 4 5 6 |
esp_http_client_config_t config = { .url = URL, .method = HTTP_METHOD_GET, }; esp_http_client_handle_t client = esp_http_client_init(&config); |
После этого используйте функцию «esp_http_client_perform», чтобы отправить запрос на сервер и проверить ответ. Если запрос был успешным, функция проверяет код состояния ответа. Если код состояния равен 200, это означает, что сообщение было отправлено успешно, в противном случае отправка сообщения завершилась неудачей. Затем функция очищает дескриптор клиента, вызывая функцию «esp_http_client_cleanup», и удаляет задачу.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
esp_err_t err = esp_http_client_perform(client); if (err == ESP_OK) { int status_code = esp_http_client_get_status_code(client); if (status_code == 200) { ESP_LOGI(TAG, "Message sent Successfully"); } else { ESP_LOGI(TAG, "Message sent Failed"); } } else { ESP_LOGI(TAG, "Message sent Failed"); } esp_http_client_cleanup(client); vTaskDelete(NULL); |
Функция Main
Параметр «app_main» является точкой входа в приложение. Он инициализирует энергонезависимую флэш-память (NVS) микроконтроллера ESP32, которая используется для хранения данных, которые должны сохраняться после выключения и включения питания.
После этого вызывается функция «nvs_flash_init» для инициализации NVS-флэш-памяти и проверяется возвращаемое значение. Если возвращаемое значение равно «ESP_ERR_NVS_NO_FREE_PAGES» или «ESP_ERR_NVS_NEW_VERSION_FOUND», это означает, что NVS-флэш-память необходимо стереть и инициализировать заново. Затем вызывается функция «ESP_ERROR_CHECK» для проверки наличия ошибок при инициализации NVS-флэш-памяти.
|
1 2 3 4 5 6 7 |
esp_err_t ret = nvs_flash_init(); if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) { ESP_ERROR_CHECK(nvs_flash_erase()); ret = nvs_flash_init(); } ESP_ERROR_CHECK(ret); |
Теперь вызывается функция «connect_wifi» для подключения к сети Wi-Fi. Затем проверяется статус подключения к сети Wi-Fi (wifi_connect_status). Если подключение к сети Wi-Fi успешно установлено, функция создает новую задачу под названием «send_whatsapp_message» с помощью функции «xTaskCreate». Эта задача будет запускать функцию «send_whatsapp_message» в фоновом режиме, будет иметь размер стека 8192 байта и приоритет 5. Задача создается с нулевым дескриптором, поэтому к ней нельзя будет обратиться позже, так как мы удалим ее после отправки сообщения WhatsApp.
|
1 2 3 4 5 |
connect_wifi(); if (wifi_connect_status) { xTaskCreate(&send_whatsapp_message, "send_whatsapp_message", 8192, NULL, 5, NULL); } |
Эта функция служит точкой входа в приложение и отвечает за инициализацию ESP32, подключение к Wi-Fi и создание задачи, отправляющей сообщение в WhatsApp.
Примечание: в этом проекте есть один заголовочный файл с именем «connect_wifi.h», мы создали его в предыдущих уроках. Вам также необходимо добавить этот файл. Вы можете скачать полный проект по ссылке для скачивания в следующем разделе.
Демонстрация отправки сообщений с ESP32 на номер WhatsApp
В этом разделе мы рассмотрим демонстрацию отправки сообщений в WhatsApp. Для начала скачайте полный проект по следующей ссылке и соберите его.
статья в разработке







