Two-Way Messaging (Custom Keyword Responses)

Two-way messaging allows you to send messages and process the responses to those messages. It requires end users to send a keyword to Braze to which that user will receive an automatic reply. Applied correctly, two-way messaging can be a simple, immediate, and dynamic solution to customer marketing, saving time and resources along the way.

Managing Keywords and Auto Responses

SMS with Braze gives you the option to create keyword triggers, custom responses, define keyword sets for multiple languages, and establish custom keyword categories.

Add Keyword Triggers

In addition to the default opt-in and opt-out keywords listed above, you may also define your own keywords to trigger Opt-In, Opt-Out, and Help responses.

Home

  1. To define your own keywords, navigate to the SMS section of the dashboard located under Subscription Groups.

  2. Under SMS Global Keywords, select a keyword category to add a keyword to by selecting the pencil icon.

  3. In the dialogue box that pops up, add a keyword you would like to trigger this keyword category. Note that keywords are case sensitive, and universal keywords like START, YES, and UNSTOP cannot be changed. Please read the rules below that apply to keywords and keyword responses.

    picture
Keywords Keyword Responses
- Valid UTF8 encoded characters
- Maximum of 20 keywords per category total
- Maximum length of 34 characters
- Minimum length of 1 character
- Cannot contain spaces
- Required to be case insensitive and unique across the subscription group
- Cannot be blank
- Maximum length of 300 characters
- Valid UTF8 characters

Manage Responses

You are able to manage your own responses that get sent to users after they text in a keyword to a specific keyword category.

Home

  1. To manage your keyword responses, navigate to the SMS section of the dashboard located under Subscription Groups.

  2. Under SMS Global Keywords, select a keyword category to edit a response for by selecting the pencil icon.

  3. In the dialogue box that pops up, edit and save your response. Please be mindful of the Six Rules to get Compliance Right as you create your response and read the rules below that apply to keywords and keyword responses.

    Responses
Keywords Keyword Responses
- Valid UTF8 encoded characters
- Maximum of 20 keywords per category total
- Maximum length of 34 characters
- Minimum length of 1 character
- Cannot contain spaces
- Required to be case insensitive and unique across the subscription group
- Cannot be blank
- Maximum length of 300 characters
- Valid UTF8 characters

Multi-Language Support

When sending to certain countries, a sender may be required to support inbound keywords and outbound replies with a local language. To support this, Braze allows you to create a language-specific keyword setting.

picture To get started, click “Add A Language” and select your target language or search for a language within the dropdown.

Please note that other languages do NOT come with preset keywords/responses like English, so senders will need to work with their marketing and legal teams to add any required keywords to this set. Otherwise, Braze will not handle localized incoming messages for those languages. If you need to delete a language, click the “Delete Language” button at the bottom right.

picture

Custom Keyword Categories

In addition to the three default keyword categories (Opt-in, Opt-out, and Help), you are also able to create up to 10 of your own keyword categories. This allows you to identify arbitrary keywords and set up responses specific to your business. An example category might be “PROMO” or “DISCOUNT” which might prompt a response about promos that are happening this month.

These custom keywords operate in an “always-on” capacity, meaning that any user subscribed to your message service can text keywords and receive a response at any point. In addition to this behavior, you also have the option to define specific keywords that can only be sent to at certain points of your user’s lifecycle.

picture

Create a Custom Category

picture To create a custom keyword category, edit the appropriate subscription group, and click “Add Custom Keyword Category”. Here, you will be able to provide a keyword category name and define which keywords a user can text in to receive the reply message.

Once created, this keyword category will be available to filter and trigger against in your campaigns and Canvases.

Keywords created in custom keyword categories adhere to all of the rules and validations stated above for the creation of new keywords.

Lifecycle Specific Keywords

If you have a use case where you would like to limit when a customer can send a specific keyword during their lifecycle (e.g during their first initial onboarding) to receive a response, you can use the trigger “Send inbound SMS to subscription group within keyword category OTHER” in your campaign/Canvas and define some ad-hoc keywords that your users can send in at a point in time. This trigger supports filtering on the specific inbound message using is/is not comparisions of the message, as well as matches/does not match regex rules to validate the user’s input.

Canvas

picture

Campaign

picture

WAS THIS PAGE HELPFUL?
New Stuff!