SMS channel
A short message service (SMS) channel communicates with the respondent's mobile device to send and receive short messages. When companies send messages to respondents, the messages appear from the telephone number or code associated with the channel. Respondents can establish the initial connection to a channel by sending a text message to the channel's Phone Number. This process is the respondent's opt-in action, and it begins the initial Conversation.
Medallia Conversations sends messages to the respondent via a service provider, which is typically Twilio. When using Twilio the phone number can be automatically provided by Medallia, or can be one provided by the client. The number can be a long code phone number, a short code (such as 12345), or an alphanumeric code (such as ACME). Contact your Medallia expert for more information.
Creating an SMS channel
-
Open the Channels list: click the Channels tab.
-
Click New Channel.
-
In the Add Channel panel, select:
-
SMS
-
-
Provide:
-
Name — descriptive name of the channel.
-
Description — a description of the channel, including its purpose and the name of the channel it is targeting.
-
-
Select the service (at the bottom of the dialog). To use the Medallia Twilio account, chose
Auto; otherwise, to the Company's Twilio account, chooseTwilio.Important: Once you click Save, the Service option cannot be changed. Verify your choice before continuing. -
Click Save.
-
Click the channel you just created to reopen it.
-
Make note of the phone number automatically generated by the system. Respondents will need to send a text message to this number to subscribe to the channel.
SMS properties
- Channel type
- Choose SMS when creating the channel; you cannot change this after saving the channel.
- Channel name
- (required) Unique name of the channel. For usability, make the name descriptive and include the category in the name to differentiate the channel from similar channels.
For example, here are two channels for Orion Retail: one for SMS and one for Facebook:
- Channel description
- Text description of the purpose of the channel. Mention any restrictions like blackout dates and availability windows.
- Channel ID
- Unique identification code assigned to this channel by the system.
- Status
- Whether or not the channel is active (enabled to process conversations) or not.
- Types
- Types of connections available to this channel.
- Availability windows
-
Availability windows identify when the channel is available to send feed-based invitations. Use the availability windows to pause the channel during times when people might not be receptive to the invitation, such as on weekends or at night. Note, this does not affect feedless surveys, which can be taken at any time.
The day and time are based on the respondent's timezone, as specified in the timezone information included in the raw invitation provided by the company, and processed by the import specification. See Import specifications for details about the import process.
When a window opens, messages are sent at random times within the next hour; they do not all go at at the opening of the window.
Important: Select a window that is greater than 1 hour/60 minutes. Selecting a window that is less than 1 hour can cause invitations to be sent during the restricted window.Tip: Use availability windows for channels that contact or push the conversation to respondents. For passive channels — like web pages or social media — use them as needed by your company.This example disables the channel on weekends, and between the hours of 7:00 p.m. and 9:00 a.m.
- Blackout dates
-
Blackout dates are specific days of a year when the channel does not send feed-based invitations. Use the dates to pause invitations to the channel on days when respondents might not be receptive, such as holidays. Messages scheduled to be sent on blackout dates are sent after the blackout expires. Note, this does not affect feedless surveys, which can be taken at any time.
Tip: Use availability windows for channels that contact or push the conversation to respondents. For passive channels — like web pages or social media — use them as needed by your company.This example disables the channel on the U.S. holidays of the Fourth of July and Thanksgiving in 2018.
- Opt-out keywords
- Words or phrases respondents may send requesting their intention to opt-out of receiving future conversations from the company, on all channels. After receiving the opt-out instruction, the channel sends a message to the respondent acknowledging the request.Note: A channel must have at least one opt-out keyword. The default keyword is 'stop'.
Each entry may be a single word, such as 'stop', or a multi-word phrase such as 'opt me out'. The text is case-insensitive: 'stop', 'STOP', and 'Stop' are all recognized when the word is 'stop'.
- Opt-out message
- Text message to send to the respondent after the channel receives an Opt-out keyword from the respondent.
- Service
- The service providing SMS access to the channel. Select the service when creating the channel. Once chosen and saved, this property become read-only and cannot be changed. The services are:
- Auto — Use the Medallia Twilio account.
- Twilio — Use the Company's Twilio account
- Phone number
- Respondents send a text message to this number to subscribe to the channel.
Default Conversation Throttle
The conversation throttle limits how many Default conversation messages, for a specific Conversation, can be sent to the same recipient within a time window. This prevents infinite "ping-pong" loops with auto-responders or answering machines, thereby reducing accidental spam, controlling costs, and protecting customer trust.
For example, by default Medallia Conversations sends no more than 3 Default Conversations to the same recipient with a 90-second time period. Instead of making a 4th attempt, the recipient is blocked for 24 hours from receiving a Default Conversation. After 24 hours, Medallia Conversations again tries to send default Conversations to the recipient.
To view a list of the blocked recipients, see Blocked Records.
- Maximum number of Default Conversations
- Maximum number of Default Conversations (unrecognized or fallback replies) that can be sent to a recipient within the configured Time Window. Once this limit is reached, no further default replies are sent to that recipient until the Reset Time expires.
Min: 1; max 10,000; default: 3.
- Time window (seconds)
- The time period during which the system counts the number of Default Conversations sent. If the threshold is reached within this period, the recipient is temporarily blocked from receiving additional default conversations until the Reset Time elapses.
Min: 0.0036 seconds; max: 86,400 seconds (24 hours); default: 90 seconds.
- Reset time (hours)
- How long a recipient remains blocked from receiving default messages after exceeding the Default Conversations Threshold within the Time window. The counter resets at the end of this period, allowing the recipient to receive default replies again.
Min: 0.0167 hours (1 min); 720 hours (30 days); default: 24 hours.
Channel settings
Channel settings are advanced, custom channel configuration options. Each setting is a key/value pair.
Advanced channel configurations
These are the available advanced settings.
| Channel setting | Channel | Description |
|---|---|---|
| MAX_MESSAGE_LENGTH | Custom and Facebook | Maximum length of a message before splitting it into multiple messages. A split message appears as two (or more) messages in the channel display. By default, the message is split when there are more than 320 characters. Change this setting to increase the limit up to 1024 characters. |
| SPREAD_SCHEDULE_TIME_WINDOW_IN_MINUTES | ||
| All channel types except WebChat. | Instead of immediately sending all invitations, randomly send them all during the count of minutes specified by the value, such as 10 minutes. | |
| ENABLE_USER_SYNC | Slack (only) | Set to true to sync the user info from the Slack workspace. This helps trigger surveys by user email when the Slack user ID is not known. |
