Prerequisites

• An active UserVoice account from which data is to be ingested exists.

• The API token is available to provide Hevo access to your UserVoice account data.

• You are logged in as an Admin user to create the API token. Else, you can obtain the token from your administrator. Read Managing Permissions to know about the different types of users, and the permissions they have in UserVoice.

• You are assigned the Team Administrator, Team Collaborator, or Pipeline Administrator role in Hevo to create the Pipeline.

Creating the API Token

You require an API token to authenticate Hevo on your UserVoice account. The API token does not expire and can be reused for all your Pipelines.

Note: You must log in as an Admin user to perform these steps.

To create the API token:

1. Log in to your UserVoice account as an Admin user.

2. In the left navigation pane, click on the Settings ( ) icon, and then click Integrations.

   

3. On the Settings page, Integrations tab, under the Essential Plan Integrations section, click UserVoice API keys.

   

4. Click Add API key.

   

5. In the Add API key pop-up window that appears, do the following:

   1. Specify a NAME for the API key.

   2. Select the TRUSTED? check box.

   3. Click Add API key.

      

      Your API key is now visible under the UserVoice API keys section.

6. Click Create corresponding to the API key that you created.

   

7. Copy the API token and save it securely like any other password. Use this token while configuring your Hevo Pipeline.

   

Configuring UserVoice as a Source

Perform the following steps to configure UserVoice as the Source in your Pipeline:

1. Click PIPELINES in the Navigation Bar.

2. Click + CREATE PIPELINE in the Pipelines List View.

3. On the Select Source Type page, select UserVoice.

4. On the Configure your UserVoice Source page, specify the following:

   

   • Pipeline Name: A unique name for the Pipeline, not exceeding 255 characters.

   • API Token: The API token that you created in your UserVoice account.

   • Subdomain: The subdomain of your UserVoice site URL. For example, if your site URL is https://hevotest.uservoice.com, then the subdomain is hevotest.

5. Click TEST & CONTINUE.

6. Proceed to configuring the data ingestion and setting up the Destination.