![\"Send](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/ESP32-Send-SMS-Twilio.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou can send SMS with the ESP32 without the need to rely on third-party services if you have a GSM module and a dedicated SIM card. We have tutorials showing how to send SMS with the ESP32 using the SIM800L and SIM7000G modules:<\/p>\n\n\n\n
- ESP32 SIM800L: Send Text Messages (SMS Alert) with Sensor Readings<\/a><\/li>
- LILYGO T-SIM7000G ESP32: Connect to the Internet, Send SMS, and Get GPS Data<\/a><\/li><\/ul>\n\n\n\n
If you’re looking for different types of notifications and alerts with the ESP32, you can check the following tutorials:<\/p>\n\n\n\n
- How to send emails <\/strong>with the ESP32?<\/a><\/li>
- Send WhatsApp <\/strong>messages with the ESP32<\/a><\/li>
- Telegram<\/strong>: ESP32 Motion Detection with Notifications (Arduino IDE)<\/a><\/li><\/ul>\n\n\n\n
Introducing Twilio<\/h2>\n\n\n
\n![\"twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-logo.png?resize=199%2C60&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nTwilio provides programmable communication tools for making and receiving phone calls, sending and receiving text messages, and performing other communication functions using its web service APIs. Throughout this tutorial, we’ll use their programmable messaging services.<\/p>\n\n\n\n
Twilio is a paid service, but you can sign-up for a free account for testing purposes. Then, if their services are useful for your specific project, you can always upgrade your account later on. We’ll use a free trial account throughout this tutorial.<\/p>\n\n\n\n
Creating a Free Trial Account<\/h2>\n\n\n\n
Go to https:\/\/www.twilio.com\/<\/a> and click on Sign up and start building<\/strong>.<\/p>\n\n\n
\n![\"Creating](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/Twilio-home-page.png?resize=750%2C496&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nEnter your details and get started with a free trial.<\/p>\n\n\n
\n![\"Twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/Twilio-start-free-trial.png?resize=750%2C784&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nSet Up the Free Twilio Trial Account<\/h2>\n\n\n\n
There are some steps you need to follow to set up your free Twilio trial account. We’ll describe the steps you need to follow in the present tutorial. You can also check Twilio’s official instructions here<\/a>.<\/p>\n\n\n\n
Verify your personal phone number<\/h3>\n\n\n\n
When you sign up for your free trial account, you verified your personal phone number. It should be on the list of verified phone numbers<\/a> on your dashboard: Phone Numbers<\/strong> > Manage <\/strong>> Verified Caller IDs<\/strong>.<\/p>\n\n\n
\n![\"twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-verified-personal-number.jpg?resize=750%2C563&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nVerify other recipient numbers<\/h3>\n\n\n\n
When using the free trial account, you must verify all numbers that you’ll want to send an SMS. When verifying the numbers, you’ll get an SMS with a verification code that you need to insert. So, you need to have physical access to those numbers. This is not needed on the paid account.<\/p>\n\n\n\n
On that previous menu (Phone Numbers<\/strong> > Manage <\/strong>> Verified Caller IDs<\/strong>), click on Add new Called ID<\/strong> to add a new verified number. You’ll receive an SMS with a verification code on that number.<\/p>\n\n\n
\n![\"twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-verified-caller-ids.png?resize=750%2C531&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nGet a Twilio Phone Number<\/h2>\n\n\n\n
To send messages using Twilio, you’ll need to purchase a Twilio phone number. At the time of writing this tutorial, when I signed up for the free account, I got a $15.50 credit, which is enough to get a phone number and test sending some SMS.<\/p>\n\n\n\n
On your dashboard, on the left sidebar, go to Phone Numbers<\/strong> > Manage <\/strong>> Buy a number<\/strong>. You’ll see a list of available numbers. Make sure you select SMS on the number capabilities. You can also select the country. <\/p>\n\n\n
\n![\"Buy](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/buy-twilio-number.png?resize=750%2C458&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNote: <\/strong> I tried purchasing a number from my country (Portugal), but I needed to fill out a regulatory bundle and submit some documents for review. So I ended up buying a card from the US instead, which didn’t require any of that and was ten times cheaper. This works for testing purposes, once you decide to move for a more permanent solution, double-check if that number is the most suitable for your case scenario.<\/p>\n\n\n\n
Once you’ve chosen a phone number click on the Buy<\/strong> button.<\/p>\n\n\n
\n![\"Twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-buy-us-phone-number.png?resize=608%2C636&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nProgrammable Messaging – Get Set Up<\/h2>\n\n\n\n
Now, you have everything set up to start creating a programmable messaging service. On your dashboard, on the left sidebar click on Messaging <\/strong>> Try it out<\/strong> > Get Set Up<\/strong>. Then, click on Start set up<\/strong>.<\/p>\n\n\n
\n![\"twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-programmable-messaging.png?resize=750%2C492&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nGive a name to the Messaging Service, for example, ESP32 Alerts<\/em> and click on Create Messaging Service<\/strong>.<\/p>\n\n\n
\n![\"Twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-create-messaging-service-1.png?resize=456%2C268&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThen, select the Twilio phone number you created previously and click on Add this number<\/strong>.<\/p>\n\n\n
\n![\"Twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/create-messaging-service-2.png?resize=456%2C248&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter that, the programmable messaging service will be all set up. You’ll get access to your account information: account SID and Auth token. You’ll need them later in the ESP32 code.<\/p>\n\n\n
\n![\"twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-create-messaging-service.png?resize=750%2C522&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou can test if everything is working as expected by clicking on Try SMS<\/strong>. You’ll see a similar page as shown below. Enter the phone number you want to send the message to (it must be a verified number\u2014see this previous section<\/a>), select the messaging service you created previously, and write some body text and click on Send test SMS<\/strong>.<\/p>\n\n\n
\n![\"Twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-try-test-sms.png?resize=750%2C620&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter a few seconds, you should receive the test SMS on the selected number.<\/p>\n\n\n
\n![\"SMS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/SMS-from-twilio-trial.png?resize=300%2C87&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAll SMS sent from a Twilio trial account will have the text: “Sent from your Twilio trial account”. This text doesn’t show up on premium accounts.<\/p>\n\n\n\n
ESP32: Send SMS using Twilio<\/h2>\n\n\n\n
Sending SMS using Twilio is very straightforward thanks to its API. You can read the SMS API documentation<\/a>. You simply make HTTP requests with the ESP32 with the right parameters (accordingly to Twilio’s API) to send SMS. You can check this tutorial about HTTP requests with the ESP32<\/a>.<\/p>\n\n\n\n
Or you can use a library that takes care of all that, and you just need to insert your Twilio account details and the SMS body text. Throughout this tutorial, we’ll use a library called twilio-esp32-client<\/a>.<\/p>\n\n\n\n
Installing the twilio-esp32-client Library<\/h3>\n\n\n\n
The twilio-esp32-client library can be installed through the Arduino IDE Library Manager. Go to Sketch <\/strong>> Include Library <\/strong>> Manage Libraries<\/strong>. Search for twilio-esp32-client<\/strong> and install the library.<\/p>\n\n\n
\n![\"twilio-esp32-client-library\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/twilio-esp32-client-library.png?resize=786%2C443&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nESP32 Send SMS using Twilio – Code<\/h3>\n\n\n\n
Sending code using Twilio using the twilio-esp32-client<\/strong> library is very straightforward. First, you need to create a Twilio<\/span> instance, and then you just need to call the send_message()<\/span> method and pass as arguments your Twilio account details, sender and recipient numbers, and the message body. The following code is an example from the library’s examples <\/em>folder.<\/p>\n\n\n
\/*********\r\n Rui Santos\r\n Complete project details at https:\/\/RandomNerdTutorials.com\/send-sms-esp32-twilio\/\r\n \r\n Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files. \r\n The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\r\n*********\/\r\n\r\n\/\/ Library example: https:\/\/github.com\/ademuri\/twilio-esp32-client\r\n\r\n#include "twilio.hpp"\r\n\r\n\/\/ Set these - but DON'T push them to GitHub!\r\nstatic const char *ssid = "REPLACE_WITH_YOUR_SSID";\r\nstatic const char *password = "REPLACE_WITH_YOUR_PASSWORD";\r\n\r\n\/\/ Values from Twilio (find them on the dashboard)\r\nstatic const char *account_sid = "REPLACE_WITH_YOUR_ACCOUNT_SID";\r\nstatic const char *auth_token = "REPLACE_WITH_YOUR_ACCOUNT_AUTH_TOKEN";\r\n\/\/ Phone number should start with "+<countrycode>"\r\nstatic const char *from_number = "REPLACE_WITH_TWILIO_NUMBER";\r\n\r\n\/\/ You choose!\r\n\/\/ Phone number should start with "+<countrycode>"\r\nstatic const char *to_number = "REPLACE_WITH_RECIPIENT_NUMBER";\r\nstatic const char *message = "Hello from my ESP32 (via twilio)";\r\n\r\nTwilio *twilio;\r\n\r\nvoid setup() {\r\n Serial.begin(115200);\r\n Serial.print("Connecting to WiFi network ;");\r\n Serial.print(ssid);\r\n Serial.println("'...");\r\n WiFi.begin(ssid, password);\r\n\r\n while (WiFi.status() != WL_CONNECTED) {\r\n Serial.println("Connecting...");\r\n delay(500);\r\n }\r\n Serial.println("Connected!");\r\n\r\n twilio = new Twilio(account_sid, auth_token);\r\n\r\n delay(1000);\r\n String response;\r\n bool success = twilio->send_message(to_number, from_number, message, response);\r\n if (success) {\r\n Serial.println("Sent message successfully!");\r\n } else {\r\n Serial.println(response);\r\n }\r\n}\r\n\r\nvoid loop() {\r\n \r\n}\r\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
How the Code Works<\/h3>\n\n\n\n
Start by including the twilio-esp32-client<\/span> library.<\/p>\n\n\n\n
#include \"twilio.hpp\"<\/code><\/pre>\n\n\n\nInsert your network credentials on the following lines:<\/p>\n\n\n\n
static const char *ssid = \"REPLACE_WITH_YOUR_SSID\";\nstatic const char *password = \"REPLACE_WITH_YOUR_PASSWORD\";<\/code><\/pre>\n\n\n\nInsert your Twilio account details: the account SID and token<\/a>, and the Twilio phone number<\/a>. <\/p>\n\n\n\n
static const char *account_sid = \"REPLACE_WITH_YOUR_ACCOUNT_SSID\";\nstatic const char *auth_token = \"REPLACE_WITH_YOUR_ACCOUNT_AUTH_TOKEN\";\n\/\/ Phone number should start with \"+<countrycode>\"\nstatic const char *from_number = \"REPLACE_WITH_TWILIO_PHONE_NUMBER\";<\/code><\/pre>\n\n\n\nInsert the recipient number and the message.<\/p>\n\n\n\n
\/\/ Phone number should start with \"+<countrycode>\"\nstatic const char *to_number = \"INSERT_RECIPIENT_NUMBER\";\nstatic const char *message = \"Hello from my ESP32 (via twilio)\";<\/code><\/pre>\n\n\n\nIf you’re using a free trial account, the recipient number must be on the list of the Verified caller IDs<\/a>.<\/p>\n\n\n\n
Create a Twilio<\/span> pointer variable called twilio<\/span>.<\/p>\n\n\n\n
Twilio *twilio;<\/code><\/pre>\n\n\n\nIn the setup()<\/span>, initialize the Serial Monitor and connect the ESP32 to your local network so that it can get access to the internet and make the HTTP requests to send SMS.<\/p>\n\n\n\n
Serial.begin(115200);\n Serial.print(\"Connecting to WiFi network ;\");\n Serial.print(ssid);\n Serial.println(\"'...\");\n WiFi.begin(ssid, password);\n\n while (WiFi.status() != WL_CONNECTED) {\n Serial.println(\"Connecting...\");\n delay(500);\n }\n Serial.println(\"Connected!\");<\/code><\/pre>\n\n\n\nThe following line instantiates a new Twilio<\/span> instance with the account details:<\/p>\n\n\n\n
twilio = new Twilio(account_sid, auth_token);<\/code><\/pre>\n\n\n\nThen call the send_message()<\/span> function that accepts as arguments the recipient number, the sender number, the message, and a variable to hold the response. This function makes an HTTP request in the background with all the necessary parameters to Twilio API to send SMS.<\/p>\n\n\n\n
String response;\n bool success = twilio->send_message(to_number, from_number, message, response);\n if (success) {\n Serial.println(\"Sent message successfully!\");\n } else {\n Serial.println(response);\n }\n}<\/code><\/pre>\n\n\n\nThis function will return true<\/span> if the message is successfully sent or the response of the HTTP request in case it fails.<\/p>\n\n\n\n
Sending an SMS is not free and it will be deducted from the credit on your Twilio account. So, we’re just sending one SMS on the setup()<\/span> when the board starts. The idea is to apply this sample code to your own project.<\/p>\n\n\n\n
The loop()<\/span> is empty.<\/p>\n\n\n\n
void loop() {\n}<\/code><\/pre>\n\n\n\nDemonstration<\/h3>\n\n\n\n
After inserting all the required details, you can upload the code to your ESP32 board. Select an ESP32 board in Tools<\/strong> > Board <\/strong>and select the COM port in Tools <\/strong>> Port<\/strong>. Then, click on the Upload button.<\/p>\n\n\n
\n![\"Arduino](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/05\/arduino-2-0-upload-button.png?resize=30%2C30&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter uploading, open the Serial Monitor at a baud rate of 115200. Press the ESP32 RST button to restart the board. If everything goes as expected, you should receive a similar message as shown below.<\/p>\n\n\n
\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/ESP32-send-sms-via-twilio-Serial-Monitor-demonstration.png?resize=601%2C415&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter a few seconds, you should receive an SMS from Twilio on your phone.<\/p>\n\n\n
\n![\"Twilio](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/11\/Twilio-SMS-ESP32.png?resize=450%2C152&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWrapping Up<\/h2>\n\n\n\n
In this tutorial, you learned how to send SMS with the ESP32 using Twilio programmable messaging API. The advantage of using this method is that you don’t need to have a modem or a physical SIM card to send SMS with your board.<\/p>\n\n\n\n
However, you need to buy a Twilio phone number, and you’ll need to pay a monthly subscription for the card. You’ll also need to pay for each SMS you send. You can sign up for a free trial account that gives you credit to experiment with Twilio in your projects\u2014so, you can try their services for a while for free. If you feel their service is the right for your projects, then you can update your account later on.<\/p>\n\n\n\n
You can also send SMS with the ESP32 using other methods\u2014using modems like the SIM800L, SIM7000G, and others. We have tutorials showing how to send SMS with the ESP32 using the SIM800L and SIM7000G modules:<\/p>\n\n\n\n
- ESP32 SIM800L: Send Text Messages (SMS Alert) with Sensor Readings<\/a><\/li>
- LILYGO T-SIM7000G ESP32: Connect to the Internet, Send SMS, and Get GPS Data<\/a><\/li><\/ul>\n\n\n\n
We hope you find this tutorial useful.<\/p>\n\n\n\n
Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":"
This guide shows how to send SMS with the ESP32 using an online service called Twilio. With this service, you can send SMS with the ESP32 without needing a GSM … <\/p>\n
- LILYGO T-SIM7000G ESP32: Connect to the Internet, Send SMS, and Get GPS Data<\/a><\/li><\/ul>\n\n\n\n
- Send WhatsApp <\/strong>messages with the ESP32<\/a><\/li>
- LILYGO T-SIM7000G ESP32: Connect to the Internet, Send SMS, and Get GPS Data<\/a><\/li><\/ul>\n\n\n\n