Configure and activate AudioHook Monitor in Genesys Cloud

These instructions assume that you are an advanced user. However, if you anticipate or encounter issues, or are unfamiliar with the configuration process, best practice recommends that you ask your administrator or a member of your technical support team for assistance.

Note: AudioHook Monitor is a Genesys Cloud premium application. For more information, see What are premium applications? and About premium applications.

Before you begin

Before you begin, perform these tasks:

  1. Install AudioHook Monitor from Genesys AppFoundry.
  2. Add an AudioHook Monitor instance for each endpoint.

Open the AudioHook Monitor configuration

To configure the AudioHook Monitor, follow these steps:

  1. In Genesys Cloud, click Admin.
  2. Under Integrations, click Integrations.
  3. Select AudioHook Monitor.
  4. (Optional) In the Details tab, Genesys highly recommends that you enter a unique name for the integration that you want to configure. For example, “AudioHook – Provider Name”.
  5. Click the Configuration tab.

Configure AudioHook Monitor

When you add your Connection URI, make sure that it begins with wss:// and not https://.

  1. Click the Properties tab.
  2. Under Channel, select whether to stream internal (agent), external (customer), or both.
    Note: A value of “both” means that a two-channel (stereo) stream with an external party on the left channel and an internal party on the right; values of “external” and “internal” provide a single-channel stream. Unless you have an explicit reason to select internal or external only, best practice recommends that you select both. This selection allows AudioHook Monitor to choose the value.
  3. Under Connection URI, select the WebSocket endpoint in which to stream the audio.
  4. (Optional) In the Advanced tab, enter any additional values that you want to send to the AudioHook server in the JSON format. 
    The additional configuration is sent to the AudioHook server as unaltered JSON data using the customConfig property in the Open command.

This image displays example AudioHook Monitor configuration properties.

Click the image to enlarge.

Configure AudioHook Monitor Properties

Add AudioHook Monitor credentials

  1. Click the Credentials tab.
  2. Click Configure. The Configure Credentials dialog prompts you for the values that you obtained from the endpoint to which you want to connect:
    • API Key: The API key that passes to servicers in the X-API-KEY header.
    • Client Secret: The value that you use to sign connection requests and allow servers to authenticate the client. Obtain this credential from your service provider.
  3. Click OK.
  4. Click Save.
  5. Select the Details tab.
  6. To activate the integration, click Inactive. The Change Status dialog appears and asks you to confirm that you want to activate the AudioHook Monitor.
  7. Click Yes. 

This image illustrates example data in the Configure Credentials dialog.

Click the image to enlarge.

Configure AudioHook Monitor Credentials

After a few seconds, the installation opens a connection check to the server. If the connection check succeeds, then the status changes to Active. If the check fails, then an error appears.

Validate the AudioHook Monitor integration

When you make and save changes under the Configuration tab, make sure that you validate your changes to make sure that you configured the integration correctly. To do so, complete the following steps:

  1. Set the Status switch to Inactive and click Yes.
  2. Set the Status switch to Active again and click Yes. If the configuration is correct and Genesys Cloud encounters no errors during the activation process, the integration status changes to Active.