Installation

To set up the integration, install the Telephony Integration Plugin into your Workbooks database. The integration can only be done by the System Admin.

Step 1: Install the Plugin in Configuration

Start > Configuration > Automation > Plugins > Add Plugin.

From here, select Script Library and then Telephony Integration. Select Install to begin the Plugin Installation.

The Plugin asks for confirmation to go ahead with the installation. When you click continue, a number of Custom Fields and Automated Processes required by the integration will be automatically installed. More information on the configuration that is created can be found here.

Once the installation is complete and a success message appears, close the installation window.

Step 2: Create Custom Fields and Processes through the Plugin

Navigate to Configuration > Other Integrations > Telephony Integration

Select RingCentral from the list of Providers and click Continue

Once continue is clicked, the plugin will prompt you to Install Dependencies. These are all the Processes and Custom Fields that are required for the integration to function. More details of the custom fields and processes can be found here

Step 3: Authenticate RingCentral

Whoever is installing RingCentral needs to have full permission to the admin module within RingCentral in order to authenticate the integration. 

Once the Custom Fields and Processes have been installed, you will be prompted to Authenticate RingCentral by the Plugin.

Note: When clicked a new window will pop open asking you to login to RingCentral. This window may be blocked by your browser’s pop-up blocker. 

Click Authenticate with RingCentral. This will take you to the RingCentral login page where you will need to enter your RingCentral credentials. Once you are logged in, you will be asked to authorise Workbooks to use the credentials you have logged in with. To continue using the integration, click “Authorise”.

The integration requires access to different areas of RingCentral to enable a successful sync. Please ensure all the permissions/capabilities that are pictured above in the Access Request screenshot are included in your RingCentral licence. 

Once authorisation is complete, you will be taken back to the authentication screen of the plugin. Click Continue. 

Step 4: Enable Processes from Plugin

The final step of the integration is to enable all processes by clicking Enable Processes within the Plugin.