Transitioning from Workplace to Viva Engage: Migration Process

What were the challenges we faced ? 

We faced significant obstacles in the process of migrating posts from Meta Workplace to Viva Engage. Utilizing the Microsoft Graph API presents complexities due to its limited capabilities. While the MS Graph API facilitates the creation, viewing, updating, deletion, and member assignment within communities, it lacks endpoints for migrating content (posts).  

How can we address this issue?

The backend engine of Viva Engage is based on Yammer, as Viva was previously known as the Yammer engagement portal. Therefore, we will leverage the Yammer API for our post migration efforts.  
 

(Endpoint utilized - https://www.yammer.com/api/v1/messages.json)  

Content Migration Limitations for Posts:

The Yammer API supports a limited selection of HTML tags:
 

 •  <b> and <strong> for bold formatting

 •  <i> and <em> for italic formatting

 •  <u> for underlining

 •  <a> for creating hyperlinks

 •  <br> for inserting line breaks

 •  <p> for defining paragraphs

 •  <ul>, <ol>, and <li> for list structures  
 

● There are specific restrictions on image uploads.
 

● External URLs cannot be utilized; files must be hosted on Yammer and accessed as internal URLs.
 

● Uploads are limited to files that are 4 MB or smaller.
 

● Preserving original authorship during post migration can be complex, potentially necessitating user impersonation or delegation permissions.
 

Solution approach

The first step involves extracting the raw content of posts and storing it in a holdover database for future reference. During this process, we will also convert the raw data into a format compatible with Viva Engage.

Media assets associated with the posts, such as images and videos, will be transferred to Azure Blob storage. This is necessary because the URLs for these media items have a defined expiration date as per the Meta Workplace API response. The primary benefit of this approach is to ensure backup and future accessibility.

Additionally, the backed-up images and videos will be duplicated in a SharePoint document library, given the close integration between SharePoint and Viva Engage within the O365 ecosystem. This will facilitate the streaming of larger videos. Further details will be shared in our upcoming communications.

Why User Impersonation is essential for this migration process. 

The Workplace platform contains a significant amount of user-generated content, including posts, comments, and reactions. To streamline the transition, we will not require users to manually repost this content on the Viva Platform. Instead, the User Impersonation feature will facilitate the migration of users' post-related content to the new platform.

An authorized administrator will create posts on behalf of users in the Viva Engage portal.

Note: Yammer will not support to add the posts on the past date and time, it allows only current date and time while the post is published/migrated.

Here is an example: 

The post mentioned above was authored by Garima Sinha on November 7, 2024; however, the migration date for the post is displayed as November 28, 2024, as seen in the example. On November 7, 2024, Selva Muthu Kumar M A provided a comment on the post. Ranganayaki R and seven other users have expressed their approval of this post on various dates.  

How can we achieve User Impersonation

User impersonation is essential since each user will create content using their individual logins. Consequently, we will generate posts on their behalf, a method known as "Admin on behalf of User."  

In Azure app registration, specific permissions are necessary; therefore, enable Yammer -> User Impersonation -> Delegated access.  

In this scenario, we utilized the Yammer API by registering an app on their platform.  

Additionally, the MS Graph API can be employed to generate the access token for User Impersonation.  

1. Log in to Yammer as an Admin:

Ensure you are logged into the Yammer network where you intend to register the app with an account that possesses administrative rights.  
 

2. Navigate to the App Registration Page:

• Access the Yammer Portal: https://www.yammer.com/client_applications  

• Click on the "Register new App" button.

3. Complete the Application Details: 

By clicking the "Register New App" button, the application registration form will appear. 

After filling in the required fields and selecting the continue button, your application will be registered. 

You will receive a Client ID, Client Secret, and Developer Key, which are crucial for authenticating your application and making API calls to Yammer.

Checklist to generate an access token

Here is a brief checklist to help you generate an access token and create a community post on behalf of the user:

1. Generate an Admin Token using the Client ID, Client Secret Key, and Redirection URI.

2. Utilize this access token to retrieve "behalf user details" from the Yammer environment.

3. Create a user access token using the admin access token, allowing the Yammer platform to recognize it as an actual user.

4. You can then create a community post using the user access token generated by the admin through the /messages.json API.

File Uploading Concept:

The Yammer /messages.json API does not allow direct image URLs. Instead, you must first upload the image to the Yammer local engine server. Once the image is uploaded, you can reference the uploaded file ID in the /messages.json API (e.g., param: attached_objects[] = 452453425). The diagram below illustrates the process for uploading images to the Yammer file explorer.