---
title: "Set Up Playvox Integration"
slug: "set-up-playvox-integration"
description: "Review the following information before you connect Playvox to Gladly. Learn more on how to set up Playvox Intagration in Help Docs."
updated: 2025-01-18T06:47:56Z
published: 2025-01-30T20:02:03Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gladly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Playvox Integration

| **REQUIRED USER ROLE** Administrator and API User | **PERMISSION OVERVIEW** [View permissions by role](https://help.gladly.com/docs/managing-users-and-roles#roles-and-responsibilities) |
| --- | --- |

## 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](https://help.gladly.com/docs/generate-api-tokens-and-create-webhooks/#h-create-api-tokens). To learn how to create users with the API User permission, [click here](https://help.gladly.com/docs/generate-api-tokens-and-create-webhooks/#h-create-a-unique-user-account-for-an-integration).

Once the user is created, [create your API token](https://help.gladly.com/docs/generate-api-tokens-and-create-webhooks/#h-create-api-tokens) 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.](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/agyletime-setup.png)
  - **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.](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/agyletime-tasks.png)

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.