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 Aha!
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! 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.
Click any of the following links to skip ahead:
- Integration requirements
- Configure the integration
- Idea visibility
- Additional configuration options
- Re-installing the Aha! app in Zendesk
To set up the Zendesk integration, you must have:
- Administrator access with customization permissions in your Aha! account.
- Contributor or workspace owner permissions for the workspace(s) that you want your Zendesk agents to submit ideas to.
- An active idea portal.
Note: While you can create the integration even if you do not have an idea portal created, you will get an error saying that the idea could not be created until you have enabled an ideas portal for your workspace.
Configure the integration
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! account under the App Configuration tab. The subdomain is the part that comes before .aha.io in your Aha! 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.
6. You will be prompted to log in to Aha! and to authorize Zendesk to access your account.
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! account.
New ideas created in Aha! through the Zendesk integration automatically default to a visibility level of Not visible in portal. However, you can change the default visibility settings for your ideas portal.
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! account to see.
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! to receive status updates through email notifications. This can be disabled within the app configuration settings from Settings > Apps > Manage > Aha > App Configuration.
Re-installing the Aha! app in Zendesk
This integration is tied to a specific user. But user permissions may need to change in Aha! 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:
- 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.
- Authorize the Aha! app from a ticket with credentials that have the correct permissions.