Aha! Ideas | Integrate with Zendesk (Advanced plan)

For Ideas Advanced customers, integrating with Zendesk enables your customer support team to take requests via Zendesk and add those requests as new ideas or link them to existing ideas in your Aha! Ideas account.

With this integration, statuses of ideas linked to Zendesk support tickets are highlighted — making it easy to communicate how your team is handling each customer request.

When a Zendesk ticket is linked to an Aha! Ideas idea, the customer submitting the ticket can be added as the idea creator and set up as a subscriber. If these options are selected, the customer will automatically receive email notifications of status updates. Integrating with Zendesk often results in a reduction of tickets because customers do not need to actively inquire about the status of their request.

Zendesk agents do not need Aha! Ideas user permissions in order to link tickets to ideas in Aha! Ideas or to create new ideas.

Click any of the following links to skip ahead:

• Prerequisites

• Configuration

• Idea visibility

• Additional configuration options

• Troubleshooting

  • Unable to link tickets

  • Select the correct user

  • Replace the existing user

Prerequisites

Top

Configuration

To install and configure the Aha! app in Zendesk, you need to be a Zendesk admin and follow the steps below:

1. Find the Aha! app in the Zendesk marketplace. You can do this while in Zendesk by clicking on the Settings icon, then search for Aha! in Apps Marketplace.

2. Install the Aha! app in Zendesk.

3. Configure the app by entering the subdomain for your Aha! Ideas account under the App Configuration tab. The subdomain is the part that comes before .aha.io in your Aha! Ideas account URL.

4. Go to a ticket in Zendesk. Select the Apps button on the top-right to open the sidebar.

5. From the Aha! app in the sidebar, select Authorize this app.
   
   Note: The user who initially authorizes the Aha! app must also be a Zendesk administrator so that the authentication information can be saved in Zendesk. Users can submit ideas to any workspace that the user who initially authorizes the application has access to.

6. You will be prompted to log in to Aha! Ideas and to authorize Zendesk to access your account.

7. Once the Aha! app is authorized, it will be enabled for any Zendesk agent. Your Zendesk agents do not need to be users in your Aha! Ideas account.

Top

Idea visibility

You may want to review ideas created through the Zendesk integration before people can view them in your ideas portal, or you may want them to appear on the portal immediately so that they can start gathering votes and comments.

First, in the integration configuration page in Zendesk, decide how you want Aha! Ideas to interpret ideas created from the Zendesk integration.

• If you enable Create ideas as ticket requester, then the person who submitted the Zendesk ticket will be the idea's creator in your ideas portal.

• If you disable Create ideas as a ticket requester, then the Zendesk agent will be the idea's creator in your ideas portal. Please note that the agent can only vote once on a unique idea.

Next, review the default visibility settings for your ideas portal. You can set a different default visibility for each type of user who submits an idea. For example:

• The idea's Creator is the person who submitted the idea in your portal. You may want ideas created by users in your Aha! Ideas account to be visible only to their creator by default, giving you a chance to review them.

• Portal users are end-users, not associated with your Aha! Ideas account. You may want ideas created by portal users (for example, created by the customer who first submitted the Zendesk ticket) to be Visible to all ideas portal users.

• Internal users might be employees at your company, or they might be partners, beta testers, or power users. You may want ideas created by employees to be Visible to internal users.

• Aha! Ideas users are members of your Aha! Ideas account, and privy to internal information that Portal users and Internal users might not be. You may want ideas created by Aha! Ideas users to be Not visible in portals by default.

You can change individual ideas' visibility settings to Visible to all ideas portal users where appropriate after reviewing them.

Note: Ideas with a visibility setting of Not visible in portal will not be visible to Zendesk agents when using the Link idea feature in Zendesk and performing a search for related ideas. This is by design, as a visibility setting of Not visible in portal denotes it is an idea that your team does not want people outside of your Aha! Ideas account to see.

Top

Additional configuration options

To enable the ability to mark the idea as created by and to add the ticket requester (customer) as a subscriber, Zendesk admins can select Settings Apps Manage Aha! App Configuration. These additional settings include the following options:

• • Create ideas as ticket requestor: Disabling this will create ideas as the Zendesk agent, not the customer.

  • Subscribe ticket requestor to updates: Disabling this will prevent the ticket requestor (the customer) from receiving idea notifications, including comments on the idea. This is a useful setting to disable if you intend to discuss the idea internally.

The linked idea requestor email is automatically added as an idea watcher in Aha! Ideas to receive status updates through email notifications. This can be disabled within the app configuration settings from Settings Apps Manage Aha App Configuration.

Top

Troubleshooting

Unable to link tickets

Sometimes, people using the Zendesk integration report that they are unable to link Zendesk tickets to existing Aha! Roadmaps ideas or create new ideas. This usually occurs after the integration has been set up and working successfully for a period of time so it seems like a random event.

When this occurs, logging out of Zendesk and then logging back in typically resolves the problem. If the problem persists, of course, please contact us.

Select the correct user

If you have trouble authenticating your integration, the most common reason is with the Aha! user you are using to authenticate. The integration can only have the user permission level that the Aha! user you selected has, so you need to choose an Aha! user with admin user permissions for the integration to work.

To make sure you have the correct user selected, it is easiest to reset the integration by deleting and re-installing it.

1. Remove the Aha! app from your Zendesk account.

2. Re-add the Aha! app to your Zendesk account.

3. Log out of Zendesk.

4. Log out of your Aha! account.

5. Log in to Zendesk as an admin.

6. Log in to Aha! as an admin.

7. Click the Authorize button.

Replace the existing user

This integration is tied to a specific user. But user permissions may need to be updated in Aha! Ideas based on your company's changing needs. For example, perhaps the user who originally authenticated the Aha! app from Zendesk leaves your company or no longer has contributor or workspace owner access.

If this is the case, the integration will stop working. Zendesk agents will be able to search for ideas but when they attempt to link the idea, the process will stall. If this happens, you need to re-authenticate the Zendesk app by following these steps:

1. Uninstall the Aha! app and re-install it in Zendesk following the steps outlined in this article. You will not lose any existing data through this process.

2. Authorize the Aha! app from a ticket with credentials that have the correct permissions.

Top