Limeade for Viva Connections Requirements
For organizations to leverage the Limeade for Viva Connections offering they will require the following minimum requirements.
Subscription to Limeade Well-being. To Learn more about Limeade and Limeade Well-Being visit www.limeade.com
Microsoft 0365 subscription
Microsoft SharePoint Online employee experience portal configured for Viva connections
Microsoft Teams deployment (for mobile and full viva connections experience)
Microsoft Azure AD configuration for authentication
See our troubleshooting guide if you are having issues or contact: email@example.com
Limeade for Viva Connection Cards
Limeade offers 8 adaptive cards that address different use cases allowing organizations to target specific resources or nudges to their employees. Below are the key details to understanding how to use each card to elevate your employee’s well-being journey.
Limeade’s Viva Connections offering is made of adaptive cards. Our adaptive cards provide a personalized experience unique to the employee. Limeade looks up an individual in our platform based on their Microsoft Azure AD identity.
The employee must be eligible in an existing Limeade program to get the personalized experience. An employee’s eligibility is determined by an organization's eligibility file that is provided to Limeade.
If an employee is not eligible or the organization is not a Limeade customer, the employee will be presented with a generic marketing experience.
If eligible, cards will verify if a user is registered or not in the Limeade Well-being program. If the user isn’t registered, all cards will ask the user to register and tapping/clicking the card will navigate the user into the program web experience or the Limeade ONE mobile app, prompting the user to follow the registration flow for the program.
When eligible employees are registered, the cards adapt and display a personalized employee experience specific to the card.
Card Security and Authentication
Limeade uses the secure context of the employee’s Azure AD identity in the Viva experience to identify and display personalized content. Users are not required to authenticate to view or interact with the adaptive cards directly. Some card experiences may move the employee to Limeade’s platform which may require the user to authenticate depending on the organization’s configuration in the Limeade platform.
Limeade or Microsoft do not store any user data outside the Limeade platform. All personalized experiences are rendered just in time from the Limeade secure platform and are not stored or cached on client devices, nor in Microsoft’s servers.
Cards can be deployed in two sizes: Medium or Large.
Example medium and large card sizes:
Each card has a Limeade product icon and the organization’s Well-being program name.
The remaining card surface can contain images, text, and/or call-to-action buttons.
When cards are clicked/tapped the employee is either navigated to a destination in the Limeade platform or display a card Quick View which is an interactive experience that provides additional information or resources to the employee.
Example Quick View:
Limeade for Viva Connections supports the following languages.
- English (United States)
- English (United Kingdom)
- Spanish (Latin America)
- French (Canada)
- Portuguese (Brazil)
- Chinese (Simplified)
Limeade for Viva Connections supports an accessible experience for all employees, supported by existing Viva Connections accessibility capabilities.
Limeade Program Card
The Limeade Program card is intended for organizations that want to provide a simple and easy experience to promote and link to their well-being program via their viva connections dashboard. When tapped or clicked, the card will navigate users to their Limeade well-being program.
No quick views are available with this card.
Limeade My Well-Being Card
The Limeade My Well-Being card is intended to help organizations that want to nudge their employees to improve their well-being by first prompting employees to complete the Well-being assessment, the key action needed for Limeade is to provide employees a personalized experience.
Once the assessment is completed, the card then nudges users based on how many days since they have completed an activity to encourage employees to develop a habit of working on their well-being daily.
The My Well-Being card also has a quick view capability when clicked which provides employees a radar graph of their assessment results (when completed) and allows users to browse recommended activities based on their well-being results.
Clicking the activity details button navigates the employee to the Limeade experience allowing the employee to easily participate in the suggested activity and add it to their personalized program.
Limeade Featured Activities card
The Limeade Featured Activities card delivers the ability for organizations to highlight featured activities that employees have not completed. Featured activities are typically activities that an organization wants their employees to participate in. If no featured activities are found, the employee is prompted to discover other personalized activities by navigating them to the Limeade Discover page.
When outstanding featured activities exist, clicking the card will display a quick view allowing employees to browse these activities.
Limeade My Activities Card
The Limeade My Activities Card is designed to meet employees where they are at in their well-being journey and nudge them to keep progressing in the program. The card renders with the employee’s current level of achievement and how many points remain to get to the next level.
When clicked, a Quick View opens providing employees more details related to their program progress while also providing quick access to other progress details.
Clicking next/back cycles through the employee's My Activities in their plan so they can see their plan in the quick view and easily access the activities they wish to work on at the moment.
Limeade Listening Card
The Limeade Listening card is intended to elevate the visibility of your organization’s employee listening initiatives. It will first try to prompt nudge employees to take surveys that are still not completed.
If there are no outstanding surveys for the employee, the card supports a custom configuration allowing organizations to link to a listening app extension deployed to your Limeade program.
Examples of Listening extensions are:
- Limeade Ask HR app
- Limeade Suggest and Activity app
- Limeade Safe Space
- Limeade Post a Message app
- Limeade Cheers app
- Limeade WebView app provides access to other listening tools
- Any web URL to another Listening tool
- Any Poll communications post
If no URL is configured users will be navigated to the program home page/screen. It is recommended that a URL is configured in the card configurations.
When outstanding surveys exist, the card will display all outstanding surveys in an activity carousel format, enabling employees to easily access the survey from the card.
Limeade Discover Activities Card
The Limeade Discover Activities card is designed to provide an easy way for employees to discover new well-being, engagement and inclusion activities in their program. This card empowers users to work on any of the 5 life areas: Reaching Potential, Physical, Capacity for Change, Work and Health Risks.
When tapped or clicked, this card displays a carousel of life areas where employees can easily navigate to view all activities by different dimensions related to each life area.
Limeade Steps Card
The Limeade Steps card is designed to provide employees a quick glance at their daily physical activity based on a connected fitness tracker. If users have not connected a device, the card is intended to prompt users to connect their fitness tracker by navigating to the connect device page in the Limeade platform.
If a device is connected, employees are cheered for keeping or exceeding their 7-day average.
If below their 7-day average, employees are prompted to be more physically active by encouraging them to move.
If the employee’s data is missing up-to-date information, the card will encourage users to sync their device.
The card quick views provide more in-depth insights into the employee's daily and weekly activity. Today’s steps, distance traveled, and calories burned are provided to the users with 7-day trend-charts accessible via the next and previous button.
Limeade Resources Card
The Limeade resources card allows administrators to deploy a bookmark to any Limeade ONE app extension. Limeade App Extensions are configurable experiences that provide information and tools to employees. Clicking or tapping this card will navigate the user directly to the configured app extension. Potential use cases are:
- Ask HR
- Join ERG
- Benefits Wallet
- Video resources
- File resources
- Share a well-being moment and other social posting experiences.
If no app extension is added to the configuration, the card will navigate employees to the services page/screen of the Limeade ONE Experience elevating all available app extension resources available to the employee.
No quick views are available with this card.
Limeade for Viva Connections Deployment
Configuring Viva Connections
Limeade for Viva Connections requires a pre-configured Viva Connections dashboard. Refer to Microsoft’s documentation for Viva Connection: https://docs.microsoft.com/en-us/SharePoint/guide-to-setting-up-viva-connections
Granting Limeade Azure AD APP Consent
Limeade for Viva Connections provides a Single-Sign-On (SSO) experience for all data displayed in the adaptive cards. To achieve this experience, Limeade uses the currently logged-in users' Azure AD profile to log into Limeade and access their data in Limeade. It is required to grant the Limeade “limeade-viva-proxy” azure AD application the “Sign in and Read profile” permissions on behalf of your employees.
- To grant this permission, an Administrator in your organization with Azure AD administrator permissions needs to navigate to the following URL and log in with their Azure AD administrator account.
- Once Logged in the administrator should review the requested permissions and check the consent on behalf of your organization check box and click accept
The administrator will get the following 403 forbidden screen. This is expected to indicate completing the steps properly. The error is an outcome of Limeade’s high-security configurations and Limeade hopes to find a workaround to this issue in the future.
Installing Limeade for Viva Connections
After successfully consenting access the next step is to install Limeade for Viva Connections in your SharePoint instance. The following tasks should be completed by a SharePoint administrator.
- Installing Limeade for viva connections can be completed by navigating to your SharePoint App catalog. Please refer to Microsoft’s documentation for SharePoint App Catalogue: https://docs.microsoft.com/en-us/sharepoint/use-app-catalog
- Navigate to your SharePoint Store
- In the SharePoint store Search for Limeade
- Click the App Store search result
- In the entry detail, view click add to add the app to your SharePoint instance.
- Next, navigate to your Homesite and click the settings icon top right and then select add app.
Granting Sharepoint API Access Permissions
The next step for a successful deployment is to grant the needed permissions for user impersonation in SharePoint’s administration console. This task will require to be completed by a SharePoint administrator.
- Navigate to your SharePoint admin center.
- EG: https://limeade-admin.sharepoint.com/
- Click Advanced -> API access on the left menu
- Select the pending request and click Approve
- Navigate to your SharePoint admin center.
Adding Limeade Cards to your VIVA Connections Dashboard
Now that all the permissions have been granted and the app installed, the last step is to add cards to your Viva Connection Homesite dashboard by navigating to the dashboard, clicking edit, and adding any of the Limeade cards that align with your organization's goals.
If the Limeade platform is inaccessible, employees will see the following experience.
- Are all the steps for permissions been followed,? Please verify.
- Do you have any errors related to the app in the SharePoint catalog?
If this issue persists, please contact firstname.lastname@example.org
Please sign in to leave a comment.