Integration OAuth token expiry notifications

As of the 24.02 release, users are notified when integration tokens are set to expire. When connecting to one of our 3rd party integrations, often times the tokens used to form the connection will expire. Until now, users were not made aware of this in Simpplr, resulting in a poor experience when having to reconnect. Now, a system-triggered notification will make you aware if/when any tokens are set to expire within 10 days from the 3rd party connection, and when you will need to reconnect your account. 

Do note that all tokens used to connect Simpplr to a 3rd party application are controlled by the vendor (e.g., Microsoft, Google, Dropbox, etc.) and cannot be controlled at all by Simpplr. The tokens on these accounts will expire or become invalid from time to time for various reasons like a refresh call fail. Currently, most integrations fail silently, giving the user no notice, and others fail inconsistently.

The Simpplr notification will serve to create a better user experience by informing users of an upcoming token expiration or one that recently happened. This way, users can reconnect their accounts (from App managers to End users) with minimal disruption.

What will the notification look like?

Users will receive a popup notice when first logging in to their intranet in addition to an email sent to their email address tied to Simpplr. The popup notice will inform the user:

"<integration name> has unexpectedly been disconnected. Please reconnect your <integration name> account."

The email will look similar to the image below:

Each notification will prompt the user to head to External apps in their Simpplr profile to reconnect. 

How do I reconnect?

Note:

App managers should not need to reconnect the integration at the application level after receiving this notice. This is only intended for individual users, meaning you will only need to reconnect at the user level.

To connect an integration at the user level:

1. Head to your profile image in the top right of your screen and click.
2. Click My settings > External apps to be redirected.
3. Locate the app in question and choose Connect account.
   
4. Follow any on-screen prompts to accept permissions to finish connecting your account.

Here is a list of links to setup and how-to documentation for each applicable integration:

• Google Calendar
• Outlook Calendar
• Box
• Google Drive
• SharePoint
• OneDrive
• Slack
• Microsoft Teams
• ServiceNow
• Confluence
• LinkedIn
• Twitter