Manage standard responses

From Genesys Documentation
Jump to: navigation, search
This topic is part of the manual Digital Channels Administrator's Guide for version Current of Digital Channels.

Learn how to manage the standard responses you send to customers.

Related documentation:

Standard responses are a way for your organization to define a set of prewritten responses. Agents or automated processes can send these responses to customers in email, chat, SMS, WhatsApp, Facebook, and Twitter interactions.

A standard response is a text template with keyword placeholders, called field codes, that the system replaces with appropriate text for the recipient. This template results in a standardized, yet custom message that is crafted according to the situation and customer. Genesys uses standard responses as suggestions for agents, acknowledgments, and autoresponses.

Agents can further personalize the standard response by editing it in their desktop before sending the message to the customer. For more information about how agents use standard responses, see the Agent Workspace Agent's Guide.

This topic covers the steps to create standard responses using Standard Responses Management. At a high level, you must:

  1. Plan your category tree. A category tree provides the framework for organizing your standard responses.
  2. Build your category tree.
  3. Create your standard responses.
  4. Use Field Code Management to create field codes, then add them to your standard responses. Field codes are the keyword placeholders you can use to personalize standard responses.

Access Standard Responses Management under the Responses menu.Des SR overview.png

Plan a category tree

A category tree is a way to organize your library of standard responses into a structure that is easy to access and manage.

A category tree consists of one or more "root categories" (units of knowledge), each of which can have subcategories or even sub-subcategories. These categories and subcategories contain the standard responses.

It's important to plan your category tree ahead of time. You can edit it as needed, but a little thought now will save time and frustration later. When planning, think about the root categories and subcategories that make sense in your business.

Let's use an online store as an example. Our store website can handle both chat and email interactions from customers. We want to send different responses depending on the interaction type, so let's make root categories for Chat and Email. Those root categories need subcategories for the most common reasons customers contact us: Orders, Returns, and Rewards.

Since Orders is a large topic, let's break it down into sub-subcategories: Order Status and Order History. Our site supports French and English, which means we must actually create two category trees—one for French and one for English.

Here's how our English Category Tree Plan looks:

Des SR Plan1.png

The way you organize your categories is subjective and depends on the needs of your business. For example, we could have made root categories for Orders, Returns, and Rewards. Then populated those categories with standard responses that are named as interaction types (Return Label Chat, Return Label Email, and so on).

Here's how this Alternate Category Tree Plan looks:

Des SR Plan2.png

You can have a category with no standard responses—its purpose is to group other categories together. However, a standard response must belong to a category.

Category membership is inherited. For example, Chat includes Orders, and Orders includes Order Status and Order History. Then Chat also includes Order Status and Order History.

Build a category tree

Now that planning is complete, it's time to build the category tree. In these instructions, you build the category tree first and then add standard responses, but you can also add standard responses as you build your category tree.

Create or edit a category

Important
Category folders with the star icon (Des SR IWD.png) cannot be edited. These categories are created and managed in Workload Manager for Intelligent Workload Distribution and Engage Cloud Email and are critical to proper functionality. While you can't edit the category, you can still create, edit, and delete standard responses within the category.

To begin, choose a language from the drop-down—remember, your category tree is specific to the language.

Next, click Add to create a root category. In the category editor, give your category a name and helpful description. After you save, the standard response table displays. You can use this table to add standard responses now or continue defining your tree.
Important

The category name can consist of no more than 64 alphanumeric characters supported in UTF-8. For more valid characters, see Characters allowed in names.

Des SR root.png

Once you have a root category, select its menu (Des SR more.png) and add a child category. You set up child categories the same way as root categories. First, define the category in the editor and then add standard responses as needed.

Des SR childcategory 2.png

Continue adding categories until your tree is complete. As you work with your category tree, you can adjust the layout by using the copy and paste feature or deleting a category.

Copy and paste a category

Use the category menu (Des SR more.png) to Copy a category.

To save a copied category as a root category, click Paste in the main sidebar.

Des SR paste.png

To save a copied category as a sub-category, click the menu (Des SR more.png) of the new parent category and select Paste.

