This use case shows how to create custom opt-out keywords.

Programs used

• Text to join: Use an existing text to join program. You will need to reference the program when you create the multi-step program.
• Multi-step: You will create a new multi-step program that will recognize the custom keyword and process the opt-out request.

Best practice is to use one custom keyword SMS opt-out multi-step program to one text to join program.

Note: If you want contacts to opt out of more than one text to join program via a single keyword, in the multi-step program add additional opt-out actions specifying another text to join program. Then contacts will be opted out of all specified programs when they submit the defined keyword.

Custom keywords

Custom keywords are defined as non-standard keywords, for example, DETENER, PAR, ESCALE, etc., and meet these requirements:

• Latin characters
• Unique
• Contains no spaces

Set up your program

1. Create a new multi-step program.
   1. Name: Provide a name that is easy for you to identify the program.
   2. Campaign: Choose the same campaign used in your text to join program.
   3. Code: Choose the same short or long code number that you configured for your text to join program.
   4. Keyword(s): Define your custom opt-out keyword.
   5. Session time out: Not applicable (N/A).
   6. Duration: This should be the same time span as your text to join program.
   7. Stop message and Help message: Not applicable (N/A).
2. Create opt-out and send SMS actions.
   1. Opt-out: Processes the opt-out request by re-directing the opt-out to a text to join program.
   2. Send SMS: Sends an SMS in response to the opt-out request.
3. Next to the input's keyword, click the arrow.
4. Click Output and configure the opt-out action.
   1. Action type: Choose Opt-out.
   2. Select program: Choose the text to join program that you want to associate to this program.
5. Click Add action.
6. Configure the Send SMS action to send mobile end-users an opt-out confirmation message:
   1. Action type: Choose Send SMS.
   2. Message type: Choose Standard SMS.
   3. Message body: Type the SMS message to confirm the opt-out.
7. Click OK and then Save program.

Note: If you are on a shared code and plan to use a non-English language word, to make the custom keyword unique and meaningful you may want to add identifying text, such as your text to join program name initials. For example 'cessare' is the Italian word for 'stop'. In this example, a custom keyword may be 'cessareu1'.