Settings Tab


The “Settings” tab

Within this tab, the authentication details for Twilio are entered and the settings relating to licensing,  inbound message handling, notifications and some general settings can be configured.

Settings tabs

 

The Settings tab is split into the following subsection:

Get Started

This subsection provides a short list of instructions to get you up and running with the plugin.

Twilio Settings

Use this subsection to enter your Twilio Acccount SID and your Twilio Authentication Token. These are obtained from Twilio, when you register for your account and purchase your Twilio number.

Once you have entered your Twilio account details, press the Save button. The phone numbers drop down list, will then be populated with your Twilio phone numbers. Select the number you want to send messages from and press the Save button again.

Settings - Joy Of Text Pro

Settings – Joy Of Text Pro

 

Twilio Account SID

Enter the Account SID number that you received when you registered with Twilio.

Twilio Auth Token

Enter the Twilio Auto Token that you received when you registered with Twilio.

Phone Numbers

Once you have entered and saved your Twilio account details, this dropdown will contain your Twilio master phone number and any sub-account numbers. Select the number you wish to SMS and voice messages from. Click the “Save Settings” button to remember your selected number.

Your country code

The plugin will verify that each phone number entered through the admin screens or through the subscriber web forms is valid. The number is sent to Twilio for validation.  To validate the number, Twilio requires a country code, as it will prefix the number with the country code in order to validate it. Use this field to select your country code. The default code is for the United States.

 

Licence key settings

When you purchase JOT Pro, you will be sent a licence key. Entering and activating your licence key will enable automatic updates, available from the WordPress dashboard. When new versions of the plugin are available, they will be posted on this site and you’ll get a notification on your WP dashboard that an upgrade is available.
zzz_settings1

Enter your licence key

Enter the licence key sent to you when you purchased the plugin. If you’ve purchased a single site licence, then then licence key will enable automatic updates on one site. If you’ve purchased a multi-site licence, then the key can be used on multiple sites (current 6 or 10 sites).

Licence Activation status

Once you’ve entered your licence key, then press the “Activate licence” button. You licence is validated and your status should change to “Active” or “valid”.

If you’ve lost your licence key or the licence is not activating, the please contact jotplugin@gmail.com

 

Inbound Message settings

 

Twilio’s “A Message Comes In” field
To enable inbound SMS messages to be received by the JOT plugin, the URL shown in the “SMS Request URL” field must be configured within your Twilio account.

Go onto the Twilio website, select your number and cut and paste the URL shown in “SMS Request URL” field into Twilio’s “A Message Comes In” input box and save, as shown below.

Configure Inbound SMS

On the Inbound Message Settings page, you can specify a keyword, which will show members their current subscriptions.

 

For example, in the image above, the keyword is set to “mygroups”. When a user sends a text to your Twilio number containing the word ‘mygroups’, they will receive a text message containing a list of all the groups they are currently subscribed to, with the opt-in and opt-out keywords shown for each group.

The keyword you’ve selected for managing your subscriptions can be included in your outgoing messages, by using the new merge tag %jot_submgr%.

 

Notification settings

Notification Settings

The JOT plugin can receive SMS messages sent to your selected Twilio number.  When a message is received you can choose to route the incoming message to another mobile number or to an email address. For example, customers may send you an SMS in response to a promotion advertised on your site. You can chose to route this message onto your personal cell phone number or email address, allowing you to be responsive to your customers’ enquiries.

Inbound SMS notifications?
Click the checkbox, if you want an SMS message to be sent, when you receive an SMS messages to your Twilio number.

Subscription notifications
Click the checkbox, if you want an SMS message to be sent, when you someone subscribes to a group.

Number to send notifications to
If you have clicked the checkbox above, then you can enter a mobile phone number to send the SMS notifications to. This is an optional field.

Email address to route SMS messages to :
If you have clicked the checkbox above, then you can enter an email address route inbound SMS messages to. This is an optional field.

Notification message

Use this field to specify the format of the routed message.

The routed message can contain the special tags shown below:

  • %fullname% or %name% – when the message is sent, this tag is replaced by the message sender’s full name (if known).
  • %firstname%  – the tag is replaced by the message sender’s first name (if known).
  • %lastname% – the tag is replaced by the message sender’s first name (if known).
  • %number% – the tag is replaced by the message sender’s phone number.
  • %id% – the user id of the message sender.
  • %message% – the body of the inbound message.

 

Routed SMS suffix
You can choose to append a suffix at the end of routed messages, so that you know where the message has come from.

 

General Settings

General Settings

Enter default Sender ID- NOT supported in the USA.

Twilio supports Sender IDs, which can be used for message branding, by replacing your phone number with an alphanumeric string of characters. To set a default Sender ID, enter your brand into this field. The Sender ID can be up to 11 characters long. If a default value is set, this Sender ID will be used for all automatic responses, such as when users subscribe to a group or an auto-group. The list of countries where Twilio supports Sender IDs, can be found here.

 

Voice preferences

You can use these settings to select the gender and the accent of the voice used when making text-to-voice calls.

Select Voice – select a male or female voice for the text-to-voice calls.

Select Voice Language – select the language/accent for text-to-voice calls.

 

Plugin Tabs

Select default tab – select your preferred default tab. When you first start the plugin (by clicking the Messaging link from the WordPress dashboard), the plugin will open the tab you’ve selected here.

 

Remote admin settings

Provided that the “SMS request URL” has been configured in Twilio, the remote commands can be sent to the plugin from a specified cell number. The remote commands allow group details to be retrieved and allow SMS messages to be sent to groups.

The commands available are:

#(number)(message) – This command will send the message to the specified number. For example #07790532801 Hi there %name% thanks for your message

@(user id)(message) – This command will send the message to the specified member’s phone.

[get groups {search string}]. This command, send from the specified admin number, to the JOT plugin, will retrieve a list of all of the groups configured within the plugin.

Optionally, if the search string is specified, all groups containing the search string in the name of the group, will be returned.

For example [get groups cust] – will return all groups, where the group name contains the string ‘cust’.

The group list is returned to the admin number as an SMS message. The message contains as unique identifier of each group (the groupid) and the group name.

[get group (groupid) {search string}]. If only the groupid is specified, this command will retrieve all members of the group with that groupid.

For example [get group 50] will retrieve all of the member details (name and cell number) of the group number 50.

By specifying the optional {search string} parameter, only the members whose name contains the search string will be returned.

For example [get group 50 john] will return the details of messages whoes name contains ‘john’ within group number 50.

[send group (groupid)] (message). This command will send an SMS message to all members of the given group (specified by the groupid). All of the text after the command
is sent in the SMS message.

For example, [send group 50]Hello everyone. Due to the weather, training is cancelled today. This command will send everyone in group 50, a message telling them they have the morning off!

All command responses are limited to 320 character SMS messages. All responses over 320 characters, will be truncated.

Commands can be enclosed in square brackets [] or forward slashes //, for example

[get groups] or /get groups/

Admin Number

Use this field to identify the admin number, from which you can send the commands outline above to the JOT plugin.

 

System Info

The system info tab shows a consolidated view of all of your Twilio and JOT settings. If you’ve asked for some support, you make be asked to provide the information shown on this tab.