Yammer Embed configuration parameters – update

As you all know by now (or should know), the Yammer App for SharePoint will be discontinued as of 15 September 2015. If you were not aware yet, I really urge you to read this announcement on the Office 365 Network on Yammer: https://www.yammer.com/itpronetwork/#/Threads/show?threadId=510047230

The single solution going forward to embed Yammer feeds in SharePoint (or other web applications) is Yammer Embed. Yammer Embed is a set of JavaScript widgets that enable you to display specific Yammer feeds or functions inside any HTML based application. I already wrote about this in my article for DIWUG SharePoint Magazine in June this year, where I also explained the configuration parameters for Yammer Embed that were available back then. I just found out Microsoft has updated the Yammer Embed Widget Configuration page (https://www.yammer.com/widget/configure) and added some parameters for the Open Graph object type feed. Time for an update article from my side!

Let’s start with the parameters that did not change, just to be complete (and Microsoft did change the look and feel of the configuration widget, so it gives me an opportunity to post a screenshot of the new look and feel too). Here’s what the widget looks like for My Feed, Group, User, and Topic feeds:

YammerEmbedGroup

And here’s what these parameters do:

  • Network permalink: Visit your Yammer network in the browser and have a look at the URL. It will look similar to this: https://www.yammer.com/<network name>/#/threads/index?type=following. What we are looking for is the <network name> part of this URL. This is usually the same as the e-mail domain name of your organisation.
  • Custom prompt text: Allows you to change the text that is presented to the user in the text input box to post a message. If you leave this empty, the prompt will be “What are you working on?”. Tip: If you are displaying the All Company group on SharePoint, you can also change the text into “Consider posting to a group, before posting to All Company” to remind users to use groups.
  • Feed type: The feed types speak for themselves. Just the Open Graph feed type might require some explanation. The Open Graph protocol enables any web page to become a rich object in a social graph. More on this later in this article.
  • Feed ID: The ID of the group, user or topic you want to display the feed of. To find this ID, visit the group, user or topic in Yammer and have a look at the URL in your browser. It will look similar to this: https://www.yammer.com/<network name>/#/threads/inGroup?type=in_group&feedId=1234567. That last number, in this case 1234567, is the number we are looking for.
  • Default to canonical: Your Canonical Network is your home network, so not any external network you may be a member of. If you set this parameter to true, the embed feed will always be retrieved from or posted to the home network of the user logged in. Especially relevant if a user of your home network last visited an external network and you did not specify a Feed ID, then the post will be made to the default group of the last network the user visited.
  • Use SSO: If you have SSO enabled for your Yammer network, and you would like your users to benefit from this in Yammer Embed as well, make sure you set this parameter to true.
  • Show header: If set to true, the name of your network will be displayed above the text input box for that feed:
    YammerHeaderOn
    If set to false, nothing will be shown above the text input box
  • Show footer: If set to true, the user has a log out link below the feed displayed:
    YammerFooterOn
    If set to false, the entire gray section will not be displayed.
  • Hide network in header: If set to true, and Show header is also set to true, then the network name will be replaced by a general Yammer header:
    YammerHeaderHideNetwork

Now on to the Open Graph object feed type. Open Graph feed types can be used to attach a feed to a URL. When an Open Graph feed is placed on a page in SharePoint, it will grab the URL from that page. The first user to access that page will create the Open Graph object for that page in Yammer, subsequent visitors will then be presented with the feed for this existing Open Graph object. This is ideal for creating a comment feed on an article page in SharePoint. For this feed type, there are some additional configuration parameters available:

YammerEmbedOpenGraph

Here’s what these parameters do:

  • OpenGraph URL: Leave empty if you want to display the feed for the page that you have placed the Yammer Embed widget on. Type in a specific URL if you want to display a feed for a page that is different than the one you are placing Embed on.
  • OpenGraph type: Based on the type that you choose here, Yammer uses a service called Embed.ly to visit the page at the object’s URL and, if the page is public, retrieves any Open Graph metadata present on the page, specific for the type you chose. The more metadata is found, the richer the object will be rendered in Yammer.
  • Show preview: Provide users a preview of the object in the Yammer feed.
  • Fetch metadata: Set to true by default. If set to false, Yammer will not try and retrieve metadata for the URL specified.
  • Mark as “private”: If set to true, the feed will only be visible to either the users you specify in the “users” collection in the feed, or to the group that you specify in the recipients list. The “users” collection looks like this in your Embed code:
  • Ignore canonical url: Not sure what this parameter does. It does not apply to your Yammer canonical network. And for Open Graph objects the URL is a required parameter, since that is its ID in the network.

I hope this gives you a good overview of all the Yammer Embed configuration parameters that are available today. One last remark: If you use the Yammer Embed configuration widget, you have to add the DIV and SCRIPT code yourself to make the widget code work in a web page. Say, you have this code generated for you by the configuration widget:

This is what you have to add to make this code work:

 

34 thoughts on “Yammer Embed configuration parameters – update

  1. Brian

    In the past I remember being able to remove the “message input box” from the embed code, though now I can find it. Any familiarity with this?

    Reply
  2. snappersnap

    I am having trouble figuring out how to get the bottom submit button to appear in the widget – it does not seem to matter if I set the height to a fixed height.

    Reply
    1. Maarten Eekels Post author

      Not sure what you mean… There is not much styling you can do, the widget uses its own html and classes. Are you using an old browser maybe? Only IE11, Chrome latest -1 and Firefox latest -1 are supported.

      Reply
  3. carlintveld

    I am looking into your tutorial to add an open graph object based feed to integrate Yammer with SharePoint objects. Unfortunately it seems that a message always requires a recipient whether it be a group or individual user. Although this can be addressed by configuring a default group, the message will then appear in the feed of this group. Can this be prevented somehow? Ideally messages against open graph object feeds just stand on their own and are not visible elsewhere. Additionally, I don’t like that the open graph object appears as an attachment to at least the very first message. Can that be prevented as well?

    Reply
    1. Maarten Eekels Post author

      Hi Carl, Open Graph objects always have to be published in a Yammer Group. You could create a specific Group just for your Open Graph posts. And I don’t believe it is possible to remove the object as an attachment from that post. That is just the way Yammer works and how Yammer displays objects that conversations are bound to. From a Yammer perspective that makes sense too. Because when you read the conversation in Yammer, as a user you would probably want to be able to click a link and visit the object belonging to that conversation, to give context to the conversation. From an embed perspective I can see why you wouldn’t want to show the attachment, you are already on that page, but you can’t disable that I’m afraid.

      Reply
  4. Daniel

    Is there a way to just embed the announcements without the replies and/or other messages on the group page?

    Reply
    1. Maarten Eekels Post author

      Hi Daniel, with Yammer Embed that is unfortunately not possible. You would have to use the Yammer REST API for that, then you can filter for message_type = announcement.

      Reply
  5. WilliamM

    Hi Maarten, I’ve been trying to use the yammer embed to display posts to the all company group on a company news page. However there is no such thing as a group id for the al company group. did you manage to figure out how one could get that to work?

    Reply
    1. Maarten Eekels Post author

      Hi William, my apologies for the late reply!

      If you just leave the Group ID away, it will default to the All Company feed. For example:

      yam.connect.embedFeed({
      “network”: ““,
      “config”: {
      “use_sso”: true,
      “header”: true,
      “footer”: false,
      “showOpenGraphPreview”: false,
      “defaultToCanonical”: true,
      “hideNetworkName”: false
      },
      “container”: “#embedded-feed”
      });

      Reply
  6. Bruno Gazzera

    Hi Maarten, thanks for taking the time to answer, and also great article!
    Do you know if there is a way to enable the upload of files within the widget? In yammer.com you can post a message and also upload a file from you computer.
    Thanks!

    Reply
  7. Ivan Mislav

    Hi,
    Is it maybe possible:

    1. To remove options to post messages and reply
    2. To set source only for All company or My feed
    3. To limit the number of posts shown on the feed to only latest 5, for example

    Reply
    1. Maarten Eekels Post author

      Hi Ivan,

      1. Unfortunately not possible with Yammer Embed, you would need to create a small Add-In for that.
      2. Yes, you can set the type of feed you want to show to My Feed (actually, that is the default), but you can not set it to show only the All Company feed unfortunately.
      3. No, not possible with Yammer Embed, only possible with code.

      Reply
  8. Krista

    Hi!

    Is it possible to combine two feed types? For example, I would like a Yammer Embed that shows only one specific conversation started by a specific user.

    Thank you!
    Krista

    Reply
    1. Maarten Eekels Post author

      Hi Krista,

      Unfortunately it is not possible to show a specific conversation with Yammer Embed. The REST API of Yammer does support this, so with some custom development this could be done.

      With Yammer Embed you can show either all conversations from a specific user, or you could create an OpenGraph conversation on a specific element (for example a URL) and then show that conversation where ever you want. That is the only way to show a specific conversation with Yammer Embed.

      For example:

      yam.connect.embedFeed({
      “feedType”: “open-graph”,
      “objectProperties”: {
      “url”: “
      }
      });

      Reply
  9. Mike

    Hi Maarten, I’m trying to add a Yammer Open Graph feed to the default page for a Document Set. The widget is rendering on the the Document Set Welcome Page when editing the settings for the page, but doesn’t render when I go to view a Document Set. Any ideas?

    Reply
    1. Maarten Eekels Post author

      Hi Mike, did you push the edited Welcome Page to all inheriting content types? You need to push it, in order for the content type on the List level to use the edited Welcome Page too.

      Reply
      1. Michael Henrickson

        That step did the trick. The feeds now show up on the previously created document set welcome pages. Now my issue is when I post a comment, leave the page, and come back, the comment I previously made is not displaying. It does display in the group within Yammer, however. Did I do something wrong when configuring the embed options?

        Reply
        1. Maarten Eekels Post author

          The OG feed is tied to the URL of a page. So if the feed is not shown on a Document Set welcome page, my guess is the URL is somehow different from the original URL. Can you check that? I just did a couple of tests with leaving the back and coming back, and for me the feed shows up every time I visit the specific Document Set where I created the feed.

          Reply
          1. Michael Henrickson

            I’m thinking that maybe the conversation is there, but I just can’t see the whole embedded feed for some reason. When I post a comment on a feed for the first time, the post button is cut off so I can only see the top of it. There is no scroll bar or anything to indicate that there is more content below. I tried making the web part height fixed, with no change. Is there a parameter that defines the height of the embedded widget, or whether the widget will display a scroll bar?

  10. Vishnu Nair

    hi, i tried embedding the yammer feed in my website. But its asking me to signin to display the blog. But I want this blog to be public so that anyone can view it. Is there any option to do it?

    Reply
    1. Maarten Eekels Post author

      No, unfortunately there isn’t. Yammer does not allow/support anonymous commenting. Therefore Yammer Embed is not really a feasible option for public facing websites.

      Reply
  11. Jannetta Lamourt

    Thank you for the clarifying post! I am curious if there is a way to remove the “Like” and “View Conversation” icons/options on the embedded feed – keeping only the “reply” option.

    Reply
    1. Maarten Eekels Post author

      Hi Jannetta, no, unfortunately you cannot remove those things. Then you would have to write your own web part that just lets you reply and doesn’t show any other options, but that requires custom development.

      Reply
      1. Jannetta Lamourt

        Thank you Maarten – I had a feeling from what research I had done that removing those elements was not possible with the new embedded feed. This is one of those client wishes which goes into the “no” category – or better said, “No-unless you want to pay for custom development.”

        Best,
        Jannetta

        Reply
  12. PeterGa

    Hi Maarten,
    Im trying to implement yammer feed into SharePoint Online as commenting platform for pages, but I cant find correct solution for those issues :

    1. I created yammer group for posting and also set it as default group id, this display as well, but still the user is able to change it to different one in UI of the yammer embed, which I would like to deny.Is there any option for this? I dont want to that users are able to post the comments in different group instead of the default one.

    2. The open graph post to yammer is not working correctly, when Im posting a comment and erase the preview at the time Im posting the comment, so it will create a yammer comment, but it will lose the connection to the SharePoint Online page itself. It is somehow possible to deny the users to erase the connection at the time of the comment post?

    Thanks

    Reply
    1. Maarten Eekels Post author

      Hi Peter, apologies for the late reply. Unfortunately both issues are indeed issues with Yammer Embed. There is no fix for these issues. If you would like different behaviour, you need to develop your own Yammer web part.

      Reply

Leave a Reply