Start & swap Timers with Zendesk Action Builder

The SweetHawk connector allows you to start timers directly from Zendesk Action Builder using the Timers app. This article demonstrates two example workflows to help you get started, however Action Builder workflows can be adapted to suit your own business processes and timer requirements.

The first example uses a single action flow to evaluate a ticket's priority and start the appropriate timers, allowing multiple timers, such as First Reply and Full Resolution, to be started without creating separate Zendesk triggers for each priority.

The second example demonstrates a more advanced single workflow that starts and swaps an active timer as the ticket priority changes. This allows a single Action Builder workflow to handle both the initial timer start and any subsequent timer swaps, reducing the need for multiple Zendesk triggers.

Steps covered in this article:

• Before you begin
   
• Example 1. Start timers when a ticket is created
  • Add the ticket-created trigger⁠
  • Add a branch for each priority⁠
  • Add the SweetHawk timer actions
     
• Example 2. Start and swap timers on ticket creation and priority changes
  • Add a stopped tag through a Timer workflow
  • Create a Zendesk trigger to start the Action Builder workflow
  • Add the tag-change trigger to Action Builder
  • Remove the workflow tag
  • Add a branch for each priority
  • Add the SweetHawk timer actions & identifier

Before you begin

Before creating these action flows:

1. Connect the SweetHawk connector by following Connect SweetHawk to Zendesk Action Builder.
2. Create the SweetHawk timer definitions that you want to use, see Getting Started with Timers.
3. Make sure each priority has the required timer definition, such as Low, Normal, High and Urgent.
4. Review Zendesk’s guide, Creating action flows to automate processes across Zendesk and external systems, if you are new to Action Builder.

Example 1: Start timers when a ticket is created

In this example, we'll create an Action Builder workflow that starts one or more timers when a ticket is created. The workflow branches based on the ticket priority, allowing a different timer, or multiple timers, to be started for each priority.

For example, you could start both:

• A First Reply timer
• A Full Resolution timer

With two timer types across four ticket priorities, a single Action Builder workflow can handle up to eight different timer starts, reducing the need for multiple Zendesk triggers.

Add the ticket-created trigger

1. Create a new action flow.
2. Add a trigger card.
3. Under Zendesk, select Tickets.
4. Select Lifecycle.
5. Select Ticket created.
6. Add any additional trigger conditions required for your workflow.

The ticket information returned by this trigger can then be used by the branches and SweetHawk actions later in the flow.

Add a branch for each priority

Click the + beneath the trigger card and select:

Flow control and utilities > Branch

Configure the first branch to check whether the ticket priority is Low:

• Variable: Ticket priority from the trigger card
• Condition: Is
• Value: low

Under the Else path, add another branch for Normal priority and continue adding nested branches for High and Urgent in the same way.

It's recommended to use the final Else path as a fallback for tickets that do not have a priority (-). For example, you could start the Normal priority timers when no priority has been set.

Add the SweetHawk timer actions

Under 'If condition is met' priority branches:

1. Click the + beneath the branch.
2. Scroll to External actions and select SweetHawk.
3. Select Start Timer action.
4. Under Zendesk ticket ID, select Ticket ID from the trigger card.
5. Under Timer, select the timer definition for the current branch.

To start a second timer on the same ticket, click the + beneath the first timer action and add another SweetHawk Start Timer action.

For example, the priority branches could contain both first reply and full resolution timers as these start at the same time at ticket create.

Example 2: Automatically start and swap timers based on ticket priority

In this example, we'll create an Action Builder workflow that both starts and swaps a timer based on the current ticket priority. This allows a single workflow to handle the initial timer start when a ticket is created, and automatically swap the timer if the priority changes later.

For example, in one workflow:

• A ticket is created with Low priority and the Low First Reply timer starts.
• The ticket priority later changes to High.
• The active Low First Reply timer is swapped to the High First Reply timer.

This example uses:

• A Zendesk trigger to add a temporary control tag
• An Action Builder workflow triggered by that tag
• A shared identifier across the priority-based timer actions

