Professional Documents
Culture Documents
Yammer Embed and Open Graph API are targeted at web and application developers. These technologies are also useful for Yammer users that are familiar with HTML. Requirements:
To understand the information presented here the reader should have a Yammer account. In addition, to debug problems with Yammer Embeds, users should have familiarity with the developer tools included with modern browsers.
A basic understanding of the capabilities of each technology. An understanding of who in your organization can use the technology. A high-level description of how the Open Graph API and Embed technologies work.
After reviewing this deck you should have the ability to:
Describe the Yammer Embed integration. Identify places where Yammer Embed can be utilized. Describe what the Open Graph API is, and what its benefits are. Identify the format schema and supported object types of the Open Graph API.
A Yammer Embed is a JavaScript-based widget that harnesses the power of your enterprise social platform by making Yammer available to users where they work online. It provides a way to display content from Yammer in your own HTML-based app.
*.JS
1.
2.
</>
5
3.
Description
My Feeds are where conversations are delivered for Yammer users. All the conversations posted by a specific user in Yammer. A feed of conversations that have been tagged with a topic in Yammer. A feed of conversations that have been posted in a specified group. Uses Yammers Open Graph API to facilitate conversation around an application object.
FeedType
See My Feed example
User Topic
Use Case
My Site homepage or workspace site.
Profile pages for users in a system directory. An event page on an intranet.
Group Feed
Group
Comment Feed
An opportunity in a custom CRM application, or a media detail page in a digital asset management system.
2.
3.
If this is your first time logging in, a confirmation dialog will appear asking you to grant access to the Embed application. Click Allow to do so.
Test Embed outside of your environment using the Yammer Embed Widget.
Test Embed with multiple web browsers. Review the console in the web developer provided by your browser.
Capture screenshots.
Provide a succinct reproduction of the issue.
Troubleshooting Embeds
1.
Check your Internet Explorer settings for zone configuration, and enable http://www.yammer.com as a Trusted Site Zone. Check Internet Explorers compatibility view. For more information about turning off Internet Explorers compatibility view, visit this Microsoft community article. Check the pages for conflicting JavaScript code. Use a test environment such as JSFiddle to test your embed outside of the page with the JavaScript code.
2.
3.
4.
Check the pages for conflicting CSS statements. Test the page by running the embed without a CSS style sheet.
For more information regarding troubleshooting of Yammer embeds, please visit the Yammer Developers site.
5.
10
*.JS, *.CSS
Open Graph is a light weight protocol that facilitates integrating data from different social apps into what we call the social graph. Yammer's Open Graph API allows developers to write activity from their app into Yammer.
Rich metadata around an object identified by a URL. Discussion mirroring between an application and Yammer through comment feeds. Aggregation of all conversations around an object in Yammer.
12
In a customer relationship management (CRM) app, a sales rep updates an opportunitys probability of closing to a lower number. In a scheduling app, an employee creates a lunch meeting.
Authenticate A User
13
User Authentication
Yammer Embed handles authentication automatically. However, authentication can also be handled using OAuth. This process is similar to what is shown in Getting Started with OAuth 2.0 (Ryan Boyd, OReilly Media). The complete authentication flow using OAuth 2.0 is detailed at the Yammer Developers site.
The documentation there provides the detail for each step of the authentication process.
14
Actor
A Yammer user that performed an action in your app. If the actor exists in the Yammer network, the story will be delivered to the actor, and possibly others, based on delivery rules.
Action
A verb that describes what happened to the object. For example: created, updated, deleted, followed, liked, and so forth.
Object
The Open Graph object is the key piece of any activity. It represents an entity instance in your app, such as an event or a CRM record.
15
CRM Example
Sidd Singh created Lunch Meeting on Sched.do: Hey, lets get sushi!
16
Supported actions:
create update delete follow like
If the above actions or objects are not sufficient, you can even create custom actions to better suit your needs. Click here for more information.
17
Visit the Yammer New App Registration page and Register Your App to get the API key. Connect your app to Yammer and authenticate with OAuth 2. Write data into Yammer using Open Graph
2.
3.
4.
Now that youve built your app, make it ready for inclusion in Yammers App Directory and deploy it to a global audience!
18
</>
Learning Review
In this deck we provided information covering:
A summary of Yammers Embed and Open Graph API technologies. A technical overview of both technologies. Information on who can use these technologies to deliver better experiences.
Describe the Yammer Embed integration. Identify places where Yammer embed can be utilized. Describe what the Open Graph API is, and what its benefits are. Identify the format schema and supported object types of the Open Graph API.
20
Additional Resources
The following resources can provide you with additional information about Embed:
The following resources can provide you with additional information about Open Graph:
http://ogp.me/ https://developer.yammer.com/opengraph/
21