PlayVox Connector
Intro
PlayVox is a free collaboration platform designed to manage and motivate people at call centers. Use Domo's PlayVox connector to retrieve user analytics, communication analytics, poll votes, activities, and so on. For more information about integrating PlayVox, visit their website. (https://docs.playvox.apiary.io/)
The PlayVox connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking Cloud App in the toolbar at the top of the window.
You connect to your PlayVox account in the Data Center. This topic discusses the fields and menus that are specific to the PlayVox connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your PlayVox account and create a DataSet, you must have the following:
-
Your PlayVox User ID.
-
Your PlayVox API Key.
To obtain your User ID and API Key, do the following:
-
Go to https://my.playvox.com/login and log in using your domain, username, and password.
-
Click on Settings (the Gear icon) > Integrations.
-
Click API.
-
Copy and paste the User ID and API Key into the correct fields in Domo.
Connecting to Your PlayVox Account
This section enumerates the options in the Credentials and Details panes in the PlayVox Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your PlayVox account. For information about obtaining these credentials, see "Prerequisites," above.
The following table describes what is needed for each field:
Field |
Description |
---|---|
User ID |
Enter the User ID for your PlayVox account. |
API Key |
Enter your PlayVox API Key. |
Once you have entered valid PlayVox credentials, you can use the same account any time you go to create a new PlayVox DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Report menu in which you select a report type, along with other menus which may appear depending on the selected report type.
Menu |
Description |
||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report |
Select a PlayVox report. The following reports are available:
|
||||||||||||||||||||||||
Group By |
Lets you group analytics by a field or a combination of fields separated by commas. For example: created_at, assigned_to, etc. You can find Group By fields in PlayVox's API documentation at http://docs.playvox.apiary.io/. For example, to find the Group By fields for "Coaching," you would do the following:
|
||||||||||||||||||||||||
Query |
Lets you add more complex filters. |
||||||||||||||||||||||||
Enter Poll ID |
Enter the ID of the poll you want to retrieve information for. |
||||||||||||||||||||||||
Enter Fields |
Enter any fields that should be returned by the report, separated by commas. |
||||||||||||||||||||||||
Enter Activity ID |
Enter the ID of the activity you want to retrieve information for. |
||||||||||||||||||||||||
Enter Comment ID |
Enter the ID of the comment you want to retrieve information for. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.