Twilio
With Twilio, you can send and receive messages at scale using Messaging APIs. This makes it the perfect integration to send SMS messages from MinistryPlatform directly to your congregation! You can also view inbound text replies. With a one-time configuration, you'll be good to go.
Cost
There is no charge from ACS Technologies for configuring the integration.
Fees from Twilio will be assessed as per each church's individual contract agreement. See Twilio's SMS Pricing page. Pricing is based on your usage, with discounts for committed usage as you scale. Be sure to ask about Twilio's not-for-profit pricing!
Messaging Options
We usually recommend churches use toll-free numbers in Twilio, which are reliably received by cell phone carriers and send faster. However, you should choose the messaging option that best fits your needs. See this Twilio article to learn the differences between messaging options.
Texting Segments
Segments can determine what your texts look like and how much you pay to send them.
Every text message is limited to a certain number of characters. And that limit is called a segment. If your message is longer than the limit, it creates a new segment. Sending a really wordy text? Your long text will still send, just with more segments. Note that you pay by the segment.
How many characters do you get per text? That depends on the following:
- Traditionally, 160 characters.
- If you use emojis, 70 characters.
- And certain accented characters, non-standard spacing, smart quotes, and reassembly headers are more complex to encode and can further reduce the number of available characters available per segment.
For more information, see this Twilio article.
See Also
- Milestones For Onboarding your SMS Project to Twilio
- CTIA's Messaging Principles and Best Practices - If you send A2P messages, please read and understand how the guidelines affect you.
- Twilio Website
Integration Setup
A SPoC can complete this one-time initial setup with Twilio to enable text messages from MinistryPlatform.
- An account with Twilio must be established before the integration can be configured.
- Make sure you've completed Milestones 1 through 4 of the Twilio Onboarding process.
Once you enable your Twilio integration, you can send text messages from the Platform using the New Message Tool!
Add a Webhook for Inbound Messages
Add a webhook to allow inbound texts from your Twilio account to display in the Platform.
- A Twilio account must be configured. Fees apply for inbound messages.
From your Twilio account, you can configure a messaging webhook for each active phone number. This optional feature is only for informational purposes. You can see replies coming back from text messages sent by the Platform, but you cannot respond to their reply. It is not a two-way texting feature.
- Time received
- Message To number
- Message From number
- Message Text, up to 1,600 characters – the Twilio limit
- Emojis are accepted (but do affect cost)
- Images and GIFs (display as files attached to the Inbound Message record)Note: Images can be received with or without text.
Tips and Tricks
If you are not receiving texts sent by the New Message tool, double-check each of the setup steps and values to ensure no details were missed. If you're still not receiving texts (and the tool is not giving an error or warning), the issue is most likely with your Twilio account. See these troubleshooting articles from Twilio: Basic and Advanced.
Carriers may automatically block messages that are not in compliance with the Telephone Consumer Protection Act (TCPA) guidelines. Be aware of your content, especially if it contains a clickable link. Avoid wording like "Click this link" and bit.ly links. Ensure your message has a footer with instructions for opting out. For more information on the TCPA, these articles may be helpful: TCPA Compliance and Telephone Consumer Protection Act of 1991.
Sending links in your text message will likely get your text message filtered and blocked.
The New Message Tool supports the use of multiple Twilio numbers, so add as many numbers as your church or diocese needs! A benefit of having multiple numbers is that it allows you to spread your text volume over multiple numbers, improving the speed and deliverability of your text messages.
The phone number used with these tools should be different from other numbers used with third party applications (for example, OnlineGiving.Org's text-to-give). If you already have a Twilio account in use by a third party, you may need to purchase additional numbers to use with these tools. Contact your third party vendor for specific requirements.
Twilio throttles things, so getting a Short Code can help to speed up processing time. Short codes have an 8- to 12-week provisioning time.
You can also get a toll-free number that's verified through Twilio to speed things up by up to three times faster. For more information from Twilio regarding processing time, see their Sending and Receiving Limitations on Calls and SMS Messages article. Toll free numbers are available in five to seven days.
Long codes are turned off by Sprint if they see 200+ of the same message in one day.
You can work with Twilio to update the auto-response sent to people who respond to texts sent via the New Message Tool. You can also work with a third party to create a custom web service that could do something more custom, like forward the message onto another number or auto-respond based on various criteria. For more on auto-responses, please see Twilio's article, Set up an SMS Auto-Responder with TwilioStudio. Reach out to Twilio Support for assistance!
Can I customize the message about opting in to texting that displays on the Sign Up screen?
If you use Twilio for texting, you may work with them to register your A2P (Application-to-Person) campaigns. Learn more with this article from Twilio, What is A2P 10DLC?.
To help with compliance, people who sign up for a MinistryPlatform user account will see a default opt-in message on the Sign Up screen. If needed, you can customize this wording by updating the Application Label for the MinistryPlatform Client: oauth.smsDataWarning.
Yes! Twilio offers special non-for-profit pricing; you just have to ask for it!