The copied category is saved as "<original_name>_N", where "N" is the number of the copy. For example: Chat_1, Chat_2, and so on.

You can also use the category menu (Des SR more.png) to Cut a category, and then paste it as previously described.

Choose Clear buffer to clear the contents from your computer's clipboard.

Delete a category

You can delete a category by choosing Delete in the category menu. If you delete a category, all of its subcategories and standard responses are also deleted.

Create or edit a standard response

You can create a standard response in two ways:

  1. Open the category menu and click Add.
  2. Edit the category and add click Add.

An expanded view of the Add drop-down in the category menus and on category edit view.

Either method opens a sub-menu where you can choose the type of standard response to add. Standard Responses can be made up of plain text or HTML content, or they can use one of the following Genesys Widgets rich messaging templates:

  • Quick Reply
  • Generic Template
  • Carousel
  • Media Notification
  • List Template
  • List Picker
Important

To allow agents create standard responses with rich media content, the Allow rich media creation option must be enabled in the Tenant Settings and the Allowed rich media types option must include the set of templates that the agent can use. Tenant Settings for enabling rich media content in responses.

Name section

To get started, choose a standard response type. In the standard response view, you can set the name and description, Content, Attachments, and Properties. Enter the name and description and Save. The standard response view updates to display fields specific to your chosen response type.
Important
The standard response name can consist of no more than 128 alphanumeric characters supported in UTF-8. For more valid characters, see Characters allowed in names.

Content section

Most of the fields in the Content section depend on the type of standard response. However, you can insert field codes to customize any type of standard response. To add a field code, select a field code in the drop-down menu. You can also set browser's hotkeys to insert field codes. See Use field codes or details. You can also expand this section to view it at full width, which is helpful for rich messaging standard responses.

The Insert Field Code drop-down and the expand button.

When you create a rich messaging standard response, you can Preview how it looks in a Genesys Widgets webchat widget in either the Dark or default theme. This preview updates dynamically as you make changes in the form. You can interact with rich message fields, including button clicks, opening links, and selecting items.

Rich messaging standard responses also have a JSON view that updates dynamically and shows how the response is structured. Any changes you make directly in the JSON are reflected in the form and preview areas. This view has a toolbar of options you can use to format, sort, and fix the JSON.

Important
Genesys does not recommend changing values in JSON views. Resolve the identified issues using the left menu.

The following sections provide more information about the Content fields for each response type:


Attachments

In the Attachments section, you can add or remove an attachment by drag-and-drop or browsing your computer. When adding an attachment, make sure to consider the channel type you are targeting for the standard response and align the attachment type with the channel. Different channel types might have different limitations on what is acceptable.

Properties

In the Properties section, define whether the standard response is used manually, automatically, or not at all for these scenarios:

  • Acknowledgment—The standard response is sent through Designer to acknowledge the receipt of a message. For example: "Thank you for your email. One of our agents will reply to you in the next 24 hours."
  • Autoresponse—The standard response is sent by agents to an incoming interaction. It can also be used by Designer if you can be certain the customer's message is answered in this response.
  • Suggestions—The standard response is offered to agents as suggested wording to use in their own replies to interactions.

