Messages

From Mission Manager Wiki
Jump to: navigation, search

(Related topics: Responses, Bounced Emails, Messaging FAQ)
The Messages tab provides the ability for a Mission Manager (MM) user to issue various types of messages to their team members, either via SMS Text, Email, or Phone Call (via optional fee based Twilio service) or all three at the same time. Individual users can be selected or groups of users may be selected. A confirmation message is displayed before sending which shows the type of message being sent and the number of members to receive the message.
Help MessagesNew.png

Function and Use of the “Request Response” Button

Mission Manager has a 'Response' feature whereby members can indicate their callout status (Attending, Not Attending, Maybe Attending, and On Scene). Using the “Request Response” Button on the Messages tab, will speed up the Request and Response time, and additionally allows the inclusion of a message related to the response.

When the “Request Response” button is pressed, the selected group of users from the left side of the Messages page will be sent a unique SMS text message with an embedded link in the message that, when clicked, will connect the receiving party to a “Mini Response” web page asking for their callout status.

Select one of the four choices “Attending”, “Not Attending”, “Maybe Attending” or “On Scene”, and optionally include a 100 character message in the “Notes” field. This message and the response status will be transferred to the “Responses” area under the “Messages” tab.

Depending on your smartphone screen size, you may have to pinch zoom into the Mini Response page. After your response is submitted you may have to adjust your screen resolution outwards to be able to see the ‘success’ message.

Important Note: When you use the ‘Request Response’ Button, any text that has been input previously in the “Message field” in MM is not included in this unique “Request Response” message.

The link format that MM sends is pre-configured and cannot be changed. The link will look different depending on your phone type and carrier, but will be similar to:

Update Response Status @ http://www.missionmanager.net/R.php?id=NNNNNN

Do not reply to the incoming Request Response directly, as it will not be sent back to MM. Use the provided link to update your status.


SMS Sending Methodology and Limits

Mission Manager users can choose one of two methods to send SMS messages via a choice in the Messaging section of the Configuration screen. The first uses the free email-to-text gateway that most phone carriers allow, which is sent via email to the formatted address of mobile_number@phone_carrier.com (for example 6195551212@vtext.com for a Verizon customer). Though free to use, that method comes with issues such as bounced emails, absorption as spam, etc. The member must have a properly formatted SMS email address input into the SMS Address field on their Member record for that system to work. Users can input more than one SMS email address in that field separated by commas.

The second method is a true native text message sent via an optional fee based system through Twilio. The fee billed to the customer by Twilio is currently $0.0075 cents per 160 character message segment per receiving phone. For that system to work, the member needs to have a valid mobile phone number inserted into the Cell Phone field of their Member record. Only one phone number is allowed in that Cell Phone field.

For either SMS sending scheme, knowing the message length is important. Using the free email-to-text gateway can be problematic as some phone carriers truncate messages at 160 characters, while others don't. If you choose to use the fee based native texts via Twilio, they charge based on each 160 character segment per receiving phone.

Therefore, in the upper portion of the Messages tab you'll see a Character Counter, useful for being mindful of texting limits or possibly being billed for multiple segments. The Character Counter takes into account the length of the sender’s name and phone number, which is sent with the text message. For the email-to-text gateway method, the counter box will turn red when the SMS message length limit has been exceeded. Upon pressing the send button, a warning message will be displayed to the sender that the message may be truncated by some cellular providers (see image below) and your member may miss important information. However a user may exceed the SMS character limit and the system will allow it. The fee based native text option via Twilio has a 1500 character limit. A 1500 character message would be billed as 10 segments or 7.5 cents per receiving phone.

Help SMSWarning.PNG

Email messages are not subject to the same limits as text messages.

How messages are sent, return addresses and phone numbers, and other message settings can be configured in the Configuration screen.

Mission Manager can be interfaced with a fee based system through Twilio for a phone message line for callout messages and can be used to make phone calls to your members. See the Configuration and Message Line Set Up screens for more information about setting up these features.

The Show Only check boxes allow you to specifically filter the member list based on member qualifications. The Dropdown box at the end of this list allows you to specify if the members must match all of the checked boxes, or the other option is any of the checked boxes. The Show Only list can be customized in the Configuration screen.

The Message History button will show the history of messages sent. The range of the history can be selected in the dropdown range. Only system administrators have access to this feature.

The Responses button will take you to the Responses screen that will show member responses to missions or messages. When on the Responses screen, press the Send Message button to return to the Messages screen.

The team Standard Messages can be configured in the Email Settings section of Configuration.

Note: All messaging sent while in a Mission will be entered into that Mission's Event Log.

Sending Address Format
For Emails and email-to-text gateway SMS texts, the sending address used by MM looks like Notifications <MMFRXXXX_YYYYT@missionmanager.net>. MMFR stands for Mission Manager First Responder. XXXX_YYYY is a unique identifier specific to the user and their team and will always remain the same. The T indicates the message sent was a Text message. If the T has been replaced with an E, it indicates the message sent was an Email.

Replying to Received MM SMS Messages
When sending an SMS message, the sender’s telephone number will be included in the message so that the receiving party can now click on the sender’s number to start a private person-to-person SMS session. The incoming SMS message from within Mission Manager and from an MM user named ‘Eric Mountain’ will vary depending on your phone carrier, but is reasonably similar to:

"Eric Mountain +1 6195551212: Command Post at 1554 Main St" (where the “Command Post at 1554 Main St” represents the SMS text message content.)

To begin a private SMS text message session with the sender, on Android tap on the phone number link in the body of the SMS text message. For iPhone long press on the phone number link. Do not reply to the MMFRXXXX_YYYYT@missionmanager.net message address. If you do, the reply will not reach the sender. Once you have connected via SMS text with the sender, you can continue to text as you normally would.

Important Note: If the MM user sending the message does not have a cell phone entered in their member record, the message to their team will look something like:

"Eric Mountain +1 Command Post: 1554 Main St"
This message CANNOT be replied to due to missing phone number information after the +1.

Replying to Received MM Email Messages
When sending an Email message, the sender’s Email address will be included in the body of the Email message, so that the receiving party can now click on the sender’s Email address allowing them to start a private person-to-person Email session with the sender. The incoming Email message from within Mission Manager and from an MM user named ‘Eric Mountain’ will be similar to:

"From Eric Mountain <emountain23@gmail.com>"
Command Post: 1554 Main St (where the “Command Post: 1554 Main St” represents the Email message content.)

To begin a private Email message session with the sender, click on the Email address link in the body of the message. Do not reply to the MMFRXXXX_YYYYT@missionmanager.net message address. If you do, the reply will not reach the sender because the original Email came from within MM. Once you have connected via Email with the sender, you can continue to Email as you normally would.

The following is a video tutorial of the Messages Screen:

You Tube- Mission Manager Messages