What would you like to know more about?

Show Page Sections

Send a Text

Important: Text messages are a great way to communicate, but proceed with caution when sending bulk text messages – nobody likes spam! Keep texts relevant to your audience, let people know they can opt out, and honor those opt-out requests. We recommend you ask your audience to opt-in before you send your first bulk text message.
  1. Launch the New Message Tool:
    • If you want to search for each individual to select as a recipient, go to your Home page, and click the My Messages tab.
    • If you want to select a group of people as recipients, go to the relevant page, and make your selection. Then, from the Actions menu, select Message.
    The New Message Tool opens.
Prepare your text:
  1. For Message Type, select Text Message.
    Note: If your system is not configured to send text messages through Twilio, you won't see the message type options. You will only be able to send an email.
  2. If you haven't already selected your recipients, you can enter each person's name or click the magnifying glass icon to search for and select individuals. See Message Recipients for additional options.
  3. Click the Recipients drop-down list to review your options.
  4. To send the message to the the parents of the selected recipients (that is, any Head of Household who has a valid email address and is not inactive/deceased as well as any Non-Custodial Parent associated via Other Households), select Send to Parents.
  5. Enter the content of your message. This is required to send the message. For details, see Text - Message Tab.
    • Click the Insert menu to include any templates or fields.
    • Keep an eye on the number of characters you have remaining for your message.
  6. If needed, click the Attachments tab to upload files to attach to your message. For details, see Text - Attachments Tab.
Review your text:
  1. Read over your message content, and review the estimated number of texting segments this message will create.
  2. To change the "Sending from" phone number, click the Advanced tab and select a number in the From SMS Number drop-down list. For details, see Text - Advanced Tab.
  3. If you need to save your message so you can return to it later, click Send then Save As Draft.
    The draft is saved under the My Drafts view on the My Messages tab of your Home page.
Send your text:
  1. To schedule your message to send at a later time, click the Advanced tab and enter the date and time for Schedule Send.
    Tip: This is useful if you have a large message or bulk messages that you want to send during non-peak hours. For more information on why this is important, see Manage Message Size.
  2. To send a copy of the message to yourself for review before sending it to your recipients, click Send then Send To Me.
    You'll receive a copy of the message. If you included any merge fields, they will be rendered using the first recipient's information. Files added as Attachments are included, but files added as Links are not.
  3. When you're ready to send the message to the selected recipients, click Send then Send.

The message sends within about five minutes after you click Send unless you scheduled it to send in the future.

Want to see who actually received your message? Go to Communications > Messages and check out the Action Status.

Did you get an error when sending your message? Check out our troubleshooting topic for help.

Note: Replies: If you send a text message using the New Message Tool and a recipient replies to it, Twilio logs the reply. By default, it does not record in MinistryPlatform. However, you can set up a webhook on the Twilio side to send any replies to the Platform for easy reference. This only logs the incoming message. Also, no automatic response message sends to the recipient if they reply to your text message.

You can work with Twilio to update the auto-response sent to people who respond to texts sent through the New Message Tool. You can also work with a third party to create a custom web service for something more custom, like forward the message onto another number or auto-respond based on various criteria. For more on auto-responses, see the Twilio article, Set up an SMS Auto-Responder with TwilioStudio. Reach out to Twilio Support for assistance!

Text - Message Tab

Define what you want to say in your text message.

Your Message tab will look different depending on what the Texting Compliance Level is set to on the Outbound SMS Number record you're using.

Texting Compliance set to NoneTexting Compliance set to Single or Double Opt-In
New Message Tool with Message Type selected as Text Message showing all options available for texts when a texting opt-in process is not set upNew Message Tool with Message Type selected as Text Message showing all options available for texts when a texting opt-in process is set up
1 - Message Type
Select how you want to send your message, either by email or text. The "Sending from" number displays based on the From SMS Number you select on the Advanced tab.
2 - Selected record group
If launched from a selection, the selected records group displays here. You can click the search icon to select additional records. Each individual receives a unique email and can't see who else received the same message.
3 - Recipients
This list displays records related to views for sub-pages associated with the selected page. The selected view applies to the selection so you can further filter the records you send to. For more information, see Message Recipients.
4 - Send to Parents
Select this checkbox to send the message to the parents of the recipients. A "parent" is any active (not deceased) household member with Household Position of Head of Household and a valid email address AND mobile phone number. It also includes any Head of Household associated through Other Households with a Household Type of "Non-Custodial Parent", unless the relationship is end-dated. If the selected recipient is a Head of Household, they will not receive the email, nor will the other Head in their Household.
Note: If the parent opted out of receiving bulk emails, won't receive the message. To include them, select the Include recipients who have opted out of bulk email option on the Advanced tab.
5 - Sender
If you're using a texting opt-in process (that is, your Texting Compliance Level for the SMS number is either Single Opt-In or Double Opt-In), the Sender prepends every text message sent from the SMS number. This helps recipients recognize which church, department, group, or other entity sent the message. The wording comes from the Sender Label on the Outbound SMS Number record.
6 - Insert Menu
Templates:

Select a template as a starting place for your message. This list is organized based on the template's Pertains to page and the page you selected your recipient list from. Any edits you make to a template in the New Message Tool only apply to this specific message and do not update the Template record. Users with at least Read level permissions on the Templates page can use templates. Users can see templates they can access based on the Template User and Template User Group fields on the Template record. For more information on using templates, see Templates.

