Skip to main content
The First Step
April 10, 2023
Solved

Key Meaning in Notification Add-in WEBHOOK_URL JWT

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

Employee
April 11, 2023

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

1681177179344.png

4 replies

PhongVu
Community Manager
Community Manager
April 10, 2023

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?

joelamThe First StepAuthor
The First Step
April 10, 2023

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


Once that's clicked, I see


notification-addin-preview.png


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.

Employee
April 11, 2023

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

1681177179344.png

joelamThe First StepAuthor
The First Step
April 13, 2023

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