Set Up Playvox Integration

REQUIRED USER ROLE 
Administrator and API User
PERMISSION OVERVIEW
View permissions by role

Before you start

Review the following information before you connect Playvox to Gladly.

  • Make sure you have elevated access to your Playvox account to link Gladly.

Connect with your Playvox implementation specialist

At the start of your engagement with Playvox, you will typically be assigned an implementation specialist to guide you in setup and best practices. This process is usually described and scheduled during the Sales cycle with a Playvox representative.

An implementation of Playvox's WFM product typically takes eight weeks to complete and includes activities like:

  • Setting up the base of the Gladly x Playvox integration.

  • You working with Playvox's implementation specialist to define Inboxes, SLA targets, and more.

  • Playvox provides you with Admin, Schedule, and Agent training.

  • Meeting on a weekly basis on Playvox implementation.

During this time, please utilize your Playvox implementation specialist as your designated/named support resource instead of contacting their support team! You will be introduced to the support process upon completion of your implementation.

Create API token

Start by making sure you have a Gladly user account that has access to create API tokens. To learn how to create users with the API User permission, click here.

Once the user is created, create your API token and take note of the token created. You'll need the token for the next step.

Set up Gladly in Playvox

Do the following from the Playvox homepage.

  1. Click Integrations.

  2. Click Gladly App.

  3. Complete the form details: Manage Gladly integration settings including URL, username, and password fields.

    • Name – Enter a name to call the Gladly connector.

    • Description – Enter a short description for the Gladly connector.

    • Gladly URL – Enter Gladly domain (i.e., {YOUR-COMPANY}.gladly.com}

    • Gladly API User Name – Enter the email address of the Gladly user account used to create the API token.

    • Gladly API User Password – Enter the API token.

  4. Click Save. It will take a moment to complete and generate the option to submit. Once done, click OK.

Next, in order to complete the integration, you need to complete the setup of Tasks and Workstreams.

Set up Tasks and Workstreams

Tasks

You can access it by going to Settings > Tasks > Add New.

Create a task definition for each of the first Agent Status updates, as per the below table. Additional configuration options (e.g., Category) will need to be set up as per your organization settings.

Settings for agent availability with highlighted integration identifier and options for time clock.

The below table is a sample of possible values:

Agent Status Name

Integration Identifier (Regular Expression Matching)

Agent Status - Logged In

LOGGED_IN

Agent Status - Logged Out

LOGGED_OUT

Agent Status - Went Away

Break|Lunch|Meeting|Other|WENT_AWAY

Agent Status - Returned from Away

RETURNED_FROM_AWAY

Agent Status - Availability Updated

AvailableFor:.*|Unavailable

Workstreams

Workstreams is a combination of the Inbox ID and the Inbox Name.

The below table is an example:

Inbox JSON Results

Integration Identifier (Regular Expression Matching)

{

"id": "BBWGXUw8R4W9EBT4oqfXXX",

"name": "Customer_Support",

"disabled": false

}

BBWGXUw8R4W9EBT4oqfXXX|
Customer_Support

Once the Playvox integration has connected successfully, the following activities will occur in the background:

  • A webhook will automatically be created in Gladly to send conversation (started/ended) events into Playvox.

  • Users will start to sync into Playvox (based on matching emails).

  • Agent status events will start to come through.

  • Workstream data will start to come through.