Connect Twilio to send auth links by SMS

With a Twilio credential linked, the Send message panel on an auth link offers SMS. Without one it shows "SMS - Twilio integration required". The page says Twilio is used for forms that have auth links, which need a Geosearch subscription.

You are responsible for the Twilio account, the sender ID and the phone numbers. Formpiece cannot guarantee that a text is delivered when the Twilio account is set up wrongly.

Before you start

Create the Twilio credential under Integration Credentials. When the account has no Twilio credential, the button on this page is greyed out.

Step by step

  1. Click Settings in the Simpro Bookings menu, then Twilio under Auth.
  2. Pick the credential in Twilio Credential. Its three values fill in.
  3. Check Twilio API Account SID (it starts with AC), Twilio API Key SID and API Key Secret / Auth Token.
  4. Click Update Twilio credentials. The page shows "Twilio credentials updated".

If you use an API key, create it in the US region in Twilio. If you use the account auth token instead, put the Account SID in Twilio API Key SID as well and the auth token in API Key Secret / Auth Token. The page says the Key SID can be the same as the Account SID when you are not using an API key.

With a credential selected, the Key SID and secret are both required, and the button stays greyed out until both are filled in. The three values are saved on the credential, so editing them here changes the credential everywhere it is used.

To unlink Twilio, clear the dropdown with its cross, leave the Key SID and secret empty and click Update Twilio credential. The Twilio API Account SID box is always required, so the browser stops the click while it is empty. If you fill in the Key SID and secret with nothing selected, a new credential called "Twilio integration for Simpro Bookings" is created and linked.

When it goes wrong

There are two causes. No Twilio credential is linked here, or the contact has no phone number in Simpro. The radio shows "SMS - not available" in the second case.

The Update button is greyed out

Either the account has no Twilio credential, or a credential is selected and the Key SID or secret is empty.

A text does not arrive

Formpiece does not test the credential from this page. Check the sender ID, the number format and the region of the API key in Twilio.