Finally, set a start date (today's date by default) and specify whether the standard response expires.

If a standard response expires, it has the following effects:

  • Designer cannot use the standard response in a new or modified application.
  • If a Designer application saved a standard response after the expiration date, Genesys does not send the standard response. Instead, Genesys returns an error message.

When your standard response is ready, click the check box to approve. You can only use approved responses in Designer applications and for Agents.

Text/HTML responses

The Content view for Text/HTML standard responses includes an integrated HTML editor.

The content of a Text/HTML response can be in either plain text or HTML, depending on the type of standard response. For example, use plain text for SMS responses and HTML for email.

The text mode supports using Markdown syntax to compose responses. The following Markdown elements are supported:

  • Headers
  • Bold text
  • Italic text
  • Bullets
  • Number bullets
  • Links
  • Images
  • Strikethrough
  • Backticks (Code)
HTML mode includes an integrated editor. Most of the buttons provide commonly used editing functionality, including the option to insert a link to an image. If you aren't sure what a button does, hover over it to open a tooltip.

There are two ways to add alternative text to an image, the Insert/Edit Image view or an 'alt' attribute in the HTML source.

Make images accessible

You can make images in your HTML-based standard responses accessible by adding alternative text. In HTML mode, click the Insert/Edit Image button to add your image and include the alternative text in the Alternative description field.

You can also add the "alt" attribute directly to the <img> tag when working in the source view (Des SR source.png). If an external image link is not present, the customer sees an alternative description in HTML. The HTML content grows in size when images are saved in base64 format, but they are always displayed in HTML text.

Quick Reply responses

The three-pane layout of the Content section in a Quick Reply standard response.

A Quick Reply is a simple way for customers to send a predefined reply to an agent or bot in a chat session. See Quick Replies for details.

To create a Quick Reply, define a Message to accompany your replies. Next, click (Des SR quick reply.png) to define at least one reply. Enter the Text for the reply and, optionally, add an image to display next to the text. As you edit these fields, the Preview pane updates dynamically to reflect your changes.


Generic Template responses

The three-pane layout of the Content section in a Generic Template standard response.

Use a Generic Template to create custom cards with an array of different components like buttons, links, and text. See Generic Template for details.

To create a Generic Template, first define a Fallback message to display to users who don't support rich messages. This field is populated by default, but you can adjust it to whatever suits your needs.

At a minimum, give your Generic Template one of the following fields: Title, Description, Image, Video, or Component.

To format text in the Description field, highlight one or more words and click the related button for bold, italic, strikethrough, or code. Avoid combining additional symbols with formatting symbols and text for precise formatting.

The Generic Template is divided into clickable areas that each have their own defined action. The top-level clickable area includes the title, description, image, and video. Define the action for this clickable area by choosing from the Action drop-down. "OpenURL" is supported. Next, choose the URL Target, which specifies where the link opens. "Blank" (open in a new tab or window) is supported. Finally, specify the URL for the clickable area.

Each Component you add is also its own clickable area, in the form of a button. To create a component, click (Des SR quick reply.png). The Text displays in the button, while the Title displays when a user hovers over the button.

Define the action for this clickable area by choosing from the Action drop-down. As with the top-level area, choosing "OpenURL" prompts you for a URL Target and the URL. If you choose "Textback", specify the text you want to send back to the agent when the customer clicks this button.

Carousel responses

The three-pane layout of the Content section in a Carousel standard response.

A Carousel shows multiple rich messages that users can navigate through using look-left and look-right arrows. See Carousel for details.

To create a Carousel, first choose the Type. You can choose only one type per Carousel, from the following rich messaging types: Generic Template, List Template, and List Picker.

Next, define a Fallback message to display to users who don't support rich messages. This field is populated by default, but you can adjust it to whatever suits your needs.

to define your Messages, click (Des SR quick reply.png) . The fields displayed in this section depend on which type of Carousel you chose. Don't forget to use the arrows (Des SR arrows.png) to expand and collapse Messages and Components so they're easier to view.

In the Preview, you can use the look-left and look-right arrows to view your messages the same way a user would.

Media Notification responses

The three-pane layout of the Content section in a Media Notification standard response.

Media Notifications correspond to WhatsApp Message Templates, but you can use them anytime you must send structured, predefined information to your customers. Use parameters and field codes to customize these notifications with details that are specific to your customer, such as their name or account information.

Important
Before continuing, you must upload the message to WhatsApp for approval before you can finish creating the media notification in Standard Responses. See the WhatsApp documentation for more information.

A Media Notification standard response has four sections:

  1. Header (optional)
  2. Body (required)
  3. Footer (optional)
  4. Buttons (option)

When you insert Custom Variables (created in the Custom Variable tab) and System Variables (created by the system and related to interaction, agent, and customer) in the expected fields, the RENDER button appears. Click the RENDER button to fetch the default values of custom and system variables.

Header

In the Header section, choose the type of content to include, Text or Media.

If you choose Text, the display updates with a Content field where you can add some introductory text, such as a greeting. To insert a parameter in the Content—a name, for example—click (Des SR param.png). In the Parameters section, give your parameter a Name and Value, such as a field code so you can personalize the greeting.

If you choose Media, select the file type (File, Image, or Video) and upload the file.

Body

In the Body section, provide an ID. (After WhatsApp has approved the media notification, it sends the ID to you.)

In the Content field, fill in the main text for your message and add any necessary parameters. To format text, highlight one or more words and click the related button for bold, italic, strikethrough, or code.

Footer

If your notification requires a Footer section, choose Text from the drop-down and provide some Text.

Buttons

In the Buttons section, first choose a type: CallToAction or QuickReply.

For CallToAction, specify the Button Text and choose an Action Type: Visit Website or Call Phone Number. If you select Visit Website, provide the URL with any necessary parameters. If you select Call Phone Number, provide the Phone Number.

You can add up to two buttons, which are displayed below the footer at the bottom of the notification.

List Template responses

The three-pane layout of the Content section in a List Template standard response.

A List Template lets you create custom cards with list items made up of an image, text, and clickable area. See List Template for details.

To create a List Template standard response, first define a Fallback message to display to users who don't support rich messages. This field is populated by default, but you can adjust it to whatever suits your needs.

Give your List Template a Title. You can format text in the Description field by highlighting one or more words and click the related button for bold, italic, strikethrough, or code.

Click (Des SR quick reply.png) to create a component, a clickable list item that is displayed in the response. Give your component and image, Title, and Description (optional). The Type field has two options:

  • List Item—The image is displayed to the left of the title and description.
  • Big List Item—The component fields are stacked in this order: image, title, description.

You can use combinations of List Item and Big List Item in a single List Template standard response.

Define the action for this clickable list item by choosing from the Action drop-down. There are two options:

  • OpenURL—Choose this option if you want the click action to open a link. Provide the URL Target, which specifies where the link opens. Currently, "Blank" (open in a new tab or window) is supported. Specify the URL for the clickable area.
  • Textback—Choose this option if you want the click action to send the text in the Textback field to the agent when the customer clicks this button.

List Picker responses

The three-pane layout of the Content section in a List Picker standard response.

A List Picker is similar to a List Template, except that the user can choose an option in the list and submit it to the agent. See Single Selection List for details.

To create a List Picker standard response, review the details in the List Template section. There are just a few differences in the fields for these two types of rich messaging standard responses.

Define the Submit Label, which is the text displayed on the submit button. This button appears after the user has chosen one of the list items (do the same in the Preview to see how your buttons look). Also specify which Action the button takes: "OpenURL" or "Textback".


Use field codes

You can insert field codes to customize any type of standard response. If the field code you need is not in the list, you can create it using Field Codes Management. Field codes are delimited using <$ … $> syntax. If you type a field code directly into the body of a standard response, then you must enter the delimiters yourself. If you select from the list of field codes, then the delimiters are added automatically.

Characters allowed in names

More Characters Allowed in Object Names
Name Character Name Character
Hyphen - Exclamation point !
Number sign, pound # Dollar sign $
Caret ^ Asterisk *
Underscore _ Curly brackets { }
Angle brackets <> Period, full stop .
Backslash \ Parentheses ()
Question mark ? Space
At sign @

Copy a standard response

You can copy responses from the standard responses table in a category. Just click Copy (Des PII copy.png) for the standard response you want to copy and then paste it to the current category.Des SR copysr.png

To copy a standard response to a different category, choose Paste from the category's menu.

Des SR copysr2.png

Important
The copy/paste functionality does not copy any existing standard response history. This history might be present in a standard response if it was originally created using the eServices Manager Plug-in.

Delete a standard response

You can delete standard responses from the responses table view in a category. Just click Delete (Des PII delete.png) for the standard response you want to remove.

Search the category tree

Use the search box above the category tree to search for categories or standard responses.

To locate a category or standard response, use the search box above the category tree. The category tree filters automatically based on the search term.

To search for standard responses in a category, use the search box above the responses table. The results filter automatically based on the search term.
Comments or questions about this documentation? Contact us for support!