Start tracking your progress
Trailhead Home
Trailhead Home

Create a Macro and Quick Text

Learning Objectives

After completing this unit, you’ll be able to:

  • Create macros.
  • Create quick text.

Create an Irreversible Macro

Maria arrives at work bright and early, eager to try out her new tools. Before she can even log in, Sita stops by her desk. More cases about broken solar panels arrived today. Yikes! Sita wants to know when the tools will roll out to agents. Maria has good news—she plans to have the tools ready by tomorrow, or maybe even today.

Maria logs in and launches her Service Console app. She knows macros perform actions on records, so she opens one of the cases for a broken panel. She decides to create a macro that sends an email to customers who haven’t submitted photos of the broken panels. Photos are required to authorize a replacement, so she wants to make requesting them easy. Here’s how she does it.

Note

Note

In Lightning Experience, macros are supported on standard and custom objects that allow quick actions and have a customizable page layout. If you see the message, “This page doesn’t support macros” in the utility, double-check that you’re on the record page for a supported object. You can’t run macros on list views. To create macros, use the Macros utility. You can’t create macros from the list view.

  1. From the Service Console app, open a case. Then click Macros in the utility bar to launch it. Click Create Macro to get started.

    Service Console app, showing the macros utility open

  2. Give the macro a name and description, then select the object the macro applies to. The Apply To value defaults to the object you were viewing before.

    Here’s Maria’s macro.

    New macro page, showing details for a macro about solar panels

  3. Click Save.

    The macro record view is displayed. This page shows you all the details of your macro.

  4. Click Edit Instructions to start telling the macro what to do.
  5. If prompted, click Open in the pop-up window to launch the Macro Builder.

    Now it’s time to add instructions for the macro. The Macro Builder displays the record page that you started from. Since this isn’t the “real” record, we call this area the canvas (1). The instruction panel keeps track of all your updates (2).

    Macro Builder page, showing the canvas and instruction panel

    All you have to do is click the canvas and perform whatever actions you want the macro to take, kind of like making a video recording of all your actions. Click the actions and fields just like you would for a regular record. To help you out, the supported regions and actions that you can update are highlighted on hover. Then use the instruction panel to enter your updates. You can insert quick text, use email templates, add email attachments, and more.
    Tip

    Tip

    If you mess up and click something you don’t want in your macro, just click the X next to the instruction to remove it.

  6. In the canvas, click Email.

    Case publisher in the Macro Builder, showing the Email action selected

  7. In the instruction panel, click Insert Email Template.

    Instruction for the Email action, showing button to insert an email template

  8. Select an email template.

    Maria has already set up an email template to handle the initial email response requesting photos.

    To follow along, you can use the Support: Case Created (Web Inquiries) template. To find the template, you might need to first change the template directory. Select Classic Email Templates in the Templates field.

  9. To send the email, click Send in the canvas.

    The instruction panel is updated to include an irreversible action. Remember those from earlier? They’re actions that can’t be undone. Once the macro sends the email, it can’t be undone.

    Here’s what Maria’s instructions look like.

     Instruction for the Email action, showing a template applied with the Submit Action highlighted

  10. Click Save.
  11. To return to the Service Console app, close the browser tab for the Macro Builder.
With one macro under her belt, she creates a few more.
Tip

Tip

To create more macros for a case, open the Macro utility and click the + button.

Maria then opens the navigation item menu looking for the macros list view, but realizes it’s not there…

Where’s the Macros List View?

Maria remembers specifying tab visibility for macros in the permission set she created yesterday, but she didn’t assign it to herself. By default, the macro tab isn’t visible—even for System Administrator profiles. She can either assign herself the permission set, or she can edit the navigation menu and add the Macros tab. She decides to edit the navigation menu.
Note

Note

If you created the Macros Power User permission set, you can assign it to yourself. If you didn’t create the permission set, follow along with Maria.

  1. From the Service Console app, open a case. Then click the navigation menu.
  2. Click Edit.
  3. Click Add More Items, and select Macros to add it to the menu.

    Edit the navigation items and add Macros to the list.

  4. Click Save.

Maria’s excited to try out her macros on the new cases that have come in. She’s curious to see just how many clicks she saves her agents.

Create Quick Text

To save more clicks, Maria dives into setting up quick text. She wants to create a few samples to show her agents just how powerful they can be. She decides to make one with an apology that can be sent to customers about the broken panel. Here’s how she does it.

  1. From the Service Console app, select Quick Text in the navigation item menu.
  2. Click New Quick Text in the Quick Text list view.
  3. Give your quick text a name. Maria enters Solar Panel Apology.
  4. Enter your quick text message. The message can include line breaks, lists, special characters, merge fields, and up to 4,000 characters.
    Tip

    Tip

    Merge fields within quick text can supercharge agent productivity. They let you insert the value of a field for a specific record. With merge fields, quick text becomes record-aware, letting agents avoid the dreaded copy and paste from the record’s details.

  5. Select a category. Maria selects Closings.
  6. Select the channels in which you want the message to be available. Maria selects Email.
    Depending on which features are enabled in your org, these channels might be available.
    • Email—Works with the email action
    • Live Agent—Works with Live Agent chat in the Service Console
    • Phone—Works with the Log a Call action
    • Portal—Works in a community or a customer portal
    • Internal—Works with internal fields, like on the Change Status action
    Important

    Important

    If you don’t specify a channel, the quick text message can’t be used because it won’t be available in any actions. The Portal and Internal channels aren’t supported in Lightning Experience and don’t map to any actions in Lightning Experience.

    Here’s Maria’s quick text.New quick text page, showing information for an apology

  7. Click Preview to take a peek at what the quick text looks like with resolved merge fields.
  8. To view sample resolved merge fields, select a recipient and a related record. Use the dropdown to change the object to cases.

    The Preview Quick Text window, showing the Related To field pointing to a case

    Here’s Maria’s quick text in preview.

    The Preview Quick Text window, showing the resulting content

  9. Close the preview, then click Save.

Maria creates a few more quick text messages, including one with a personalized signature.

Understand How Sharing Works

By default, sharing settings for macros and quick text are set to private. That means agents can’t see the macro or quick text that Maria created until it’s shared with them. To share macros and quick text, you have a few options.

User Interface Sharing Model
Lightning Experience Share folders

Let users organize and share quick text and macros in folders. To share an item, users add items to a folder, and then share that folder. To use this model, you enable folders for quick text and macros in Setup.

Note

Note

Keep in mind that sharing settings on folders override sharing settings on individual items. If you shared macros or quick text in Salesforce Classic, those settings are ignored after folders are enabled.

After you enable folders for quick text or macros, we recommend that you move all existing items into folders and share those folders with your users. If an item isn’t in a folder, only the owner, creator, and admin have access.

Also verify that your macro and quick text page layouts include the Folder field so that your agents can actually assign items to a folder.

For detailed steps on enabling folders, see the previous unit.

Salesforce Classic Share individual items

Let users share quick text and macros individually. To share an item, users click the Share button on the quick text or macro record details. To use this model, you don’t have to enable anything because it’s the default behavior in Salesforce Classic.

Both Share org-wide

Let users see all quick text and macros in your org. To use this model, you update the org-wide sharing settings for the quick text and macros objects to public in Setup. We don’t recommend this model for most orgs.

Maria enabled folders for quick text and macros in the previous unit, so she’ll share her quick text and macros using folders after she’s tried them out herself.

retargeting