Plugin - SMS Notification (Send a SMS to a mobile phone number)

RSForm!Pro SMS Notification Plugin

Important: The RSForm!Pro SMS Notification plugin is commercial. It needs to be purchased separately from your RSJoomla! account by heading to My Memberships & License codes > RSForm!Pro and clicking on the “buy plugins” button. Also note that your account needs to hold an active RSForm!Pro subscription.

In this article we will show you how to setup the SMS Notification Plugin. The SMS Notification Plugin will allow you to send a text message to a phone number when one of your forms is submitted.

Downloading and Installing the plugin
Download

You can download the plugin by logging into our website with your purchase user, then head to Downloads > Paid Downloads > RSForm!Pro > Modules & Plugins > "SMS Notification Plugin".


Install

In the backend of your Joomla! installation go to the Extensions > Install/Uninstall page, and install the plugin. Next thing is to publish the plugin, to do this go to Extensions > Plug-in Manager, search for the "RSForm!Pro SMS Notification" plugin and publish it.


Choosing the SMS Gateway Provider

Once the plugin is enabled head over to RSForm! Pro > Configuration and in the RSForm!Pro - SMS Notification tab you will have to select a SMS Notification Service. Regardless of your choice you will need to create an account at the respective service provider in order to set-up the plugin in Joomla!

Here are some basic guidelines for each SMS gateway provider:

  • SMS Notification Service:

    Clockwork
    • Clockwork
    • Clockwork API Key: you can obtain your Clockwork API key by creating or logging in to your API account here.

    Twilio
    • Twilio
    • Twilio Account SID: you can create application SIDs from your Account Portal, for more information access Twilio’s FAQ;
    • Twilio Account Token: you can find the Auth Token in the account dashboard, click on the dots to reveal your token.

    Sms Global
    • Sms Global
    • SMS Global User: fill in your SMS Global username;
    • SMS Global Password: fill in your SMS Global password;

    Clickatell
    • Clickatell
    • Clickatell Username: fill in your Clickatell username;
    • Clickatell Password: fill in your Clickatell password;
    • Clickatell API ID: the API ID will be provided to you after signing up on their website; for more information visit their API documentation.

    Nexmo
    • Nexmo
    • Nexmo Key: after creating your account you will find the key located under API Setting in the Nexmo Dashboard;
    • Nexmo Secret: you will find the nexmo secret in the same location as the key, under API Setting in the Nexmo Dashboard.

  • Use SSL: No/Yes - Use a secure connection


Configuring your SMS messages

Now that the plugin is configured accordingly you can go ahead and access RSForm! Pro > Manage Forms in order to edit the form that will use the SMS Notification integration.

You will notice that in the Form Properties area a new tab has appeared where you can enable for the user, admin or both to receive a SMS notification upon a form submission.

User SMS Settings

Enable this in order for your users to receive a SMS notification upon submitting the form and configure it as shown below:

  • From Name: this is the name from which your user will receive the SMS; you can fill in a value or use placeholders;
  • To Number: in this field fill in the phone number of the user where the SMS will be sent; when using a placeholder, please make sure that you use the actual field name in the syntax;
  • SMS Text: write here the message you want your user to receive upon submitting a form, but be wary the SMS will fail to be sent if your message exceeds 459 characters.
Admin SMS Settings

Enable this in order for the admin to receive a SMS notification when the form is submitted and configure it as shown below:

  • From Name: this is the name from which your admin will receive the SMS; in this field you can write a value or you can use a placeholder from your form;
  • To Number: fill in the telephone number of the Administrator, again you can use a direct value or a form field placeholder here;
  • SMS Text: type here the message the admin will receive when a form is submitted; the message must not exceed 459 characters or it will fail to be sent.

Note: The phone number entered in the "To Number" field must have an International Phone Number format. This means that it should also contain the country calling code.

There are multiple ways of setting up an International Phone Number:

  1. Using a dropdown field for selecting the country code and a field for phone number. You can use the pipeline structure: value|label in order to set up your dropdown items(eg: +33|France). Afterwards the "To Number" field within the "User SMS Settings" can be set up using the both placeholders for your country code and phone number field. Example: {countrycode:value}{phonenumber:value}

  2. By adding the country code directly in the "To Number" field of your "User SMS Settings" section. If your website is targeted to users from a single country, you can ask your users to submit only the phone number without the country code(this being already added in the "To Number" field). Your "To Number" field within the "User SMS Settings" will have the following syntax: +33{phonenumber:value}

9 persons found this article helpful.


Was this article helpful?

Yes No
Sorry about that