Skip to content

Registering your application

Before you begin development, you will first need to register your application via the RingCentral Developer Console. This step will provision your application a unique set of credentials used to identify your application on the network, and comes with the benefits listed below.

Benefits

  • Your application will be less likely impacted by users of other instances of Embeddable
  • You will have visibility into the analytics of your user's use of your Embeddable application
  • You will be able to better customize your instance of Embeddable
  • The "FOR DEMO PURPOSES ONLY" banner will be removed from your application

About the "FOR DEMO PURPOSES ONLY" banner

Some users of RingCentral Embeddable may observe a banner that appears above the dialer that reads, "FOR DEMO PURPOSES ONLY." This banner appears when a Developer uses the default client ID and secret that comes bundled with the RingCentral Embeddable library. This default client ID and secret are intended to make trying out Embeddable easy by eliminating the step of having to pre-register an application.

While nothing prevents a developer from using the default client ID and secret, it is strongly recommended that developers register their own application when deploying and using RingCentral Embeddable in a production context.

Steps in registering an application

  1. Login to the Developer Console, creating an account as necessary.

  2. Click "Register App"

  3. Select "REST API App" and click "Next."

  4. Under the Auth section:

    • Select "3-legged OAuth flow authorization code"
    • Select "Client-side web app, e.g. SPA, Javascript"
    • Set "OAuth Redirect URI" to:

    Latest Embeddable version: https://apps.ringcentral.com/integration/ringcentral-embeddable/latest/redirect.html

    For fixed version: `https://apps.ringcentral.com/integration/ringcentral-embeddable/$VERSION/redirect.html`

  5. Under the Security section, add the following "Application scopes:"

    • Call Control
    • Edit Message
    • Edit Presence
    • Internal Messages
    • Read Accounts
    • Read Call Log
    • Read Call Recording (2.x recordings feature)
    • Read Contacts
    • Read Messages
    • Read Presence
    • RingOut
    • SMS
    • VoIP Calling
    • WebSocketSubscription
    • Edit Extensions (2.x SMS templates feature)
    • TeamMessaging (optional)
    • Video (optional for Meeting feature)

For all other parameters you are free to select whatever values your prefer. Consult the Developer Guide to learn more about app registration.