The humble SMS packs a punch.
People check their phones constantly, and 98 percent of texts are read within 3 minutes, versus 20 percent of emails.
You can double down on the benefits of text messaging by reprogramming SMS to be sent at a specific date and time. In simple terms, you can program or schedule messages to be set and forget — and your team will thank you for reducing their admin time.
You can easily set up your scheduled text messages with our SMS API. It offers a quick way to send messages anywhere in the world via trusted, direct routes.
Good news for devs, our API supports multiple programming languages including PHP. Using our REST API, you can post up to 1,000 SMS messages for each API call or post to a list of up to 20,000 subscribers with each API call for larger campaigns. Learn how to use the our REST API to send scheduled SMS in PHP.
Why schedule text messages?
You don’t have to schedule messages for these specific use cases, but here are example messages that work best when you set them to be sent automatically.
- Promotional campaigns: For example, you can schedule your Black Friday or Cyber Monday texts months ahead of both events.
- Birthday or anniversary messages: Customers love getting these, and you can send them every year.
- Post-event notifications: Schedule these for twenty-four hours after an event to get feedback or to promote the next event.
- Booking/appointment reminders: Schedule these to be sent a few times before an event to reduce no-shows.
How to send scheduled SMS in PHP
Our SMS API documentation offers straightforward instructions for integrating SMS into your PHP application. To implement scheduled messages in PHP using our API, follow the steps below. You can find a sample application here if needed.
Register for a free ClickSend account
You’ll need to sign up for an account, if you haven’t already.
Once you register, we’ll send you an activation PIN via text message in order to confirm that you are the owner of the mobile number that you provided during sign-up.
Enter the activation PIN on the verification page, then click the Submit button. You’ll be able to access the dashboard for your ClickSend account once you’ve been verified:
Once you're in, you’ll get access to a variety of tools and some free credit to use for testing.
Copy your API Key
Next, copy your API key from the API Credentials area. You need the API key to validate your account before using any of our tools or API.
To retrieve your API credentials, navigate to the Developers dropdown option on your dashboard and click API Credentials. The accessible API keys for each individual user in your account will be displayed on the Subaccounts page:
Install the PHP library
We offer a PHP library that can be used to integrate services into your PHP application. Make sure you have PHP 5.5 or any later version installed before you begin.
Run the following command in the terminal inside your PHP project directory to install the library via Composer:
The command will also install all of the necessary dependencies for the PHP library:
Write the PHP code for sending SMS messages
After the library has been installed, create a PHP file named schedule.php in your project directory. You’ll use our API to schedule a message in this file.
Add the following code to the PHP file, per the documentation:
The above code does the following, according to the comment numbers:
- Includes the Composer autoloader file that will load the library you installed.
- Configures the basic authentication by entering your username and API key, which you obtained earlier and should place in the code.
- Instantiates a new API object to connect to the ClickSend API to handle API requests.
- Creates a new message object to schedule using the
SmsMessage()method. - Sets the body of the message you want to schedule.
- Sets the phone number to send the SMS. The above is one of several example phone numbers that you can use.
- Sets the date and time for the scheduled SMS, which must be in Unix format. ClickSend uses this format because it's in universal time, so it’s the same for everyone regardless of time zone.
- Creates a new array of
SmsMessageitems and sets the message object you have created to the newSmsMessageCollection. - Sends the message by using the API instance. If executed successfully, it will return the result in JSON format; otherwise, it will return an exception message.
Run the code
Run the following command in the terminal while you are in the project directory to execute the PHP code in the schedule.php file:
Evaluate the results
You should be able to see the following result in the terminal, formatted as a JSON string:
In the above result, "http_code": 200 and "response_code": "SUCCESS" indicate that the request was completed successfully. The response_msg tells you that messages are queued for delivery, and the rest of the string shows the data that was submitted when executing the PHP code.
Cancel scheduled SMS message
If you want to cancel a planned text message because a scheduled event has passed or a sale is over, you can handle this easily.
To do this, you need to provide the message ID in the smsCancelByMessageIdPut() method. Create a PHP file called cancel.php and add the following code:
The above code does the following, according to the comment number:
- Includes the Composer autoloader file that will load the library you installed.
- Configures the basic authentication by entering your username and API key.
- Instantiates a new API object to connect to the ClickSend API to handle requests.
- Adds the ID of the message you want to cancel in string format.
- Cancels the scheduled SMS by using the
smsCancelByMessageIdPut()method.
After adding your username, API key, and message ID to the code, run the following command in the terminal:
The results will be displayed in JSON format after executing the PHP code, indicating that the cancellation request for the scheduled SMS was successful:
Easy set-up for set-and-forget messages
Scheduled messages are useful to help businesses interact with their audience and increase productivity of internal teams. We love working with developers and our well-loved API docs make set-up and programming easy.
Plus, we integrate with 900+ of the the most widely used business applications in the world, including Zapier, Salesforce, Shopify and Wordpress. Sign up to see how easy it is to add custom, scheduled SMS to your PHP-based systems.
About the author
Davis David 🇹🇿 Twitter: @Davis_McDavid
Davis David is a data scientist at Dlab with a background in computer science. He is passionate about artificial intelligence, machine learning, deep learning, and software development. Davis is the co-organizer of AI meet-ups, workshops, and events with the goal of building a community of data scientists in Tanzania to solve local problems. He is also a content writer on platforms like Medium, Hackernoon, and FreecodeCamp.
