Table of Contents

Macros

Niamh Ferns Updated by Niamh Ferns

Macros Overview

Macros is a DeskDirector Tech Portal feature that allows service agents you to automate certain actions on a ticket.

A good use case is to save common replies to common issues your techs encounter (aka canned responses). This saves a ton of time having to re-type information or looking for the information saved elsewhere and pasting it into the tech portal. Let's get started.

Creating a Macro

To create a macro you will need to login to Tech Portal and navigate to the macro page on the left navigation menu. Once there, click the add button on the bottom right of the screen:

  1. Give your macro a useful name for easy reference. You also need to give a description of what your macro does for easy reference.
  2. Add a comment to determine what the macro triggers. (You can also append placeholder tokens as described below.)
  3. View/Add tokens
    You can also add placeholder tokens into your comment. These are:
    Contact email: email of the contact assigned to the ticket
    Contact name: name of the contact assigned to the ticket
    Ticket Number: ticket number of the ticket
    Ticket Summary: summary of the ticket
    Member Name: name of the assigned member
    When you activate a macro on a ticket, these tokens will be replaced by the actual values from the ticket.
  4. Optionally, Share Your Macro
    Ticking/Unticking Shared with team determines who can use the created macro. If this is unticked, the macro can only be used by the tech that created it. If ticked, this gives access for the whole team to use the macro.
  5. Optionally, configure a webhook
    This is an advanced feature which can be used to perform more powerful automations. You need to provide a http endpoint and select which data you want to include in the payload. When you apply a macro on a ticket, Tech Portal will send a request to the given endpoint with the given payload.

Example Webhook Payload:

{
  "contactEmail": "chris@deskdirector.com",
  "contactName": "Chris Le Sueur",
  "ticketNumber": "1115503",
  "ticketSummary": "need live help",
  "memberName": "Andrew Lahikainen"
}
The payload values will all be of string type. You must perform the type conversions yourself (i.e: for ticket numbers).

Using Macros

To use a macro, click the Apply Macro dropdown under the note textarea:

If you set up a comment, it will appear inside the textarea. If you set up webhooks a button will appear on the top right of the textarea toolbar. You can click this button to see a summary of the webhooks that will be triggered when you click submit.

Frequently Asked Questions

"Will macros work even without the webhook URL?"

They will. The webhook is for more advanced use and tinkering of macros. The macro will work with just the macro comment set up.

How did we do?

Menu Items

Tabs

Contact