API to merge call into conference call

[ElridgeDMello]

When we have two (or more) calls ongoing, how do we conference/merge them together (in the UI or programmatically)?

When there are two active calls, here's an example of what we see:

• In Ringcentral Embeddable UI:

.

• Compared to the Ringcentral Phone UI which has a 'Add' button that allows adding the other call to the conference:

It would be ideal to also have the ability to programmatically perform this conferencing action.

We are using the following URL to load the Embeddable:

https://apps.ringcentral.com/integration/ringcentral-embeddable/1.0.3/adapter.js?appKey=...snip...&appSecret=...snip...&appServer=https://platform.devtest.ringcentral.com&enableFromNumberSetting=1&disableConferenceCall=false&disableActiveCallControl=false

Could this be due to Permissions? I didn't get any errors indicating lack of permissions, but here's what is currently configured for the client I'm using:

[embbnux]

Hi @ElridgeDMello , it is supported in Embeddable. You can follow here to enable https://github.com/ringcentral/ringcentral-embeddable/blob/master/docs/disable-features.md#enable-conference-call-feature
For conference call, TelephonySession permission is required in app. But it is still in beta. So need to send email to apply it as mentioned in docs.

[ElridgeDMello]

Hi @embbnux thanks for the response, I have emailed devsupport about this.

A follow up question: Is there a way to programmatically conference two calls together, or is this a future feature on your roadmap?

We would like to have this type of programmatic integration:

User clicks to dial number 1, first call is initiated:

document.querySelector("#rc-widget").contentWindow.postMessage({
  type: 'rc-adapter-new-call',
  phoneNumber: `phone number 1`,
  toCall: true,
}, '*');

After speaking to callee 1, user clicks to dial number 2, second call is initiated (call 1 is put on hold):

document.querySelector("#rc-widget").contentWindow.postMessage({
  type: 'rc-adapter-new-call',
  phoneNumber: `phone number 2`,
  toCall: true,
}, '*');

After call 2 has been initiated, would like to know if there is an API that could be used to conference calls 1 and 2 into a single call, something like this:

document.querySelector("#rc-widget").contentWindow.postMessage({
  type: 'rc-adapter-conference-calls',
  call_ids: [`call 1 id`, `call 2 id`],
}, '*');

If not currently supported/planned, can something like this be added to your future API roadmap?

Thanks in advance!

[embbnux]

Hi @ElridgeDMello, it not currently planned. But it is great idea. Will add it to our roadmap.

[kpandey017]

Is this feature added now?

[embbnux]

Hi @kpandey017 API is not added now. Now user can merge call by Merge button in the widget call control page.