Skip to main content

Overview

The RingCentral Embeddable integration allows you to make and receive phone calls directly in your browser without needing a physical desk phone. This guide covers everything you need to know to start making calls.

Requirements

Browser Compatibility

Note: If your browser doesn’t fully support in-browser calling, the system will automatically fall back to “RingOut” mode, which calls your desk phone first, then connects you to the recipient.

Hardware Requirements

  • Microphone: Required for making calls
  • Headset: Recommended for best audio quality
  • Stable Internet: Minimum 1 Mbps upload/download

Getting Started

Step 1: Enable Embeddable for Your Organization

Organization administrators can enable in-browser calling from:
1
  • Navigate to SettingsCE Module SettingsTelephony tab
  • Toggle Enable Embeddable Widget to ON
  • Choose your preferred Widget Position (bottom-right is recommended)
  • Click Save
  • Step 2: First-Time Setup

    When you first use the calling widget:
    1
  • Widget Appears: A phone widget will appear in the corner of your screen
  • Sign In: Click “Sign In” to authenticate with RingCentral
  • OAuth Flow: A popup window will open for RingCentral login
  • Allow Microphone: Grant microphone permission when prompted
  • Ready to Call: The widget shows your extension number when ready
  • Step 3: Grant Microphone Permission

    When prompted by your browser:
    1
  • Click Allow to grant microphone access
  • If you accidentally denied, click the lock icon in your browser’s address bar
  • Find “Microphone” and change to “Allow”
  • Refresh the page
  • Making Calls

    Click-to-Call

    The easiest way to make a call:
    1
  • Find a contact or partner with a phone number
  • Click the phone icon (📞) next to their number
  • The call will initiate automatically
  • Visual Indicators:
    • 📞 Phone icon = RingOut mode (desk phone callback)
    • 🎧 Headset icon = WebRTC mode (browser calling)

    Using the Dialer

    To dial a number manually:
    1
  • Click on the calling widget to expand it
  • Use the number pad or type the number
  • Click the green call button
  • Call Controls During a Call

    Receiving Calls

    Screen Pop Notifications

    When someone calls you:
    1
  • A notification appears in your browser
  • It shows the caller’s name (if known) or phone number
  • Click Answer to accept in your browser
  • Click Decline to send to voicemail
  • Caller Context

    If the caller matches a contact or partner in your CRM:
    1. A Contact tab appears in the widget showing:
      • Contact name and status
      • Phone and email
      • Recent activities
    2. A Partner tab appears if the caller is a partner:
      • Partner name and type
      • Recent referral count
      • Quick link to view full record

    Voicemail

    Accessing Voicemails

    1
  • Click the calling widget to expand it
  • Navigate to Messages section
  • Click on a voicemail to play it
  • Use playback controls to listen
  • Voicemail Notifications

    • The widget shows a badge when you have unread voicemails
    • Check voicemails regularly for important messages

    Troubleshooting

    ”Microphone access denied”

    Problem: Browser is blocking microphone access. Solution:
    1
  • Click the lock/info icon in your browser’s address bar
  • Find “Microphone” settings
  • Change to “Allow”
  • Refresh the page
  • ”Widget not loading”

    Problem: The calling widget isn’t appearing. Solution:
    1
  • Check your internet connection
  • Refresh the page
  • Clear browser cache
  • Try a different browser (Chrome recommended)
  • Contact your administrator to verify settings
  • ”Using phone callback instead of browser calling”

    Problem: Calls are going through your desk phone instead of browser. Solution: This happens when:
    • Your browser doesn’t support WebRTC
    • Microphone permission is denied
    • Organization has disabled WebRTC calling
    If you prefer browser calling:
    1
  • Use Chrome or Edge browser
  • Grant microphone permission
  • Contact your administrator
  • ”Call quality is poor”

    Problem: Audio is choppy or unclear. Solution:
    1
  • Use a wired internet connection instead of WiFi
  • Close other bandwidth-heavy applications
  • Use a headset instead of laptop speakers
  • Move closer to your WiFi router
  • ”Cannot sign in to RingCentral”

    Problem: OAuth popup doesn’t work or errors. Solution:
    1
  • Disable popup blockers for this site
  • Try in an incognito/private window
  • Clear cookies for ringcentral.com
  • Contact your administrator for credentials
  • Fallback: RingOut Mode

    If in-browser calling isn’t available, the system automatically uses RingOut:
    1
  • Click the phone icon to call
  • Your desk phone will ring first
  • Answer your desk phone
  • The system then dials the recipient
  • You’re connected through your desk phone
  • When RingOut is used:
    • Browser doesn’t support WebRTC
    • Microphone permission is denied
    • Organization prefers desk phones
    • Network issues prevent WebRTC

    Tips for Best Experience

    1
  • Use Chrome or Edge for best browser compatibility
  • Use a headset for professional audio quality
  • Keep the widget visible to see incoming calls
  • Enable notifications in your browser for screen pops
  • Check voicemail regularly to stay responsive
  • Log calls promptly using the disposition workflow
  • Need Help?

    If you continue to experience issues:
    1
  • Contact your organization administrator
  • Include:
    • Browser name and version
    • Error messages (if any)
    • Steps to reproduce the issue
  • Check the browser console for errors (F12 → Console)

  • This guide covers CE-14: RingCentral Embeddable Integration. For technical documentation, see the Platform Telephony README.