Fields:

We do not recommend using merge fields in text messages because it causes every text to be a different length. This could affect the appearance and cost to send your texts. But, if needed, you can include different types of merge fields in your message.
  • With Contact Fields, you can personalize your message for the recipient. For example, the [Nickname] field automatically adds the recipient's nickname to the message.
  • The From User Fields are like Contact Fields but they merge in values related to the sender (the current authenticated user or delegated user) rather than recipient. For example, the [From_User_Nickname] field automatically adds the sender's nickname.
  • With Data Fields, you can add page-specific data to a message.

For more information on using these fields, see Contact, From User, & Data Fields.

7 - Estimated Texting Segments
Displays the estimated number of texting segments that your current message will create. This is just an estimate and may not represent the actual number of segments once the text is sent. As soon as you insert a merge field, this text turns red to indicate that the estimate does not include merge field values. This estimated value is not stored in the Platform after the text message is sent.
Every text is limited to a certain number of characters. If you message is longer than the limit, it creates a new segment. Segments are billed separately by phone carriers, so keep your message as concise as possible. Use of special characters, emojis, and merge fields will reduce the character limit per segment. This estimate does not consider any characters that are rendered for merge fields. So, if you add a merge field, note that this estimate may be lower than the actual number of segments.
Note: Looking for more about segments? See these Twilio articles on what a segment is and how much it costs.
8 - Character count
Text messages sent through the New Message Tool have a limit of 500 characters for message body. (Your organization may limit texts to even fewer characters, so check with an administrator if you're not sure. And remember that Twilio bills per segment.) The character count indicates how many characters you've used. Wondering why you only get a certain number of characters per segment?
  • It is industry standard and best practice.
  • It respects your recipients.
  • It reduces the likelihood of your mass texts being flagged as spam.
  • It increases the processing rate and speed at which Twilio can deliver your texts.
  • It saves you money. Math says that one segment x 5,000 texts is half the cost of two segments x 5,000 texts — that adds up fast! See the "Texting Segments" section on the Twilio integration page to learn more.
  • It forces you to be brief and to the point. Think tweet, not blog!

Need more room to fully express your message? Get creative, use abbreviations, drop the formal greetings and salutations, and create a short link to direct recipients to more information. If your message still doesn't fit, the Email option is just a toggle away!

9 - Recipients Opted In
You may see a note at the bottom of your Text Message window that shows how many recipients have opted in to receive text messages. If you're using a texting opt-in process, you can only send to people who have opted in.
10 - Send / Save
Hover over the Send button to see the Save as Draft, Send to Me, and Send options. You can save a message as a draft at any time. Once complete, you can send a message.
Note: If the message doesn't contain any Contact Fields or Data Fields, the system automatically removes duplicate texts. For example, if a husband and wife have the same mobile phone number in each of their Contact records and both of their records are in the selection, one text would sends to that number. (The system calculates the Send count before removing duplicates.)

To receive a copy of the message to review before you send it to all your recipients, select Send to Me. If you included merge fields, they use the first recipient's information, and attached files are also included. This gives you an accurate preview of what you're about to send.

Note: Replies: If you send a text message using the New Message Tool and a recipient replies to it, Twilio logs the reply. By default, it does not record in MinistryPlatform. However, you can set up a webhook on the Twilio side to send any replies to the Platform for easy reference. This only logs the incoming message.

Also, no automatic response message sends to the recipient if they reply to your text message. You may configure Twilio to automatically send responses to incoming text messages. Review their documentation or reach out to Twilio Support for assistance.

Text - Attachments Tab

Add files to send with your text message.

Attachments tab of the New Message Tool showing examples of files uploaded and added as attachments

Did you know you can add attachments to a text? You can if you use the New Message Tool to send them! On the Attached Files tab of the New Message Tool, you can attach, open, and remove file attachments. MinistryPlatform allows files up to 20MB in size and accepts most standard file formats, such as PNG, JPG, BMP, GID, GIF, PDF, TXT, and CSV. We do not recommend you attach TIFF files. You can attach encrypted PDF files. You can attach fillable PDF files, but values don't display unless the viewer downloads the file.

When attaching, you can:
  • Add as a Link.
  • Add as a Attachment.

If you have multiple attachments, you can even mix and match! When you add at least one attachment, a current count of attachments displays in the badge icon on the Attached Files tab. This icon also displays a count the template you selected contains attachments.

Text - Advanced Tab

Manage details of your text message or schedule it for later.

Advanced tab showing options for From SMS Number, Schedule Send, and Override Texting Opt-Out

1 - From SMS Number
Indicates which Outbound SMS Number the text message sends from and which Sender Label prepends each text. This is the default number set on the Outbound SMS Numbers page. If you configured multiple numbers, the From SMS Number drop-down list includes additional numbers. Users can send from Outbound SMS numbers associated with a user group they are in.
2 - Schedule Send
Schedule the message to send at a future date or time according to the authenticated user's timezone. If the user's value isn't set, the system uses the Domain timezone. You can schedule messages to send within the next six months, based on the Message Archival schedule. For steps, see Schedule a Message.
3 - Override Texting Opt-Out
If necessary, users who have permission (via the Texting Override field on their security role) can select this checkbox to include recipients who have opted out of receiving text messages. By default, this option is cleared and doesn't include these recipients.
CAUTION: This feature should only be used in emergency situations where it's critical to get information to people quickly via text message, including those who have asked not to be texted.