Skip to main content

Ringcentral Setup

Configuring RingCentral for use with Caddi

Updated over 3 months ago

Oauth App Setup in RingCentral

To work with Caddi, users must first create an Oauth app in RingCentral as documented by RingCentral - instructions specific to Caddi are provided below.

  1. Login to RingCentral

  2. Navigate to Console/Apps and click the Create App button

  3. Select REST API App under What type of app are you creating? and then click Next.

  4. Under Authentication select 3-legged OAuth flow authorization code and then select Server-side web app.

  5. Under Authentication set the redirect URL to https://app.trycaddi.com/oauth-callback

  6. Under Security add the permissions required for your automation.

    1. The permissions Caddi recommends by default are ReadContacts ReadCallLog ReadMessages

    2. RingCentral API scopes are documented here https://developers.ringcentral.com/guide/basics/permissions

  7. Under Security select the option This app is private and will only be callable using credentials from the same RingCentral account.

Application Setup in Caddi

Now that the app is configured in RingCentral, it can be added to Caddi.

  1. Navigate to https://trycaddi.com and log in

  2. On the left, select the Credentials option

3. Scroll to the Enterprise Connectors section at the bottom and click the Setup button for RingCentral

4. Enter the information for your RingCentral application

  • Client ID - the client ID of the app you created in RingCentral

  • Client Secret - the client secret of the app you created in RingCentral

5. Click the Save Configuration button

6. You should now see your newly-created connection at the top of the Enterprise Connectors section.

7. Click the + Connect for your new RingCentral connection, then the Connect button in the modal. You will be redirected to the RingCentral authorization prompt (you may need to login first). Approving the connection will send you back to the Caddi website.

8. Confirm the connection is working properly by clicking on the Manage button, then the Refresh button in the modal that pops up.

  • After you click Refresh you should see another green success message at the bottom of the screen.

Did this answer your question?