AMPLUS Forms

This is a connector for sending text messages via Twilio that include content from a completed form.

Before you add a Connector, you must have a Twilio account and ensure that you have a valid Twilio Connection set up on your organization.

Adding your Twilio Connection

To add the connection to the web dashboard, navigate to Connected Data > Connections and click on the option for Twilio.

The screen will refresh and the Twilio connector will be seen. The following information from the account will then be needed to set up the connection:

1. Account SID
2. Auth Token
3. Phone Number

The first two items can be found on your Twilio dashboard. Sign into Twilio and find this information on the dashboard:

Click the Copy icon on the far right of each field to quickly copy each item and then paste it into the two corresponding fields on the connector, along with the phone number used in the third field.

Adding a Twilio Connector to your Form

Once the connection for Twilio has been set up, navigate to the Connect page of the form on which you wish to use the Twilio connector and click "ADD CONNECTOR" in the upper-right corner. Then, just like with adding the Connection earlier, click the Twilio option from the list.

Once the connector has been added to the form, enter the following information into the fields:

1. To Number(s): these numbers will be the recipients of the form output when the form connector fires. Multiple numbers should be separated with commas, and numbers should be formatted as 10-digit integers only (e.g., no "+" symbols or otherwise). See the link included in the tooltip (to the right of the field name) for more details.
   
   
2. Message Body: this will be the content of the message sent by the connector. As with other connectors, you may include data name placeholders to include data captured by the form.
   
   Please note that there is a 160-character limit for the message body. For this reason, we would recommend calculating the total limit, factoring in the characters included in the Twilio response, to ensure your message is short enough to fit without being truncated automatically. To do this, try sending a blank form submission to see how many characters is included without any content; e.g., 38 characters alone are used in the message "Sent from your Twilio trial account." Subtract this from 160 and plan your message accordingly, allocating some flexibility for varying string lengths depending on any user data captured.
   
   
3. To Form Field: choose a form field from this drop-down that has a phone number that will be the recipient of the text message. As with the "To Numbers" field, there can be one or multiple numbers.
   
   Please note that for the connector to be successful, this number must be a complete phone number with country and area codes. For this reason, it's highly recommended to use custom validation to enforce the proper format for the message to be successfully sent and received. A RegEx expression like this in the Custom Validation property of a numeric or text field would be recommended:
   
   REGEX(., '\d{11,12}$')
   
   This will ensure that an 11- to 12-digit number is entered before the user is allowed to continue. Of course, this can be changed to fit the specific format of phone number in a given country/region.