Add a stopped tag through a Timer workflow

This step prevents a stopped timer, such as a First Reply timer, from being restarted if the ticket priority changes later. If a timer only stops when the ticket is solved or closed, such as a Full Resolution timer, this step is typically not required.

In the SweetHawk Timers app:

1. Open Workflows.
2. Create a new workflow or edit an existing workflow.
3. Add a Timer stopped ticket update.
4. In Zendesk Ticket Updates to add the tag first_reply_timer_stopped (as example).
5. Save the workflow.
6. Apply the workflow to every First Reply timer definition used by the action flow.

Create a Zendesk trigger to start the Action Builder workflow

To ensure the Action Builder workflow runs when a ticket is created and whenever its priority changes, create a Zendesk trigger that adds a tag to start the Action Builder workflow.

This allows the same Action Builder workflow to handle both the initial timer start and any subsequent timer swaps.

In a new Zendesk trigger set the following:

Meet ALL of the following conditions

• Tags: Contains none of the following
• Value: first_reply_timer_stopped (or same tag as step above)

Meet ANY of the following conditions

• Ticket: Is created
• Priority: Changed

Actions

• Add tags: first_reply_timer_action 

Save the trigger.

Action Flow Creation

Add the tag-change trigger to Action Builder

Create a new action flow that we will use to start and swap our timers.

1. Add a trigger card.
2. Under Zendesk, select Tickets.
3. Select Routing.
4. Select Ticket tags changed.
5. Click Add condition.
6. Configure the condition as follows:
   • Variable: Tags (added)
   • Operator: Contains at least 1 of
   • Value: Enter the tag that should complete the task, such as first_reply_timer_action. (or the tag you added in your trigger above)

Remove the workflow tag

The tag that started the Action Builder workflow must now be removed so the Zendesk trigger can add it again when the ticket priority changes in the future.

Click the + beneath the trigger card and add the Zendesk Remove tags from ticket action.

Configure the action as follows:

• Zendesk ticket ID: select Ticket ID from the trigger card.
• Tags: first_reply_timer_action

Add a branch for each priority

Click the + beneath the trigger card and select:

Flow control and utilities > Branch

Configure the first branch to check whether the ticket priority is Low:

• Variable: Ticket priority from the trigger card
• Condition: Is
• Value: low

Under the Else path, add another branch for Normal priority and continue adding nested branches for High and Urgent in the same way.

It's recommended to use the final Else path as a fallback for tickets that do not have a priority (-). For example, you could start the Normal priority timers when no priority has been set.

Add the SweetHawk timer actions & identifier

Under 'If condition is met' priority branches:

1. Click the + beneath the branch.
2. Scroll to External actions and select SweetHawk.
3. Select Start Timer action.
4. Under Zendesk ticket ID, select Ticket ID from the trigger card.
5. Under Timer, select the timer definition for the current branch.
6. Under Additional fields, select Identifier.
7. Enter the same identifier for every timer in this series. In this example, use first_reply.

When the Action Builder workflow runs, it will follow the matching priority branch and start the corresponding timer. If an active timer with the same identifier already exists on the ticket, SweetHawk automatically swaps it to the new timer instead of starting a second timer.

The identifier should be unique to each timer series. In this example, first_reply is used for the First Reply timer workflow. If you create another workflow for Full Resolution timers, use a different identifier, such as full_resolution, so each timer series is managed independently.

Save the flow, then test it on a ticket containing the relevant task list or phased task list, before activating the action. 

• Before you begin
   
• Example 1. Start timers when a ticket is created
  • Add the ticket-created trigger⁠
  • Add a branch for each priority⁠
  • Add the SweetHawk timer actions
     
• Example 2. Start and swap timers on ticket creation and priority changes
  • Add a stopped tag through a Timer workflow
  • Create a Zendesk trigger to start the Action Builder workflow
  • Add the tag-change trigger to Action Builder
  • Remove the workflow tag
  • Add a branch for each priority
  • Add the SweetHawk timer actions & identifier