В этом уроке мы научимся отправлять SMS с помощью ESP32 и ESP-IDF, используя API веб-сервисов Twilio. Twilio — это облачная коммуникационная платформа, которая позволяет разработчикам программного обеспечения программно совершать и принимать телефонные звонки, отправлять и получать текстовые сообщения, а также выполнять другие коммуникационные функции, используя API своих веб-сервисов.
Мы будем использовать библиотеку HTTP-клиента, доступную в ESP-IDF, для отправки HTTP POST-запросов к REST API Twilio с использованием различных полей. Эти поля будут содержать сообщение, которое мы хотим отправить. Для демонстрации мы отправим простое текстовое сообщение. Но вы также можете отправлять показания датчиков, таких как DS18B20, DHT22, BME680 и SHT31, уведомления об изменении данных, уведомления об обнаружении движения и т. д.
Также на нашем сайте мы рассматривали и другие проекты по отправке SMS:
- как отправлять SMS с помощью ESP32;
- передача SMS с помощью модуля ESP8266;
- передача и прием SMS с помощью STM32F103C8 и GSM модуля SIM800C.
Веб-сервис Twilio
Twilio — это облачная коммуникационная платформа, предоставляющая API для голосовой связи и SMS-сообщений, а также других каналов связи, таких как видеосвязь и чат. Веб-сервисы Twilio позволяют разработчикам создавать и интегрировать коммуникационные возможности в свои приложения и системы.

