Next File Manager 6.1.0: share links, Trash, a phone app and a Health check Next Exams 6.3.0: exam parts, scaled scores, listening and speaking tests Next Restaurant 6.1.0: move your data in, run payroll, and connect other systems Next Inventory 6.2.0: a REST API and webhooks for your other systems Next DB 6.1: Auto-Updating Tables, Printing, Phone Layout and SEO Next Task 6.0.0: a task manager for Joomla
NextSoftware

Twilio

Sends the text messages of your automations through your Twilio account: arrival reminders, door codes, thank-you messages and anything else an automation's Text message (SMS) action sends.


How it works

  1. An automation's SMS action fires for a booking and puts the text in the outbox.
  2. The Send queued emails task (every 5 minutes) sends it through the SMS profile chosen in the action's Send through, or the default profile.
  3. Twilio accepts the message and returns its id (SM...). A failure that may pass later (a timeout, Twilio busy) is tried again; one no retry can fix (a wrong number, a bad sender, the guest replied STOP) is not.

Texts longer than 1600 characters are cut at 1600, Twilio's limit.


Setting it up

1. Switch on SMS

The SMS app is off on a new install. Open Configure > Apps and switch on SMS, and check that the Twilio app is on. Configure > SMS gateways then appears in the menu.

2. Get your Twilio details

In the Twilio Console, under Account info, copy the Account SID (starts with AC) and the Auth Token. Buy or choose a phone number that can send SMS to your guests' countries, or set up a Messaging Service.

3. Add the profile

On Configure > SMS gateways, click Add profile, choose Twilio as the Provider and give the profile a title only staff see, for example "Twilio UK". Then fill in:

Field Value
Account SID Twilio Console > Account info. Starts with AC
Auth token Twilio Console > Account info. Never written to a log or kept in an error message
Sender Your Twilio number in international format (+447700900123), a Messaging Service SID (MG followed by 32 characters) to let Twilio pick the number, or a sender name of up to 11 letters and digits where your guests' countries allow one
Test mode On: nothing is sent and nothing is charged. Each message is written to the Joomla log, credentials hidden, and counted as sent

Publish the profile and save.

4. Make it the default

Click Make default on the profile. The default profile sends every text that has no other profile chosen. Without a default, automations send no texts, and the page says so.

Set the Default country code on the same page (for example +44). It is added to numbers typed without one, and a leading 0 is dropped.


Test it

  1. Open the profile, type your own mobile number under Phone number and click Send test SMS. It uses the details in the form, saved or not.
  2. With Test mode on, the answer is "Test mode is on: nothing was sent." and the message is in the Joomla log. With test mode off you get "Twilio accepted the message (SM...)" and the text on your phone.
  3. Add an automation with a Text message (SMS) action and use its Test button on a booking to see what would be sent.

A Twilio trial account sends only to numbers you have verified at Twilio.


Several profiles

You can add more Twilio profiles, for example one per sending country or one per brand. In an automation's SMS action, Send through picks the profile; empty uses the default. A profile that is switched off falls back to the default.


Troubleshooting

Symptom Cause and fix
No texts at all The SMS app is off, no profile is the default, or the default profile is unpublished
Texts counted as sent but nobody gets them Test mode is on
"Enter the phone number in international format" The test number needs a country code: +447700900123
Twilio refuses with an authentication error The Account SID and Auth token do not belong together, or the token was rotated
Twilio refuses the sender The number cannot send SMS, the Messaging Service SID is wrong, or the guest's country does not allow sender names
One guest never gets texts Their number is not a mobile, or they replied STOP to your Twilio number
Texts arrive late Texts are sent by the Send queued emails task. Check that Joomla's scheduled tasks run

See also

All Extensions