124 lines
7.5 KiB
Markdown
124 lines
7.5 KiB
Markdown
# RingCentral
|
|
|
|
This page contains the setup guide and reference information for the [RingCentral](https://developers.ringcentral.com/api-reference/) source
|
|
|
|
## Prerequisites
|
|
|
|
Auth Token (which acts as bearer token), account id and extension id are mandate for this connector to work, Account token could be received by following (Bearer ref - https://developers.ringcentral.com/api-reference/authentication), and account_id and extension id could be seen at response to basic api call to an endpoint with ~ operator. Example- (https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours)
|
|
|
|
## Setup guide
|
|
|
|
### Step 1: Set up RingCentral connection
|
|
|
|
- Get your bearer token by following auth section (ref - https://developers.ringcentral.com/api-reference/authentication)
|
|
- Setup params (All params are required)
|
|
- Available params
|
|
- auth_token: Recieved by following https://developers.ringcentral.com/api-reference/authentication
|
|
- account_id: Could be seen at response to basic api call to an endpoint with ~ operator. \
|
|
\ Example- (https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours)
|
|
- extension_id: Could be seen at response to basic api call to an endpoint with ~ operator. \
|
|
\ Example- (https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours)
|
|
|
|
## Step 2: Set up the RingCentral connector in Airbyte
|
|
|
|
### For Airbyte Cloud:
|
|
|
|
1. [Log into your Airbyte Cloud](https://cloud.airbyte.io/workspaces) account.
|
|
2. In the left navigation bar, click **Sources**. In the top-right corner, click **+new source**.
|
|
3. On the Set up the source page, enter the name for the RingCentral connector and select **RingCentral** from the Source type dropdown.
|
|
4. Enter your `auth_token, account_id, extension_id`.
|
|
5. Click **Set up source**.
|
|
|
|
### For Airbyte OSS:
|
|
|
|
1. Navigate to the Airbyte Open Source dashboard.
|
|
2. Set the name for your source.
|
|
3. Enter your `auth_token, account_id, extension_id`.
|
|
4. Click **Set up source**.
|
|
|
|
## Supported sync modes
|
|
|
|
The RingCentral source connector supports the following [sync modes](https://docs.airbyte.com/cloud/core-concepts#connection-sync-modes):
|
|
|
|
| Feature | Supported? |
|
|
| :---------------------------- | :--------- |
|
|
| Full Refresh Sync | Yes |
|
|
| Incremental Sync | No |
|
|
| Replicate Incremental Deletes | No |
|
|
| SSL connection | Yes |
|
|
| Namespaces | No |
|
|
|
|
## Supported Streams
|
|
|
|
- user_business_hours
|
|
- company_business_hours
|
|
- callblock_settings
|
|
- blocked_allowed_phonenumbers
|
|
- forwarding_numbers
|
|
- company_call_handling_rules
|
|
- user_call_records
|
|
- user_active_calls
|
|
- call_monitoring_groups
|
|
- call_queues
|
|
- call_record_settings
|
|
- greetings
|
|
- ivr_prompts
|
|
- fax_cover
|
|
|
|
## API method example
|
|
|
|
GET https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/business-hours
|
|
|
|
## Performance considerations
|
|
|
|
RingCentral [API reference](https://platform.devtest.ringcentral.com/restapi/v1.0) has v1 at present. The connector as default uses v1.
|
|
|
|
## Changelog
|
|
|
|
<details>
|
|
<summary>Expand to review</summary>
|
|
|
|
| Version | Date | Pull Request | Subject |
|
|
| :------ | :--------- | :------------------------------------------------- | :------------- |
|
|
| 0.2.22 | 2025-05-24 | [60537](https://github.com/airbytehq/airbyte/pull/60537) | Update dependencies |
|
|
| 0.2.21 | 2025-05-10 | [60159](https://github.com/airbytehq/airbyte/pull/60159) | Update dependencies |
|
|
| 0.2.20 | 2025-05-04 | [59640](https://github.com/airbytehq/airbyte/pull/59640) | Update dependencies |
|
|
| 0.2.19 | 2025-04-27 | [58396](https://github.com/airbytehq/airbyte/pull/58396) | Update dependencies |
|
|
| 0.2.18 | 2025-04-12 | [57968](https://github.com/airbytehq/airbyte/pull/57968) | Update dependencies |
|
|
| 0.2.17 | 2025-04-05 | [57359](https://github.com/airbytehq/airbyte/pull/57359) | Update dependencies |
|
|
| 0.2.16 | 2025-03-29 | [56772](https://github.com/airbytehq/airbyte/pull/56772) | Update dependencies |
|
|
| 0.2.15 | 2025-03-22 | [56231](https://github.com/airbytehq/airbyte/pull/56231) | Update dependencies |
|
|
| 0.2.14 | 2025-03-08 | [55050](https://github.com/airbytehq/airbyte/pull/55050) | Update dependencies |
|
|
| 0.2.13 | 2025-02-23 | [54554](https://github.com/airbytehq/airbyte/pull/54554) | Update dependencies |
|
|
| 0.2.12 | 2025-02-15 | [53968](https://github.com/airbytehq/airbyte/pull/53968) | Update dependencies |
|
|
| 0.2.11 | 2025-02-08 | [53492](https://github.com/airbytehq/airbyte/pull/53492) | Update dependencies |
|
|
| 0.2.10 | 2025-02-01 | [52969](https://github.com/airbytehq/airbyte/pull/52969) | Update dependencies |
|
|
| 0.2.9 | 2025-01-25 | [52517](https://github.com/airbytehq/airbyte/pull/52517) | Update dependencies |
|
|
| 0.2.8 | 2025-01-18 | [51882](https://github.com/airbytehq/airbyte/pull/51882) | Update dependencies |
|
|
| 0.2.7 | 2025-01-11 | [51353](https://github.com/airbytehq/airbyte/pull/51353) | Update dependencies |
|
|
| 0.2.6 | 2024-12-28 | [50716](https://github.com/airbytehq/airbyte/pull/50716) | Update dependencies |
|
|
| 0.2.5 | 2024-12-21 | [50298](https://github.com/airbytehq/airbyte/pull/50298) | Update dependencies |
|
|
| 0.2.4 | 2024-12-14 | [49665](https://github.com/airbytehq/airbyte/pull/49665) | Update dependencies |
|
|
| 0.2.3 | 2024-12-12 | [49367](https://github.com/airbytehq/airbyte/pull/49367) | Update dependencies |
|
|
| 0.2.2 | 2024-12-11 | [49048](https://github.com/airbytehq/airbyte/pull/49048) | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
|
|
| 0.2.1 | 2024-10-29 | [47611](https://github.com/airbytehq/airbyte/pull/47611) | Update dependencies |
|
|
| 0.2.0 | 2024-08-20 | [44448](https://github.com/airbytehq/airbyte/pull/44448) | Refactor connector to manifest-only format |
|
|
| 0.1.15 | 2024-08-17 | [44247](https://github.com/airbytehq/airbyte/pull/44247) | Update dependencies |
|
|
| 0.1.14 | 2024-08-12 | [43830](https://github.com/airbytehq/airbyte/pull/43830) | Update dependencies |
|
|
| 0.1.13 | 2024-08-10 | [43662](https://github.com/airbytehq/airbyte/pull/43662) | Update dependencies |
|
|
| 0.1.12 | 2024-08-03 | [43148](https://github.com/airbytehq/airbyte/pull/43148) | Update dependencies |
|
|
| 0.1.11 | 2024-07-27 | [42591](https://github.com/airbytehq/airbyte/pull/42591) | Update dependencies |
|
|
| 0.1.10 | 2024-07-20 | [42294](https://github.com/airbytehq/airbyte/pull/42294) | Update dependencies |
|
|
| 0.1.9 | 2024-07-13 | [41891](https://github.com/airbytehq/airbyte/pull/41891) | Update dependencies |
|
|
| 0.1.8 | 2024-07-10 | [41433](https://github.com/airbytehq/airbyte/pull/41433) | Update dependencies |
|
|
| 0.1.7 | 2024-07-10 | [41328](https://github.com/airbytehq/airbyte/pull/41328) | Update dependencies |
|
|
| 0.1.6 | 2024-07-06 | [40973](https://github.com/airbytehq/airbyte/pull/40973) | Update dependencies |
|
|
| 0.1.5 | 2024-06-25 | [40480](https://github.com/airbytehq/airbyte/pull/40480) | Update dependencies |
|
|
| 0.1.4 | 2024-06-22 | [40054](https://github.com/airbytehq/airbyte/pull/40054) | Update dependencies |
|
|
| 0.1.3 | 2024-06-06 | [39111](https://github.com/airbytehq/airbyte/pull/39111) | Make compatible with builder |
|
|
| 0.1.2 | 2024-06-04 | [38937](https://github.com/airbytehq/airbyte/pull/38937) | [autopull] Upgrade base image to v1.2.1 |
|
|
| 0.1.1 | 2024-05-20 | [38382](https://github.com/airbytehq/airbyte/pull/38382) | [autopull] base image + poetry + up_to_date |
|
|
| 0.1.0 | 2023-05-10 | [Init](https://github.com/airbytehq/airbyte/pull/) | Initial commit |
|
|
|
|
</details>
|