As of PBBooking 4.0.3 two different SMS plugins are included.
This knowledge base article will cover how to configure Twilio in PBBooking v4. SMSGlobal is covered in this article. How to configure SMSGlobal SMS Plugin.
Step 1: Create a Twilio Account
Firstly you will need to create a Twilio account from the main Twilio website. You can access that here: https://www.twilio.com/. To signup you will need to provide a mobile phone # and email address.
Once you have created your account and signed in you will need to get your account SID and auth token from the dashboard.
After logging to the dashboard you will need to buy a number. Do this by clicking the Buy a Number link on the dashboard, then in the next page make sure you choose a number with SMS capabilities.
Please note: of you select a number without SMS capabilities you will be UNABLE to send SMS.
Twilio also requires that ALL sender IDS are verified. They will also NOT allow alpha numeric sender IDS on trial accounts. To verify a number click on Verified Caller IDs and then select the Plus button at the top of the list of numbers.
Please note: trial Twilio accounts may only send from AND to verified numbers. You will need to upgrade your account before you can send to non verified accounts.
Step 2: Configure the Plugin
Log in your your Joomla website and go to the Plugin Manager from Extensions -> Plugin Manager. Then click the Search Tools button next to the search box and from the select type dialog scroll down to PBBooking. This will bring up all the installed PBBooking plugins.
Click on the Hot Chilli Software: Send SMS (Using Twilio) link to open the configuration page for the plugin.
Tell PBBooking which events you wish to send an SMS on. This can be:
- Send on Create: Sends an SMS when the event is first created and is still at a pending state (ie. not validated)
- Send on Validate: Sends an SMS after an event has been validated (regardless of whether it validated by an admin, user, or auto validation)
- Send on Reminder: Sent when an event meets the criteria for the reminder to be sent. This requires that reminders and enabled and the cron job is running successfully.
The Twilio Account SID and Twilio Account Token are entered from your Twilio account. Please note: this is not your actual Twilio username and password but the API username and password.
The default country code to add specifies which country code should be added to the front of your mobile phone number. The plugin will check to see if this already exists before deciding whether to add or not to add.
The strip leading 0 specifies whether PBBooking should leave a 0 at the front of the number or remove. For example in Australia we commonly enter mobile phone numbers as 0468 123 123 but gateways generally expect the 0 to be removed. Your country may not work this way.
The mobile # for the custom field specifies which of the custom fields contains the customers phone number. This is the variable name of the custom field NOT the label. You can find the variable name of the custom field by accessing the Customfields from the dashboard.
Finally include the sender ID you wish to send from. Twilio requires that ALL sender IDS are verified. They will also NOT allow alpha numeric sender IDS on trial accounts.
Ensure that the status of the plugin is set to enabled and then click Save & Close.
Congratulations the Twilio plugin is now configured and clients will receive SMS messages based on the event settings that you defined.
You can edit the SMS messages that are sent to clients by clicking the SMS Templates menu item on the dashboard. This uses the same place holders as defined in the emails and is the customfield variable name enclosed in |* characters.