News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Search
Make sure to review our Terms of Use and Community Guidelines.
  Please note the community is currently under maintenance and is read-only.
Home » Developers
Embeddable Widget - include custom medatata when making a call
Tags: embeddable, call handling, webhooks
Mar 10, 2023 at 4:28am   •   3 replies  •  0 likes
Paul Faix

Hi,

I am integrating the RingCentral Embeddable widget to our web app. We want to make & receive calls using the widget. Is there any way to include custom metadata when making a call?

According to docs, these are 2 ways how to make a call (working OK for us):

1)

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

2)

RCAdapter.clickToCall('phoneNumber')


We are listening to call events this way:

window.addEventListener('message', (e) => {
  // process e.data
});


When certain events are received from the widget, we do an AJAX call to our server an register the call (ID of the call, caller, callee, etc.) However, we would like to extend the event's data with some custom data (e.g. some internal IDs, referrer from where the call was made, etc.) so we are able to link the call with proper entities in our system.

Is this possible?

Thank you.

on Mar 20, 2023 at 11:30am   •  0 likes

@Embbnux Ji could you help with this? Thanks

2 Answers
answered on Mar 20, 2023 at 7:05pm  

Hi @Paul Faix Every call in RingCentral has a unique telephonySessionId. You can save this in your system to map other data.


 0
answered on Mar 20, 2023 at 2:37pm  

No, you cannot add extra metadata to the telephony session event. You cannot add extra data to call via the RingCentral embeddable nor via the RC app.

You have to rely on the caller id and implement a look up from your db or a table to map that caller id to an internal id.


 0



A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

PRODUCTS
RingEX
Message
Video
Phone
OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility
QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us