Installing and using the Proactive Tickets app

What's my plan?

Suite

Team, Growth, Professional, Enterprise, or Enterprise Plus

Support

Team, Professional, or Enterprise

Here are some ways you might want to use proactive tickets:

• Manage business renewals: Create proactive tickets when your customers are coming up to their subscription renewals. With subscription type or renewal date stored in a custom user field in your account, you can target specific customer types. 
• Online retailers: Proactively reach out to customers based on their service changes, purchase history, or order fulfillment status. Knowing your buyers' history can help you anticipate potential issues with their experience, driving up revenue and reducing abandonment.  
• Internal help desks: Notify users within your organization of service disruptions or policy changes. Keeping your employees up and running reduces downtime and maintains their productivity. 

To help you get started, this guide will walk through: 

• Important considerations 
• Installing the Proactive Tickets app
• Creating proactive tickets campaigns
• Best practices for your proactive ticket campaigns
• Release Notes

Important considerations 

• You must set a default time zone on your user profile to use the Proactive Tickets app. If a default time zone isn't set, you will encounter a blank page when running a search.
• The Proactive Tickets app does not work with custom ticket statuses. The app is only compatible with system ticket status fields. 
• When searching for customers, only 20 display in search results at a time. To create more than 20 tickets at once, increase the number of users per page. See How can I send more than 20 tickets at a time through the Proactive Tickets app?
• When searching for information in custom user fields, use the key that names the custom field. If you are looking for a specific multi-word phrase (such as “renewal date”), enclose it in quotes. This ensures that you receive exact matches.
  Example: To search for the custom field named "renewal date," you would enter it as follows: custom_field_name: "renewal date".

Installing the Proactive Tickets app

1. In Admin Center, click the Apps and integrations icon () in the sidebar, then select Apps > Zendesk Support apps.
2. Click Marketplace at the top of the page and then enter "Proactive Tickets" in the Marketplace search bar.
3. Double-click the Proactive Tickets app icon and click Install.

After the app is installed, you'll see the Proactive Tickets () icon appear in the left navigation bar. 

Creating proactive ticket campaigns

It's best practice to double check your customer list and make sure that you are sending to the correct group of customers.

To create a campaign using the Proactive Tickets app, agents must have permissions to create and edit shared views.

To create a proactive ticket campaign

1. Click the Proactive Tickets () icon in the left navigation bar. 
2. Enter search criteria to create a filtered list of customers, then click Search.
   Use the text field at the top to search all user fields. For example, type an organization name, tag, or last name in the text field, and the app will search all user fields to find results.
   You can also use individual fields to search for customers. For example, to create a list of customers at the Petipet organization with a VIP tag on their profile, type Petipet in the Organization field and VIP in the Tags field.
3. Select the customers in the list, then select Create ticket.
4. Enter a unique name in the Name your campaign field. The name will be added as a tag to all the tickets for this campaign. You can use this tag to create custom reports.
5. Enter remaining details, like the subject, description, ticket status, and assignee, in the Create your proactive ticket section. 
   
   Note: If you're creating proactive tickets with a Solved status, make sure to fill out any required fields on the ticket form before proceeding.
6. Select a macro to run on the proactive tickets as they are created
7. Click Next to preview your proactive ticket.
8. Review your proactive ticket details and click Send to send your campaign.
9. Once your tickets are all created, a confirmation page appears. Additionally, Zendesk will automatically create a ticket view for your campaign. Click Go to ticket view and use that dedicated view to manage your proactive tickets. 

Zendesk creates proactive tickets at a rate limit of 200 tickets per minute. Depending on how many proactive tickets you're creating, it might take a few minutes for your entire campaign to run. Please do not leave the screen during this time.

Best practices for your proactive ticket campaigns

In addition to setting up the Proactive Tickets app, you can set up other aspects of your Zendesk to support your proactive ticket campaigns. 

Before you create proactive tickets:

• Your proactive tickets will follow the existing workflows you have set up in your Zendesk. Review your triggers setup to make sure you want your proactive tickets to follow the same workflow. To create a dedicated workflow for your proactive tickets, you'll need to set up a trigger based on the unique tag for your proactive ticket campaign. See Streamlining workflows with triggers for setup help. 
• Meet with your team to communicate the objectives and create an action plan for your proactive tickets campaign. Identify queue management, triage, and escalation strategies. With a prepared plan of attack, your team will be more efficient and productive in managing your proactive communication.
• Create other relevant tools, like macros to speed up repetitive responses, to support your proactive ticket campaign. See Using macros to update tickets for setup help. 

As you create your proactive tickets:

• Make sure that you do not create more proactive tickets than your team can reasonably support. If you're planning on proactively communicating with your customers, you'll want to be prepared to be able to respond back quickly and efficiently. A great way to gauge how many tickets your agents can support is by simply looking at your agents' ticket resolution power, as measured by tickets solved per day.
• Be mindful of your customers when creating proactive tickets on their behalf. Just like any other outbound customer communication, you want to be careful on how often you "reach out" or "spam" them. 
• Double-check your customer lists before sending out your proactive ticket campaign. We recommend that you create no more than 1,000 proactive tickets per campaign, so make sure your customer list has fewer than 1,000 customers. If you need to send to more customers, you'll need multiple campaigns. 

After you create your proactive tickets:

• Check out the ticket view Zendesk automatically creates for you. You can use this view to organize and manage your proactive tickets. You can customize this ticket view to fit your needs. See Using views to manage workflows for setup help. 
• To report on your proactive ticket campaign, you can use the unique tag that was created for your proactive ticket campaign. You'll need to use Insights to create custom reports based off of this tag. See Insights tag reporting: Reporting on tickets with one or more tags for more information. 

Release Notes

Version 2.3.1 - 2022-05-24

• Improvements
  • Allow HTML content for ticket description

Version 2.2.2 - 2021-05-10

• Improvements
  • Fixed several issues with translations and alignment issues

Version 2.2.1 - 2021-01-25

• Improvements
  • Added a more specific error message when the agent doesn't have the correct permissions to run a campaign and create the tickets

Version 2.2.0

• Improvements
  • Allows sending campaign to failed users
  • Updated alert message when campaign fails

Version 2.1.0 - 2020-05-20

• Improvements
  • Search Enhancements
  • Ability to run a macro when Proactive tickets campaign runs (Basic Plan)
• Bug fixes
  
  • Characters in non-English languages being truncated
  • Fixed an issue where it was searching/including suspended users
  • Fixed an issue where markdown language wasn't working in ticket description.

Version 2.2.0 - 2020-11-20

• Improvements
  • Allow sending campaign to failed users
• Bug fixes
  • Add corresponding error text for unauthorized access instead of generic vague message
  • Localization and UI update

• •  

Version 2.3.0 - 2021-07-30

• Convert and incorporate paid features into the Free plan