Welcome to Mediabriz for Genesys Cloud.

This guide explains how to activate and configure Mediabriz after installing it from the Genesys AppFoundry.

The setup process only takes a few minutes.

Step 1 - Install Mediabriz from Genesys AppFoundry

Install Mediabriz from the Genesys AppFoundry using the standard installation flow.

During the process:

1. Approve the installation
2. Review the post-activation message
3. Complete the installation

Once completed, the MediaBriz integration is automatically created inside your Genesys Cloud organization.

Important:
The integration is initially created as Inactive and requires additional configuration before users can access Mediabriz.

Step 2 - Configure the MediaBriz Integration

After the installation completes, you will be taken to the:

MediaBriz integration page
(IT and Integrations → Integrations → MediaBriz)

Configure the integration using the following steps.

Assign the Required Permission

Inside the integration:

Go to:

Details → Permissions

Locate the permission:

integration:cloudBriz:admin (cloudBriz - Admin)

Add integration:cloudBriz:admin (cloudBriz - Admin) to an existing or new role and assign that role to the user running the setup wizard. To run the setup wizard, this user must also have all five standard Genesys administrator permissions listed in Step 3. Both sets of permissions are required. This permission provides full access to Mediabriz Insights dashboards, actions, and configuration. Admin users do not also need integration:cloudBriz:view.

For users who should only view Mediabriz Insights dashboards, assign integration:cloudBriz:view (cloudBriz - View) instead. View users can see the dashboards but cannot access actions or configure them.

Important:Genesys does not automatically assign integration:cloudBriz:admin to administrators.
It must be granted manually.

Configure Group Filtering

Return to the MediaBriz integration, then go to:

Configuration → Properties → Group Filtering

Select an existing group, or create a new group in:

User Management → Groups

Then add:

• The user who will run the Mediabriz setup wizard or who needs access to Mediabriz global settings. This is required to complete the installation.
• Any additional users who need access to Mediabriz Insights after setup.

Assign each additional user a role with integration:cloudBriz:view for dashboard-only access, or integration:cloudBriz:admin for full access. Admin users do not need a separate View permission.

Note:
Make sure the Iframe Sandbox Options field includes the following values:
allow-scripts,allow-same-origin,allow-forms,allow-modals,allow-popups

---

Optional Agent Permissions

externalContacts:contact:view  - Required only for organizations using External Contacts and for agents who need to view External Contact details in the contact card.

conversation:transcription:view  - Optional. Required only for agents who need to see the live transcript of a voice call in Mediabriz. Add it to the agent's role in Genesys Cloud. It is a user permission, not an OAuth scope, so nothing changes in the Mediabriz integration or its OAuth client. Agents without it see Transcription is not available for your account on the voice call's overview. Everything else in Mediabriz works as before.

Save and Activate the Integration

After completing the configuration:

1. Save the integration
2. Activate the integration

       3. Refresh the Genesys Cloud page before continuing.

Step 3 - Launch the Quick Setup Wizard

Open the Apps menu inside Genesys Cloud and click:

MediaBriz

This launches the Mediabriz quick setup wizard.

Required Genesys Permissions

The user running the setup wizard must have BOTH integration:cloudBriz:admin (cloudBriz - Admin) AND all of the following standard Genesys administrator permissions:

• integrations:integration:view
• integrations:integration:edit
• oauth:client:view
• oauth:client:add
• oauth:client:edit

These permissions are typically already included in the default Admin role.

Next, Install the Mediabriz extension.

Need Help?

• Submit a Support Ticket

Or visit the:

• Mediabriz Support Center