Welcome to the RingCentral Community

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

Key Meaning in Notification Add-in WEBHOOK_URL JWT

Tags: developer sandbox

Apr 10, 2023 at 2:02pm • 3 replies • 0 likes

Joe Lam

Hi all,

We are testing out the Notification Add-in type. Within RingCentral Developers, we can install to team to get a preview of what the { { WEBHOOK_URL }} looks like.
The last URI path is a JWT, and it decodes to be

{
  "ot": "c",
  "oi": "<numericString>,
  "id": "<numericString>
}

May I please ask what each JSON key-value pair represents? Thank you

Joe Lam on Apr 10, 2023 at 2:30pm • 0 likes

Under Apps > {AppName} > Credentials > Tools > Install to team, I get the option to Install.

Once that's clicked, I see

The alphanumeric string, after /v2/, and starting with

eyJhbGciOiJIU...

is a valid JWT.

Upon decoding it, a JSON payload as stated in the first post is returned.

I'd like know what each attribute represents.

Phong Vu on Apr 10, 2023 at 2:16pm • 0 likes

Sorry but I don't understand your question. Can you refer to the source of information you get the JSON object from? And what is the JWT related to this?

Joe Lam on Apr 10, 2023 at 2:31pm • 0 likes

Under Apps > {AppName} > Credentials > Tools > Install to team, I get the option to Install.

Once that's clicked, I see

The alphanumeric string, after /v2/, and starting with

eyJhbGciOiJIU...

is a valid JWT.

Upon decoding it, a JSON payload as stated in the first post is returned.

I'd like know what each attribute represents.

1 Answer

Embbnux Ji answered on Apr 10, 2023 at 6:41pm

Hi @Joe Lam I don't think that you need to decode the JWT string. The JWT is different for every user/chat team/installation. Every user with permission can add same add-in installation into a team multiple times.
You can use full string to identify if current is new installation or editing old installation. When user setup old installation, the RingCentral app will send same JWT string to your app

Joe Lam on Apr 13, 2023 at 11:18am • 0 likes

Thank you.

This helped us understand the scope of {{ WEBHOOK_URL }}

> JWT is different for every user/chat team/installation. Every user with permission can add same add-in installation into a team multiple times

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