RingCentral

RingCentral is a cloud-based telephony platform. You can land analytics data from RingCentral as a data source when landing or replicating data.

A high-level look at RingCentral, including useful links, and the supported features.

See the Schema section for a list of objects available for replication.

A high-level look at this connector, including useful links, and supported features.

Feature/Capability	Support details
Supported Qlik Talend Data Integration projects	Replication projects only. Data pipeline projects are not supported.
Target update methods	Replication tasks: Apply changes Store changes Landing data in a data lake tasks: Change data capture (CDC)
Managing metadata	Manual metadata generation is not required.
Schema evolution	Only the Change column data type operation is supported.
Replication of LOB columns (NCLOB, CLOB, and BLOB)	Not supported.
Scheduled CDC	Required. This is how the target is kept up-to-date with changes to the source. For replication tasks, see Scheduling tasks For lake landing tasks, see Scheduling CDC for lake landing tasks
Notifications	Partially supported Setting notifications for changes in operation
Monitoring	CDC-only, as full load is not relevant for this connector. Monitoring an individual data task
Automatic denesting of JSON column payloads	Not supported. JSON column payloads in source datasets are not denested automatically on the target.

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

Make sure that the account you use has read access to the tables you want to fetch.

Creating the connection

For more information, see Connecting to SaaS applications.

Click Authenticate when you have filled in the required connection settings.
You may be asked to log in to the source application.
A window is displayed with an authentication code.
Copy the code to the clipboard and return to the connection dialog.
Paste the code in Complete authentication with the code provided by the source and click Verify.
Tip noteYou may need to scroll down to see this field.
When status is Verified, the authentication is verified.
Provide a name for the connection in Connection name.
Select Open connection metadata to define metadata for the connection when it has been created.

Connection settings
Setting	Description
Data gateway	Select a Data Movement gateway if required by your use case. Information note This field is not available with the Qlik Talend Cloud Starter subscription, as it does not support Data Movement gateway. If you have another subscription tier and do not want to use Data Movement gateway, select None. For information on the benefits of Data Movement gateway and use cases that require it, see Qlik Data Gateway - Data Movement.
Start Date	Enter the date, in the format `MM/DD/YYYY`, from which the data must be replicated from your source to your target.
API Url	API URL.
Client ID	Client ID.
Client Secret	Client secret.

Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 1.

Depending on your destination, table and column names may not appear as they are outlined below.

call_log

The call_log contains info about your call logs.

Replication Method

CDC

Primary Key

Useful links

RingCentral API method

_contact_id

INTEGER

action

STRING

direction

STRING

duration

INTEGER

extension

OBJECT

This is a nested data structure:

id: INTEGER
uri: STRING

from

OBJECT

This is a nested data structure:

extensionId: STRING
location: STRING
name: STRING
phoneNumber: STRING

STRING

result

STRING

sessionId

STRING

startTime

DATE-TIME

OBJECT

This is a nested data structure:

extensionId: STRING
location: STRING
name: STRING
phoneNumber: STRING

type

STRING

uri

STRING

company_call_log

The company_call_log contains info about company call log records.

Replication Method

CDC

Primary Key

Useful links

RingCentral API method

_contact_id

INTEGER

action

STRING

direction

STRING

duration

INTEGER

extension

OBJECT

This is a nested data structure:

id: INTEGER
uri: STRING

from

OBJECT

This is a nested data structure:

location: STRING
name: STRING
phoneNumber: STRING

STRING

result

STRING

sessionId

STRING

startTime

DATE-TIME

OBJECT

This is a nested data structure:

location: STRING
name: STRING
phoneNumber: STRING

type

STRING

uri

STRING

contacts

The contacts contains info about corporate users of federated accounts.

Replication Method

Full Table

Primary Key

Useful links

RingCentral API method

account

OBJECT

This is a nested data structure:

id: INTEGER

email

STRING

extensionNumber

INTEGER

firstName

STRING

INTEGER

jobTitle

STRING

lastName

STRING

name

STRING

phoneNumbers

ARRAY

This is a nested data structure:

phoneNumber: STRING
type: STRING
usageType: STRING

status

STRING

type

STRING

messages

The messages contains info about an extension mailbox’s messages.

Replication Method

CDC

Primary Keys

conversationId

Useful links

RingCentral API method

_contact_id

INTEGER

availability

STRING

coverIndex

INTEGER

creationTime

DATE-TIME

direction

STRING

faxPageCount

INTEGER

faxResolution

STRING

lastModifiedTime

DATE-TIME

messageStatus

STRING

priority

STRING

readStatus

STRING

type

STRING

uri

STRING

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here