How to Integrate Reality Defender with Genesys Cloud AudioHook

Prerequisites

Before beginning, ensure you have the following:

Requirement	Description
Reality Defender Organization ID	Your unique Reality Defender organization identifier, provided by Reality Defender
Genesys Organization ID	Your unique Genesys Cloud organization identifier, provided by Genesys Cloud
API Key	A generated key of fewer than 255 characters, typically a UUID. Treat this as a sensitive value. May be generated by the customer and shared with Reality Defender, or vice versa
Client Secret	A base64-encoded value. May be generated by the customer and shared with Reality Defender, or vice versa

Before proceeding: Reality Defender requires your Genesys Organization ID to provision the connection on their end. Share it with your Reality Defender customer success representative before beginning this setup.

Note: By default, Reality Defender begins analyzing audio as soon as the connection is established. However, the connection can be configured to wait for a recording.start API call, giving you greater control over which sessions are recorded and analyzed. Refer to the Reality Defender Session API documentation for details.

Step 1: Log In to Genesys Cloud Admin

Open your browser and navigate to Genesys Cloud.
Enter your admin credentials and click Log In.
Select Collaborate / Communicate.

Step 2: Install the AudioHook Monitor from AppFoundry

In the Genesys Cloud Admin portal, enter AppFoundry in the search box and select it.
In the AppFoundry search bar, type AudioHook Monitor.
Locate and click the Genesys AudioHook Monitor tile.
- If the tile displays Configure, the AudioHook Monitor is already installed — proceed to Step 3.
- If not, review the application details and click Install. Follow the prompts to complete installation.
Sign in to AppFoundry for your region if prompted.

Step 3: Add the AudioHook Monitor Integration

Navigate back to the Genesys Cloud Admin page.
In the search bar, type Integrations and select it.
Click Add Integration on the right-hand side of the page.
Locate the AudioHook Monitor tile from the list of available integrations.
Click Install at the bottom of the tile.

Step 4: Configure the Integration

On the Details tab, enter an integration name (e.g., Reality Defender).
Click on the Configuration tab and enter the following Connection URI:
```
wss://app.genesys.os.realitydefender.xyz/audiohook
```
For Channel, select external.
From the left-hand menu, select Credentials and click Configure.
Enter the API Key and Client Secret provided by Reality Defender.
Click Save.

Step 5: Activate the Integration

Navigate back to the main Integrations page.
Locate the Reality Defender AudioHook integration and activate it.
Confirm the Status column displays Active.

If the status shows Error: Verify the Connection URI and credentials for accuracy. Contact Reality Defender Customer Success if the issue persists.

Step 6: Test the Integration

In the Architect dashboard, add an Audio Monitoring component at the appropriate point in your call flow — typically at the very start.
Place test calls and log in to the Reality Defender web portal for your organization to verify analysis results are appearing.
Use the Reality Defender Session API to retrieve real-time analysis results. Analysis sessions are indexed under the Genesys Conversation ID as the session_id for each call.

Summary

Once all steps are complete, Reality Defender will receive and analyze live caller audio from Genesys Cloud in real time.

If you encounter any issues during setup, please contact Reality Defender Support.

How to Integrate Reality Defender with Amazon Connect