Quick Start

This quick start guide provides a minimal set of steps to get MiraBridge Phone up and running in a supported CRM environment.

Use this guide if you want to test or demo the solution quickly.

1. Prepare Genesys Cloud

Follow these steps:

You will need to note the following:

  • Your Genesys region domain (e.g., mypurecloud.de)
  • The OAuth Client ID generated during the setup

2. Build the Widget URL

2. Build the Widget URL

Use the following pattern:

https://phone.mirabridge.cloud/api/v1/deployment/{deploymentId}/init?region={region}&clientId={clientId}

Replace {deploymentId}, {region}, and {clientId} with your actual values.

Example

If your MiraBridge team provided:

  • deploymentId: main
  • region: mypurecloud.de (Frankfurt)
  • clientId: a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6

Your widget URL would be:

https://phone.mirabridge.cloud/api/v1/deployment/main/init?region=mypurecloud.de&clientId=a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6

Optional Debug Flags

For testing and troubleshooting, append these parameters:

&enableDebug=true&enableDiagnostics=true

Complete example with debugging enabled:

https://phone.mirabridge.cloud/api/v1/deployment/main/init?region=mypurecloud.de&clientId=a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6&enableDebug=true&enableDiagnostics=true

Tip: Always enable debug mode during initial setup and testing. Remove these flags for production deployment.

More details: Widget URL Reference

3. Embed the Widget

Use one of the supported embedding options:

4. Log In and Start Testing

4. Test Your Integration

Once the widget is embedded:

Initial Verification

  1. Launch the CRM platform and navigate to where the MiraBridge widget should appear
  2. Check widget loading: Verify the MiraBridge panel is visible and shows a login interface
  3. Test authentication: Log in using your Genesys Cloud credentials

Validate Core Functionality

If everything is configured correctly:

  • ✅ Genesys softphone interface appears within the CRM
  • ✅ CRM automation scripts initialize (visible in browser console with debug enabled)
  • ✅ Debug logs are visible in browser console (F12 → Console tab)
  • ✅ Agent status synchronizes between Genesys and CRM
  • ✅ No error messages appear in browser console

Common Success Indicators

In the browser console (F12 → Console), look for:

[MiraBridge] Session started: sessionId=abc123...
[MiraBridge] License validated successfully
[MiraBridge] CRM interop layer initialized
[MiraBridge] Agent presence synchronized

In the widget interface:

  • Genesys Cloud interface loads completely
  • Agent status displays correctly
  • Phone controls are responsive
  • No authentication loops or errors

Quick Test Checklist

  • Widget loads without blank screen or errors
  • Genesys Cloud login completes successfully
  • Browser console shows MiraBridge startup messages
  • Agent can change status in Genesys interface
  • No network errors in browser developer tools
  • License consumption appears normal (if monitoring available)

If Issues Occur

  1. Check browser console for error messages
  2. Verify URL parameters are correct and complete
  3. Confirm network connectivity to required domains
  4. Review OAuth client configuration in Genesys Cloud
  5. Test with different browser to isolate browser-specific issues

Next Steps