Skip to content

RingCentral Embeddable 3.0 Beta

3.0.0

RingCentral Embeddable 3.0 marks the next generation of this popular RingCentral product, allowing developers to easily embed a RingCentral phone, SMS client, and more into any webpage or web application. Version 3.0 delivers a significantly enhanced calling experience and modern UI architecture.

100% Backwards Compatible

RingCentral Embeddable 3.0 is fully backwards compatible with 2.x applications. You can upgrade seamlessly without breaking changes.

Beta Release

Version 3.0 is currently in BETA. We welcome feedback and suggestions for improvements.

What's new in 3.0

Enhanced UI with Side Panel

New RingCentral Embeddable 3.x UI

The most significant improvement in 3.0 is the side panel architecture. This new design allows users to access detailed information without leaving the main list view, creating a more fluid and efficient user experience.

Supported detail pages:

  • Call recording page - Access and manage call recordings
  • Voicemail details page - Listen to and manage voicemails
  • SMS conversation page - View full message threads
  • Fax details page - Review sent and received faxes
  • Contact details page - Complete contact information
  • Chat conversation page - Team messaging conversations
  • Log call page - Call logging and notes
  • Log messages page - Message logging interface

Call Widgets

Call Widgets represent a powerful new capability that allows developers to inject dynamic, contextual content directly into the calling experience.

call-widget-apps

Key features:

  • Contextual integration - Widgets appear automatically during active calls
  • Dynamic content - Display CRM data, support cases, or any custom information
  • Real-time updates - Content updates based on call context and user interactions
  • Flexible UI - Built on JSON Schema for maximum customization

Learn more about Call Widgets

Get comprehensive details about implementing call widgets in the call widget documentation.

Getting started with 3.0

Quick setup

Update your application to use the 3.x build:

Add the following code to your website's header to embed RingCentral Embeddable 3.0:

<script>
  (function() {
    var rcs = document.createElement("script");
    rcs.src = "https://apps.ringcentral.com/integration/ringcentral-embeddable/3.x/adapter.js?clientId=YOUR_RINGCENTRAL_CLIENT_ID&enableSideWidget=1"; // (1)!
    var rcs0 = document.getElementsByTagName("script")[0];
    rcs0.parentNode.insertBefore(rcs, rcs0);
  })();
</script>
  1. Replace YOUR_RINGCENTRAL_CLIENT_ID with your actual RingCentral application client ID

Add the following iframe anywhere on your webpage:

<iframe 
  width="300" 
  height="500" 
  allow="microphone" 
  src="https://apps.ringcentral.com/integration/ringcentral-embeddable/3.x/app.html?clientId=YOUR_RINGCENTRAL_CLIENT_ID&enableSideWidget=1">
</iframe>

Required configuration

Add the following redirect URI to your RingCentral application settings in the Developer Console:

https://apps.ringcentral.com/integration/ringcentral-embeddable/3.x/redirect.html

Important

The redirect URI must be added to your RingCentral application configuration, or authentication will fail.

Migration from 2.x

Seamless upgrade

Migrating from 2.x to 3.0 is straightforward:

  1. Update the URL - Change latest or 2.x to 3.x in your script src
  2. Add enableSideWidget - Include enableSideWidget=1 to access new features
  3. Update redirect URI - Add the 3.x redirect URI to your app settings
  4. Test thoroughly - Verify all existing functionality works as expected

Next steps

Ready to get started with RingCentral Embeddable 3.0?

Online demo Call widgets docs