Table of contents
No headers
(Click the banner to go to the related Docs.Code.ExactTarget.com page.)
After you complete this procedure, you can receive and process MO messages.
Use the following steps to define the system response to incoming SMS messages from customers:
- Click the Interactions navigation tab.
- Click Messages.
- Click SMS.
- Click MO Keywords. The SMS MO Keyword Definitions workspace appears.
- Click the Create button on the toolbar. The New SMS MO Keyword Definition screen appears.
- Complete the information in the Properties section:
- Name - The name of the keyword definition. You use the name to identify the keyword definition within the application. For example, you use the name you enter in this field to identify the keyword in the Next Keyword field of a different keyword definition.
- Verbs - The verbs associated with this keyword. If these words appear first in the text message (after the Shared Keyword, if applicable), the system processes the message according to this definition. Note: If you use the same word for your Shared Keyword and your MO keyword, the subscriber only needs to enter it once in the incoming message. For example, if your shared keyword is "MOVIE" and you create an MO keyword of "MOVIE", the system will direct the message to your account and process the message according to this MO keyword definition.
- Next Keyword - The next keyword the system can expect in this conversation.
- Select an action type. The value you enter in this field determines the fields you complete in the Action Settings section. Valid values include:
- Check Vote Count - Returns the current vote count for an SMS poll to the requesting user. The user can specify a voting category to check. For example, "check Apples". If they do not specify a category, they will receive the tally for the top three voting categories.
- Create a HELP Keyword - Creates an MO keyword users can send to receive assistance with their mobile message experience.
- Join Email List - Adds the user's e-mail address to a mailing list. The user might specify a mailing list, for example "ejoin TestList me@example.com", or the user might just send their e-mail and be joined to a default list, for example "ejoin me@example.com".
- Join SMS Publication - Adds a subscriber to a SMS Publication. This action includes double opt-in support as well as single opt-in support.
- Send email to user - Sends a triggered e-mail to the address sent by the user. This can be used for an e-mail double opt-in or just for informational purposes.
- Send SMS - Sends an SMS message to the subscriber.
- Unsubscribe from SMS publication - Unsubscribes the subscriber from an SMS publication list.
- Vote - Votes in a poll.
- Complete the Action Settings. The fields in this section depend on the action type you selected.
If you select Vote:
- Data Extension Name - The data extension that stores the votes for the poll.
- Generic Error Message - The default error message to send if an error occurs other than invalid category.
- Invalid Category Message - The error message to send if the MO message requests information on a poll option that isn't listed in the Valid Categories field.
- Valid Categories - The valid poll options the MO message can request.
- Vote Category Column - The column in the data extension that stores the category.
- Default List - The list to add the subscriber to if no list is named in the MO message. If you do not select a value in this field, you must complete the Mailing List Required message field.
- Generic Error Message - The default error message to send if an error occurs other than invalid mailing list.
- Invalid Mailing List Message - The error message to send if the MO message requests to be added to a mailing list that isn't defined in your account.
- Mailing List Required Message - The error message to send if the MO message does not name a mailing list. You only need to complete this field if you do not select a value in the Default List field.
- Success Message - The success message to send if the subscriber is added to a list.
- Default Publication - The publication list to add the subscriber to if no publication list is named in the MO message. If you do not select a value in this field, you must complete the Need Publication Message field.
- Invalid Publication Message - The error message to send if the MO message requests to be added to a publication list that isn't defined in your account.
- Need Publication Message - The error message to send if the MO message does not name a publication list. You only need to complete this field if you do not select a value in the Default Publication field.
- Prompt Message - The message to send to prompt the subscriber to confirm being added to the list. You need to complete this field to use double-opt in for your publication lists.
- Success Message - The message to send if the subscriber is added to the publication list.
- Unexpected Error Message - The default error message to send if an error occurs other than missing or invalid publication list.
- Valid Publications - The valid publication lists the MO message can request. If you do not select a value in this field, the MO message can contain any publication list.
- Valid Responses - A comma-delimited list of the responses that confirm double opt-in. The follow-up MO message must contain one of these responses for the subscriber to be added to the publication list if double opt-in is used.
- Failure Message - The message to send if the email send fails.
- Missing Email Message - The error message to send if no valid email address is named in the MO message.
- Success Message - The success message to send if the email is sent.
- Triggered Send Definition Customer Key - The external key value that identifies the triggered email interaction to send.
- Message - The text of the SMS message to send.
- Failure Message - The message to send if the voice message send fails.
- Success Message - The optional success message to send if the voice message is sent.
- Triggered Send Definition Customer Key - The external key value that identifies the triggered voice message interaction to send.
- All Unsub Success Message - The success message to send if the subscriber is unsubscribed from all publications.
- Invalid Publication Message - The error message to send if the publication list named in the MO message is not valid.
- Single Unsub Success Message - The success message to send if the subscriber is unsubscribed from one publication.
- Data Extension Name - The name of the data extension that stores the votes.
- Generic Error Message - The default error message to send if an error occurs other than invalid category or duplicate vote.
- Invalid Category message - The error message to send if the MO message names a category other than those in the Valid Categories field.
- Mobile Phone Column - The column in the data extension that contains the mobile phone number.
- Multi-Vote Error Message - The error message to send if the same mobile number votes more than once.
- Success Message - The success message to thank after a vote is recorded.
- Valid Categories - The valid categories that can be voted for.
- Vote Category Column - The column in the data extension that contains the votes.
- Click Save.
- If you wish to set an MO keyword as the default for your account, click the checkbox next to that keyword in the SMS screen and click the Set Default Keyword button. The application executes this keyword when it receives that MO keyword and when no other keyword applies to the MO message received. To clear the default keyword, click the Clear Default Keyword button.
If your normal workflow only adds subscribers to publication lists instead of data extensions, you can choose to use AMPscript to add information to a data extension. You can paste AMPscript into the success message of the field of the Send SMS interaction, using the sample below as a model:
%%[UpsertData("DataExtensionName",1,"SubscriberKey",MOBILE_NUMBER,"Phone",MOBILE_NUMBER)]%%Thank you for opting into our alerts. Approx 4msgs/mo, Msg&data rates may apply. Reply STOP to cancel, HELP for help.
You can also choose to send to a blank data extension and retain all subscriber information on the publication list. If you wish to later remove the subscriber from the data extension, you can use the following AMPscript:
%%[DeleteData("DataExtensionName","Phone",Mobile_Number)]%%
This page was last updated by Ryan Williams on Tue, 24 Jan 2012 13:22:05 GMT.
If you require assistance with the ExactTarget application, please contact Global Support. If you wish to send Ryan direct feedback, fill out the form below:
You are not logged in. Log in 
