At Beehive AI, we can integrate with your Qualtrics account and pull data from the programs of your choice. Qualtrics integration will allow data to automatically ingest into our platform for a consistent stream of analysis as your surveys continue collecting data!
To provide Beehive AI with the proper credentials for integration, follow the steps below to locate your Datacenter ID and Client Secret.
Please be advised:
Some steps within the Qualtrics Integration process (outlined below) may necessitate administrative permissions in both Qualtrics and Beehive. If you encounter any issues due to insufficient permissions, please reach out to your Workspace administrator for assistance.
Locating your “Datacenter ID” & Creating a “Client Secret”
Locating your Datacenter ID
Login to Qualtrics XM - Experience Management Software, then select the user settings icon in the top right-hand corner.
Select Account Settings in user settings dropdown.
Next, select Qualtrics IDs
Then (in the IDs tab) find your Datacenter ID in the User section.
Creating a Client Secret
Login to Qualtrics XM - Experience Management Software, then select the user settings icon in the top right-hand corner.
Select Account Settings in user settings dropdown.
Next, select Qualtrics IDs
Navigate to OAuth Client Manager, and then select + Create Client
Enter Name and Contact information
Next, define Scopes from the dropdown either by finding them in the list or searching for them.
Select your preferred scope by selecting them from options listed in the dropdown. Continue for all the scopes you wish the client to have.
Required scopes for Beehive AI integration:
read:survey_responses
read:surveys
Select the Authorization Code as the Grant Type
Finally, enter the Redirect URL, click + Create Client and see the Client ID and Client Secret. Note both before navigating away, as this will not be displayed again later.
Note: workspaceName in the redirect URL (shown in the image above) should be replaced by your Beehive AI workspace name. This workspace name is spelling and case sensitive, and can be found in your workspace URL.
For ease of use, you can copy the redirect URL in your Beehive AI Connections page, under step 6 of the Qualtrics integration path:
Finalize your Qualtrics Integration in Beehive AI
Once you have successfully located your Datacenter ID and created your Client Secret, then you can proceed to the Beehive AI platform to finish setting up your Qualtrics integration, as shown in the steps outlined below.
Note: The same person who created the OAuth Client needs to be the one to authenticate Qualtrics in the Beehive platform.
Finalize Qualtrics Integration
Navigate to your Beehive AI workspace Connections page.
Select "Qualtrics" from the "Apps & Integrations" listed there.
Select "+ Add Connection"
Enter the following information in the "Authenticate" pop-up
Datacenter ID
Client ID
Client Secret
Select "Continue" to add a connection. A login window will pop up, asking you to log in and approve the app:
Fill out the "Connect" form by...
Selecting your desired Survey
Selecting a language
Selecting a brand (in this case "demo" is filled in as an example)
Scheduling the import of the selected survey
Specifying the update interval for the import
Select "Finish" to complete the Authentication and Connection process.
See your newly added connection in the "Qualtrics" table
Supported File Types
Survey files that are connected to Beehive AI through Qualtrics integration will only be ingested in CSV format.
Common Errors
Experiencing errors? Check out the following examples of common errors and how to resolve them.
Invalid Redirect URL
Invalid Redirect URL
Error:
{"error":"invalid_request","error_description":"Invalid redirect uri does not match one of the registered values."}
Why am I seeing this?
It is likely that when you created your Client, you accidentally copied or entered the wrong Redirect URL.
How to fix:
Navigate to Step 6 in the "Qualtrics" section of your Beehive AI Connections page.
Copy the Redirect URL displayed there.
In your Qualtrics OAuth Client Manager, Create a new Client or edit an existing Client using this Redirect URL.
Whitelabel Error Page
Whitelabel Error Page
Error:
Whitelabel Error Page
This application has no explicit mapping for /error, so you are seeing this as a fallback.
Mon Oct 07 21:21:45 GMT 2024
There was an unexpected error (type=Internal Server Error, status=500).
Why am I seeing this?
It is likely that when you created your Client, you accidentally selected the wrong Grant Type. Instead of "Authorization Code" you may have selected "Client Credentials."
How to fix:
In your Qualtrics OAuth Client Manager, Create a new Client using the correct Grant Type "Authorization Code."
For more information view the Qualtrics Instruction page, and/or get in touch with a Beehive AI representative.
Happy integrating! 🐝