Отправка с ESP32 сообщений на WhatsApp с помощью ESP-IDF


В данной статье мы рассмотрим как отправлять сообщения на номера WhatsApp, используя ESP32 и ESP-IDF с помощью бесплатного API-сервиса Callmeboot. Callmeboot предоставляет HTTP REST API, который можно использовать для отправки сообщений WhatsApp. Мы будем использовать библиотеку HTTP-клиента, доступную в ESP-IDF, для выполнения HTTP GET-запросов к этому API сообщений. Кроме того, вы также можете использовать этот бесплатный сервис для отправки уведомлений об обнаружении движения, открытии двери и т.д. на свой номер.

Отправка с ESP32 сообщений на WhatsApp с помощью ESP-IDF

Мы будем программировать ESP32 с помощью ESP-IDF в VS Code. Прежде чем продолжить, убедитесь, что у вас установлена ​​последняя версия VS Code и настроено расширение ESP-IDF:

Также взаимодействие с мессенджером WhatsApp мы рассматривали в следующих проектах на нашем сайте:

Что такое 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. Для получения более подробной информации вы можете перейти по этой ссылке.

Получение ключа API CallMeBot

Как отправить SMS-сообщение в WhatsApp с помощью CallMeBot

Это API используется для отправки сообщений через WhatsApp с помощью сервиса WhatABot.

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 для отправки сообщений с ESP32 на номер WhatsApp

В разделе «Расширение» выберите опцию ESP-IDF:

Выбор опции ESP-IDF в разделе Extension («Расширение»)

На вкладке get-started («Начало работы») мы щелкнем по пункту «sample_project». Затем нажмем ‘Create project using template sample_project’) («Создать проект, используя шаблон sample_project»).

Создание проекта с использованием шаблона sample_project

Вы получите уведомление о создании проекта. Чтобы открыть проект в новом окне, нажмите «Да».

Это откроет проект, который мы создали на вкладке «Проводник». Внутри папки проекта находится несколько папок. Это справедливо для каждого проекта, который вы будете создавать с помощью ESP-IDF Explorer.

Код ESP32 для отправки сообщений на номер WhatsApp

Этот код представляет собой программу, написанную на языке C для ESP32 с использованием фреймворка ESP-IDF, которая отправляет сообщение WhatsApp, используя API CallMeBot. Скопируйте следующий код в файл main.c вашего проекта esp-idf.

Как работает код?

Эти строки кода содержат несколько заголовочных файлов, таких как «stdio.h», «string.h» и «stdlib.h», которые предоставляют базовые операции ввода/вывода, обработку строк и функции выделения памяти соответственно.

В него также входят заголовочные файлы, специфичные для микроконтроллера ESP32, такие как «esp_log.h», «nvs_flash.h», «esp_event.h» и «esp_netif.h». Эти заголовочные файлы предоставляют функции для ведения журналов, энергонезависимой памяти, обработки событий и управления сетевым интерфейсом.

Определите несколько глобальных переменных, таких как «api_key», которая является ключом API для сервиса CallMeBot, «whatsapp_num», номер телефона, на который нужно отправить сообщение, и «whatsapp_message», содержимое отправляемого сообщения.

Функция для генерации сообщений в формате URLEncoded.

Определите функцию с именем «url_encode», которая принимает один параметр — указатель на строку, завершающуюся нулевым символом, под названием «str».

Функция сначала объявляет статический массив с именем «encoded», который будет использоваться для хранения закодированной версии входной строки. Она также объявляет два статических указателя с именами «hex» и «p», которые указывают на строку «0123456789abcdef» и начало массива encoded соответственно.

Затем функция переходит в цикл while, который перебирает каждый символ во входной строке. Внутри цикла, если текущий символ является буквенно-цифровым или одним из указанных символов '-', '_', '.' или '~', он напрямую добавляется к закодированной строке. В противном случае символ кодируется путем добавления сначала символа '%', а затем сложения соответствующих шестнадцатеричных значений старших и младших 4 бит символа.

После цикла к закодированной строке добавляется нулевой символ-терминатор, и функция возвращает указатель на начало закодированной строки. Эта функция закодирует любую переданную ей строку, чтобы её можно было использовать в качестве допустимой части URL-адреса.

Функция отправки сообщений в WhatsApp

Эта функция отвечает за отправку сообщения WhatsApp на указанный номер с использованием API Callmebot. Функция «send_whatsapp_message» принимает один параметр «pvParameters» (который в данной функции не используется).

Во-первых, эта функция объявляет переменную «callmebot_url», которая представляет собой строку, содержащую шаблон URL-адреса для API Callmebot. Затем она объявляет переменную «URL», которая представляет собой массив символов той же длины, что и «callmebot_url». После этого она использует функцию «sprintf» для форматирования URL-адреса, заменяя определенные заполнители в «callmebot_url» фактическими значениями «whatsapp_num» (это должен быть номер телефона получателя), «url_encode(whatsapp_message)» (это сообщение, которое необходимо отправить) и «api_key» (это ключ API пользователя) соответственно.

Теперь объявляется структура с именем «config», которая используется для настройки HTTP-клиента с указанием URL-адреса и метода «HTTP_METHOD_GET». Затем создается дескриптор HTTP-клиента с помощью функции «esp_http_client_init» и структуры «config».

После этого используйте функцию «esp_http_client_perform», чтобы отправить запрос на сервер и проверить ответ. Если запрос был успешным, функция проверяет код состояния ответа. Если код состояния равен 200, это означает, что сообщение было отправлено успешно, в противном случае отправка сообщения завершилась неудачей. Затем функция очищает дескриптор клиента, вызывая функцию «esp_http_client_cleanup», и удаляет задачу.

Функция 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-флэш-памяти.

Теперь вызывается функция «connect_wifi» для подключения к сети Wi-Fi. Затем проверяется статус подключения к сети Wi-Fi (wifi_connect_status). Если подключение к сети Wi-Fi успешно установлено, функция создает новую задачу под названием «send_whatsapp_message» с помощью функции «xTaskCreate». Эта задача будет запускать функцию «send_whatsapp_message» в фоновом режиме, будет иметь размер стека 8192 байта и приоритет 5. Задача создается с нулевым дескриптором, поэтому к ней нельзя будет обратиться позже, так как мы удалим ее после отправки сообщения WhatsApp.

Эта функция служит точкой входа в приложение и отвечает за инициализацию ESP32, подключение к Wi-Fi и создание задачи, отправляющей сообщение в WhatsApp.

Примечание: в этом проекте есть один заголовочный файл с именем «connect_wifi.h», мы создали его в предыдущих уроках. Вам также необходимо добавить этот файл. Вы можете скачать полный проект по ссылке для скачивания в следующем разделе.

Демонстрация отправки сообщений с ESP32 на номер WhatsApp

В этом разделе мы рассмотрим демонстрацию отправки сообщений в WhatsApp. Для начала скачайте полный проект по следующей ссылке и соберите его.

 

 

 

 

статья в разработке

(Проголосуй первым!)
Загрузка...
18 просмотров

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *