Comment (Open Graph) Feeds

Note

Starting January 31, 2025, Microsoft will retire and no longer support classic Embed Feed. To avoid a broken feed experience, we recommend that you replace your classic embed feeds as soon as possible using these instructions, Migrate classic feeds in HTML apps with Embed feed for Engage.

URLs pasted into Yammer messages create OG objects represented as Pages. These pages display all the OG metadata Yammer knows about that URL. When an OG object feed is placed on a page in your application, it will grab the URL and OG metadata from the page.

The first user to authenticate will create the OG object for that page in Yammer (or find the existing OG object if one already exists). It will then load the feed for that object. Note that this embed feed is not restricted to a specific network and users from different networks can view this feed (although they will only see the feed for their own network). However, open graph objects are restricted to their related networks.

OG feeds can effectively become a commenting system for internal blogs or any line of business application.

To display an OG Object Feed, add the following embed code to your page.

yam.connect.embedFeed({
 container: "#embedded-feed",
 feedType: "open-graph"
});

Headers And Footers In Object Feeds

You can also configure whether to show the Yammer header or footer in your embed. The sample below displays a basic Open Graph feed, but without the standard Yammer header or footer.

JavaScript

yam.connect.embedFeed({
 container: "#embedded-feed",
 feedType: "open-graph",
 config: {
   header: false,
   footer: false
 }
});

Custom Publisher Messages

The publisher lets users start new conversations related to your Open Graph objects. You can encourage your users to post more by providing custom publisher watermark text.

JavaScript

yam.connect.embedFeed({
 container: "#embedded-feed",
 feedType: "open-graph",
 config: {
   promptText: "Comment on this customer"
 }
});

Open Graph Previews

Another option is to display an Open Graph preview of the target URL beneath the new message publisher, which provides users with a preview of the Open Graph summary they will see in the conversation they are starting.

JavaScript

yam.connect.embedFeed({
 container: "#embedded-feed",
 feedType: "open-graph",
 config: {
   showOpenGraphPreview: true 
 }
});

Private Specified Object Feed

Once placed on a page in your app, this will check the page URL and utilize the provided metadata details. It will also only authenticate users in the network specified. This can be helpful if you want to display a feed for a page that is different than the one you are placing Embed on. Note that the objectProperties parameter is optional.

If setting the "private" parameter as "true", any pages which are created in Yammer will be private to:

• The users who are specifically listed in the "users" collection.
• The group (if any) that you specify in the recipients list when posting.
• Any other members of the conversation thread that are added later.
• Please note, you can add and remove users from the conversations. If a user is added to an OGO then removed from a conversion, they will still be able to see the OGO but not necessarily the comments.

JavaScript

yam.connect.embedFeed({
 container: "#embedded-feed",
 network: "fourleaf.com",
 feedType: "open-graph",
 objectProperties: {
   url: "https://box.com/file/abc123",
   type:  "file",
   title: "Yammer ROI.pdf",
   image: "https://dox.com/file/abc123.png"
 },
 private: true,
 users: [
   {name : "Drew Dillon", "email" : "adillon@fourleaf.com"},
   {name : "Ryan Kennedy", "email" : "rkennedy@fourleaf.com"}
 ]
});

Please note that OG Object Feeds support all of the properties available in the Activity Stream API. Not specifying any properties means that the object will attempt to gather the information from the page, either through <title> tags or <meta> tags per the Open Graph specification http://ogp.me/

Default Comment Destination for OGO Object Feeds

You can set a default group for comments in an OGO Object Feed that will appear in the destination box of the publisher by specifying a defaultGroupId. The user can change this and post to a group of their choice.

If you do not specify a defaultGroupId, the destination box will be left blank and the user will be prompted to add a group on their own when posting a comment.

Specifying defaultGroupId: 0 will set the default to All Company.

JavaScript

yam.connect.embedFeed({
  container: '#embedded-feed',
  network: 'fourleaf.com',
  feedType: 'open-graph',       // can be 'group', 'topic', or 'user'    
  config: {
       defaultGroupId: 3257958  // specify default group id to post to