С помощью Twilio разработчики могут программно отправлять и получать текстовые сообщения, совершать и принимать телефонные звонки, отправлять мультимедийные сообщения и управлять каналами связи, такими как WhatsApp и Facebook Messenger, используя простые REST API.
Twilio также предоставляет дополнительные инструменты и сервисы, такие как Twilio Studio, визуальный конструктор приложений, и Twilio Flex, облачная платформа для контакт-центров.
В целом, Twilio предоставляет комплексную и масштабируемую платформу для предприятий и разработчиков, позволяющую создавать и интегрировать коммуникационные возможности в свои приложения, продукты и системы.
Создание пробного аккаунта Twilio
Перейдите на сайт Twilio (www.twilio.com) и зарегистрируйте бесплатный аккаунт.
Введите свои данные и нажмите кнопку ‘Start your free trial’ («Начать бесплатную пробную версию»).
Подтвердите свой адрес электронной почты, перейдя по ссылке, отправленной на ваш электронный адрес.
После подтверждения адреса электронной почты войдите в консоль Twilio.
После успешной проверки вам станет доступна панель управления вашей учетной записи Twilio:
Создание бесплатного аккаунта Twilio
Перейдите в раздел Phone Numbers > Manage > Verified Caller IDs («Номера телефонов» > «Управление» > «Подтвержденные идентификаторы вызывающего абонента»). Здесь номер телефона, предоставленный в процессе верификации, будет отображаться в вашем аккаунте Twilio.
В консоли Twilio нажмите “Add a new Caller ID” («Добавить новый идентификатор вызывающего абонента»).
- Введите желаемый номер телефона.
- Код подтверждения будет отправлен на указанный номер по SMS.
- Введите проверочный код в консоли Twilio, чтобы завершить процесс добавления идентификатора вызывающего абонента.
Примечание: при использовании бесплатной пробной версии аккаунта Twilio любой номер, используемый для отправки SMS, должен быть предварительно подтвержден как номер вызывающего абонента.
Получение номера телефона от Twilio
Чтобы приобрести номер телефона для использования с Twilio, выполните следующие шаги:
- Перейдите в раздел “Phone Numbers” («Номера телефонов») в консоли Twilio.
- Выберите “Buy a Number” («Купить номер») и укажите необходимые функции, включая SMS.
- Используйте поля country («Страна») и расширенный поиск, чтобы найти подходящий номер среди доступных вариантов.
Примечание: даже если вы используете бесплатную пробную учетную запись Twilio, вы получите 15,50 долларов США в виде кредита, который можно использовать для покупки телефонного номера.
Примите условия и положения и нажмите кнопку Buy («Купить»).
Кроме того, вам может потребоваться настроить параметры приобретенного номера.
Чтобы просмотреть недавно приобретенный номер телефона, перейдите в консоль Twilio в раздел “Phone Numbers” > “Manage” > “Active Numbers” («Номера телефонов» > «Управление» > «Активные номера»).
Настройка программируемой службы обмена сообщениями
После создания бесплатной учетной записи Twilio, добавления подтвержденного идентификатора вызывающего абонента и получения номера Twilio для отправки SMS, следующим шагом является настройка сервиса программируемых сообщений. Для этого:
- В консоли Twilio перейдите в раздел “Messaging” > “Try it out” > “Get Set Up” («Сообщения» > «Попробовать» > «Настроить»).
- Откроется приветственная страница сервиса программируемых сообщений.
- Нажмите кнопку “Start setup” («Начать настройку»), чтобы запустить процесс настройки.
- На странице настроек укажите название для сервиса.
- Нажмите кнопку “Create Messaging Service” («Создать службу обмена сообщениями»).
Введите номер телефона Twilio, который вы только что приобрели. Затем нажмите ‘Add this number’ («Добавить этот номер»).
После завершения процесса настройки у вас теперь есть доступ к идентификаторам службы сообщений (Message Service SID), учетной записи (Account SID) и токена аутентификации (Auth Token). Эти учетные данные понадобятся при программировании ESP32 с помощью ESP-IDF для отправки SMS.
Тестирование сервиса
Перед написанием кода для ESP32 для отправки SMS рекомендуется протестировать службу программируемых сообщений, созданную с помощью curl.
Для этого:
- В консоли Twilio перейдите в раздел “Messaging” > “Try it out” > “Send an SMS” («Сообщения» > «Попробовать» > «Отправить SMS»).
- Введите номер телефона получателя. Примечание: номер получателя должен быть подтвержденным идентификатором вызывающего абонента, а сообщение должно быть отправлено с использованием идентификатора службы обмена сообщениями (SID).
- Введите текст сообщения и нажмите кнопку “Send test SMS” («Отправить тестовое SMS»), чтобы отправить тестовое сообщение.
Создание проекта в ESP-IDF для отправки SMS с помощью Twilio
В этом разделе давайте создадим проект ESP-IDF для отправки SMS с помощью Twilio.
Откройте VS Code и перейдите в меню View > Command Palette («Вид» > «Палитра команд»). Введите в строке поиска ESP-IDF: New Project и нажмите Enter.
Укажите название проекта и каталог, а также плату и целевое устройство ESP-IDF. Мы назвали наш проект «esp32_sms_twilio». Для платы 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 для отправки SMS с помощью Twilio
ESP-IDF реализует функцию отправки SMS-сообщений с использованием API Twilio. Для этого требуется учетная запись Twilio, которая предоставляет идентификатор учетной записи (SID) и токен аутентификации. Номера телефонов получателя и отправителя, а также отправляемое сообщение определяются в коде как переменные.
URL-адрес API Twilio и данные для отправки формируются из этих переменных и информации об аутентификации. Библиотека esp_http_client используется для отправки HTTP POST-запроса к API Twilio с сформированными данными. Результат запроса проверяется, и в случае успеха в журнал записывается сообщение, указывающее на успешную отправку сообщения. В случае ошибки в журнал записывается сообщение о сбое. Функция вызывается как задача, созданная основной функцией после подключения к сети Wi-Fi.
|
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 95 96 97 98 99 100 |
#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"; // Your Account SID and Auth Token from twilio.com/console char account_sid[] = "replace_with_your_account_sid"; char auth_token[] = "replace_with_your_account_auth_token"; char recipient_num[] = "replace_with_your_reciver_number"; char sender_num[] = "replace_with_your_twilio_number"; char message[] = "Hello This is a test message"; void twilio_send_sms(void *pvParameters) { char twilio_url[200]; snprintf(twilio_url, sizeof(twilio_url), "%s%s%s", "https://api.twilio.com/2010-04-01/Accounts/", account_sid, "/Messages"); char post_data[200]; snprintf(post_data, sizeof(post_data), "%s%s%s%s%s%s", "To=", recipient_num, "&From=", sender_num, "&Body=", message); esp_http_client_config_t config = { .url = twilio_url, .method = HTTP_METHOD_POST, .auth_type = HTTP_AUTH_TYPE_BASIC, }; esp_http_client_handle_t client = esp_http_client_init(&config); esp_http_client_set_header(client, "Content-Type", "application/x-www-form-urlencoded"); esp_http_client_set_username(client, account_sid); esp_http_client_set_password(client, auth_token); ESP_LOGI(TAG, "post = %s", post_data); esp_http_client_set_post_field(client, post_data, strlen(post_data)); 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 == 201) { 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(&twilio_send_sms, "twilio_send_sms", 8192, NULL, 6, 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" |
Определите четыре символьных массива для хранения идентификатора учетной записи Twilio (SID), токена аутентификации Twilio, номера телефона получателя и номера телефона отправителя. Это строковые литералы, используемые для отправки SMS-сообщения через API Twilio.
|
1 2 3 4 5 |
// Your Account SID and Auth Token from twilio.com/console char account_sid[] = "replace_with_your_account_sid"; char auth_token[] = "replace_with_your_account_auth_token"; char recipient_num[] = "replace_with_your_reciver_number"; char sender_num[] = "replace_with_your_twilio_number"; |
Функция отправки SMS в Twilio
Эта функция отвечает за отправку SMS с использованием API Twilio и клиентской библиотеки ESP-IDF HTTP. Функция twilio_send_sms() принимает в качестве параметра указатель типа void.
|
1 |
void twilio_send_sms(void *pvParameters) |
Объявляет символьный массив twilio_url размером 200 символов, который используется для хранения URL-адреса конечной точки API Twilio для отправки SMS-сообщений.
|
1 |
char twilio_url[200]; |
Формирует URL-адрес для конечной точки API Twilio путем объединения различных строковых литералов и значений переменных account_sid и auth_token. Результат сохраняется в массиве twilio_url.
|
1 2 3 4 5 6 |
snprintf(twilio_url, sizeof(twilio_url), "%s%s%s", "https://api.twilio.com/2010-04-01/Accounts/", account_sid, "/Messages"); |
Объявляет символьный массив post_data размером 200, который используется для хранения данных, которые будут отправлены на конечную точку API Twilio.
|
1 |
char post_data[200]; |
Эта функция формирует данные, которые будут отправлены на конечную точку API Twilio, путем конкатенации различных строковых литералов и значений переменных recipient_num, sender_num и message. Результат сохраняется в массиве post_data.
|
1 2 3 4 5 6 7 8 9 |
snprintf(post_data, sizeof(post_data), "%s%s%s%s%s%s", "To=", recipient_num, "&From=", sender_num, "&Body=", message); |
Объявляет структуру конфигурации типа esp_http_client_config_t и инициализирует её значениями переменной twilio_url, а также константами HTTP_METHOD_POST и HTTP_AUTH_TYPE_BASIC.
|
1 2 3 4 5 |
esp_http_client_config_t config = { .url = twilio_url, .method = HTTP_METHOD_POST, .auth_type = HTTP_AUTH_TYPE_BASIC, }; |
Вызовите функцию esp_http_client_init, передав ей указатель на структуру конфигурации, и сохраните полученный дескриптор клиента в переменной client.
|
1 |
esp_http_client_handle_t client = esp_http_client_init(&config); |
Вызывает функцию esp_http_client_set_header, передавая ей дескриптор клиента и строковый литерал, для установки значения заголовка Content-Type для запроса.
|
1 |
esp_http_client_set_header(client, "Content-Type", "application/x-www-form-urlencoded"); |
Вызывает функции esp_http_client_set_username и esp_http_client_set_password, передавая им дескриптор клиента и значения переменных account_sid и auth_token соответственно, для установки учетных данных для базовой аутентификации.
|
1 2 |
esp_http_client_set_username(client, account_sid); esp_http_client_set_password(client, auth_token); |
Далее, присвойте полю POST клиента массив post_data и его длину. Наконец, выполните HTTP-запрос с помощью функции esp_http_client_perform() и присвойте результат переменной err.
|
1 2 3 |
esp_http_client_set_post_field(client, post_data, strlen(post_data)); esp_err_t err = esp_http_client_perform(client); |
В конце кода проверяется, равна ли переменная err значению ESP_OK, что указывает на успешность HTTP-запроса к API Twilio. Если err равно ESP_OK, код проверяет код состояния ответа. Если код состояния равен 200, выводится сообщение об успешной отправке SMS. Если код состояния не равен 200, выводится сообщение о неудачной отправке сообщения.
Если err не равен ESP_OK, это означает, что HTTP-запрос не был успешным, и будет выведено сообщение о том, что отправка сообщения не удалась.
Функция esp_http_client_cleanup вызывается для освобождения ресурсов, связанных с переменной клиента. Функция vTaskDelete(NULL) вызывается для удаления текущей задачи.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
if (err == ESP_OK) { int status_code = esp_http_client_get_status_code(client); if (status_code == 201) { 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); |
Вкратце, эта функция отправляет SMS-сообщения, используя API Twilio и ESP32 ESP-IDF. Для связи с API Twilio и отправки сообщения используется протокол HTTP. Для аутентификации функция использует SID учетной записи и токен аутентификации из учетной записи Twilio. Номера телефонов получателя и отправителя передаются в качестве глобальных переменных, а тело сообщения — в качестве еще одной глобальной переменной.
Эта функция подготавливает URL-адрес и POST-данные, необходимые для HTTP-запроса. Она инициализирует HTTP-клиент, устанавливает заголовок и имя пользователя/пароль для аутентификации, задает в POST-поле тело сообщения, выполняет HTTP-запрос и проверяет статус ответа. Если код состояния равен 201, она регистрирует сообщение об успехе, в противном случае — сообщение об ошибке. Наконец, она очищает HTTP-клиент и удаляет задачу.
Основная функция приложения
Функция «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); |
Подключается к сети Wi-Fi, вызывая функцию «connect_wifi()».
|
1 |
connect_wifi(); |
Если подключение к Wi-Fi установлено успешно, создается задача «twilio_send_sms», которая отправляет SMS с использованием API Twilio.
|
1 2 3 4 |
if (wifi_connect_status) { xTaskCreate(&twilio_send_sms, "twilio_send_sms", 8192, NULL, 6, NULL); } |
Примечание: в этом проекте есть один заголовочный файл с именем «connect_wifi.h», мы создали его в предыдущих уроках. Вам также необходимо добавить этот файл. Вы можете скачать полный проект по ссылке для скачивания в следующем разделе.
Демонстрация отправки SMS с помощью ESP-IDF и Twilio
В этом разделе мы рассмотрим демонстрацию отправки сообщений в WhatsApp. Для начала скачайте полный проект по следующей ссылке и соберите его.
Настройка учетных данных Wi-Fi
Теперь перейдите в меню menuconfig. Щелкните значок, показанный ниже. Откроется редактор конфигурации ESP-IDF SDK.
Прокрутите вниз и откройте Example Configuration (пример конфигурации). Здесь мы можем установить параметры конфигурации для этого примера в соответствии с нашими потребностями. Это включает в себя SSID сети Wi-Fi, пароль сети Wi-Fi и максимальное количество попыток повтора. Укажите SSID и пароль сети Wi-Fi вашего маршрутизатора, к которому будет подключаться плата ESP32. По умолчанию максимальное количество попыток повтора установлено на 5. Вы можете изменить это значение по своему усмотрению. После указания параметров конфигурации нажмите кнопку «Сохранить» вверху.
Отключение ESP TLS
Мы используем HTTP вместо HTTPS, поэтому нам необходимо отключить компонент ESP-TLS в settings->Components Config>ESP-TL.
Для прошивки микросхемы введите следующую команду в последовательном терминале. Не забудьте заменить COM-порт на тот, через который подключена ваша плата
|
1 |
idf.py -p COMX flash monitor |
После успешной прошивки кода вы можете просмотреть все информационные журналы. Сначала инициализируется Wi-Fi станции. Затем мы можем просмотреть esp_netif_handlers, который включает IP-адрес, маску и адрес шлюза. Затем мы получаем запись «получен IP-адрес», за которой следует IP-адрес, что показывает, что ESP32 успешно подключился к вашей сети Wi-Fi.
Если всё работает правильно, в консоли появится сообщение “Message sent Successfully” («Сообщение успешно отправлено»), как показано ниже.
Теперь вы можете посмотреть на своем смартфоне успешно отправленное с помощью Twilio SMS.




























