{"_id":"546b925662515a14007ebc53","user":"5433099f9a2b451a00ad4531","parentDoc":null,"category":{"_id":"5481008eea7fd40b00cd7c2b","project":"545137a814af501a00b50cf9","version":"545137a814af501a00b50cfc","__v":1,"pages":["5481012cab84321d00eaf544"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-12-05T00:47:10.017Z","from_sync":false,"order":1,"slug":"yammer-app-directory","title":"Yammer App Directory"},"version":{"_id":"545137a814af501a00b50cfc","project":"545137a814af501a00b50cf9","__v":11,"createdAt":"2014-10-29T18:53:28.525Z","releaseDate":"2014-10-29T18:53:28.525Z","categories":["545137a814af501a00b50cfd","545138eaa66f020800dbab4a","546b9072b47b5d1400109edf","546b9082b47b5d1400109ee0","546b9088b47b5d1400109ee1","546b909462515a14007ebc43","546b90a0b47b5d1400109ee2","546ced235884600e007a92f6","5481008eea7fd40b00cd7c2b","573b9d83ee2b3b220042291f","57be1efa15efc70e006a5f99"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":37,"project":"545137a814af501a00b50cf9","updates":["555379bdeac63f0d003e6b7b","55d67152e60a2f0d00b88f37","573fedae566c450e006cd725"],"next":{"pages":[],"description":""},"createdAt":"2014-11-18T18:39:18.558Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"try":true,"basic_auth":false,"settings":"","auth":"never","params":[],"url":""},"isReference":false,"order":1,"body":"## Publish App in Yammer’s App Directory\n\nGain visibility and users from publishing in Yammer’s App Directory. Once you’ve submitted your app, our team will meet with you to ensure your app is feature-ready to be added to the Yammer App Directory. You may even be promoted in our featured “Yammer App Carousel” or the Yammer blog.\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/kRihtpFFQB6raRiOPl1H_Yammer___Application_Directory.png\",\n        \"Yammer___Application_Directory.png\",\n        \"1059\",\n        \"649\",\n        \"#91604a\",\n        \"\"\n      ],\n      \"caption\": \"Discover great enterprise apps in Yammer App Directory\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"How Partners Use Yammer\"\n}\n[/block]\nOur platform is optimized for Freemium enterprise applications. To build the best experience, here are some of the best ways to leverage Yammer’s API:\n\n**1. Frictionless 1-Click Login** \n\nUse Yammer credentials as your authentication and identity mechanism. The OAuth 2 flow is typically initiated by a user clicking a “Sign in with Yammer” button on your app’s login page. The end result is a token your app will use to write activity to Yammer and retrieve Yammer data. The token is unique to each app/user combination.\n\n\n**2. Increase Reach & Visibility**\n\nOnce you have authenticated a Yammer user, you can share their activity from your app in Yammer’s ticker and Newsfeed.  This activity will be displayed in engaging ways to the user’s network. People in the network click through the activity into your app, growing its usage.\n\n*Examples of activities include:*\n\n  * CRM App: A sales rep updates an opportunity’s probability sharing its current status.\n\n  * Scheduling App: An employee creates a lunch meeting.\n\n  * Open Graph (OG), a lightweight data integration protocol, is used to define the activity, which is posted to Yammer as an OG object. \n\n\n**3. Acquire More Users**\n\nDuring a user’s onboarding process to your app, you should use Yammer’s RESTful API Endpoints for Users to identify additional members that can be invited to use your app.\n\nYou can use Yammer’s “Invite Relevant User Algorithm” to identify a user’s most relevant contacts, and prompt them to invite these users to use your app. With access to these relevant contacts, your app invites are more likely to be accepted.\n\nThe end result: Present a face pile (dialog box) of the 5-10 most relevant users starting with 1 above with a next button that leads to the next 5-10 most relevant users (and so on). On each dialog box, provide the ability to select all and also individual users to invite to use your app.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"For example:\\n\\n1) GET the user’s followers\\nAPI Endpoint: https://www.yammer.com/api/v1/users/following/bmathews-guest\\n\\n2) GET the users the user is following\\nAPI Endpoint: https://www.yammer.com/api/v1/users/by_email.json?email=user\\n\\n3) GET the users from the suggestion API\\nDocumentation: https://www.yammer.com/api/v1/suggestions.json\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1ADeMvzuRj2mxRAGKNTg_Facepile.a%20(2).png\",\n        \"Facepile.a (2).png\",\n        \"759\",\n        \"370\",\n        \"#99543e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n\n**4. Leverage Yammer Data** \n\nDuring a user’s onboarding process to your app, you should use Yammer’s RESTful API for Autocomplete to reduce the amount of friction a user experiences to invite additional members from their network.\n\n*For example*:\nAfter a user is authenticated and is onboarding into your app, they are presented with a dialog box asking them to “Type in the name of a user to invite…”. As the user types the first few letters, the Autocomplete API will retrieve the names of existing users/groups, allowing for an instant click to invite the correct users.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/WO3hOfHSIC5a3bRx37yq_Autocomplete.1a%20(1).png\",\n        \"Autocomplete.1a (1).png\",\n        \"622\",\n        \"238\",\n        \"#2a8bd3\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/kOs9gGjPRqCsE9WMKUTw_Autocomplete.2a%20(1).png\",\n        \"Autocomplete.2a (1).png\",\n        \"752\",\n        \"514\",\n        \"#4c92d0\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"The Final Steps\"\n}\n[/block]\nOnce your app is built and tested, you can prepare it to be included in Yammer’s App Directory.\n\nPrior to launch, please make sure you have prepared your website, landing page, and marketing material.\n\nNext, complete the App Directory Configuration section and deploy the app to your network: https://www.yammer.com/client_applications\n\nFinally, submit your app to Yammer for App Directory approval by Deploying to Global App Directory. A member of the Yammer Platform team will reach out with next steps.","excerpt":"","slug":"app-directory","type":"basic","title":"How to Get Featured"}

How to Get Featured


## Publish App in Yammer’s App Directory Gain visibility and users from publishing in Yammer’s App Directory. Once you’ve submitted your app, our team will meet with you to ensure your app is feature-ready to be added to the Yammer App Directory. You may even be promoted in our featured “Yammer App Carousel” or the Yammer blog. [block:image] { "images": [ { "image": [ "https://files.readme.io/kRihtpFFQB6raRiOPl1H_Yammer___Application_Directory.png", "Yammer___Application_Directory.png", "1059", "649", "#91604a", "" ], "caption": "Discover great enterprise apps in Yammer App Directory" } ] } [/block] [block:api-header] { "type": "basic", "title": "How Partners Use Yammer" } [/block] Our platform is optimized for Freemium enterprise applications. To build the best experience, here are some of the best ways to leverage Yammer’s API: **1. Frictionless 1-Click Login** Use Yammer credentials as your authentication and identity mechanism. The OAuth 2 flow is typically initiated by a user clicking a “Sign in with Yammer” button on your app’s login page. The end result is a token your app will use to write activity to Yammer and retrieve Yammer data. The token is unique to each app/user combination. **2. Increase Reach & Visibility** Once you have authenticated a Yammer user, you can share their activity from your app in Yammer’s ticker and Newsfeed. This activity will be displayed in engaging ways to the user’s network. People in the network click through the activity into your app, growing its usage. *Examples of activities include:* * CRM App: A sales rep updates an opportunity’s probability sharing its current status. * Scheduling App: An employee creates a lunch meeting. * Open Graph (OG), a lightweight data integration protocol, is used to define the activity, which is posted to Yammer as an OG object. **3. Acquire More Users** During a user’s onboarding process to your app, you should use Yammer’s RESTful API Endpoints for Users to identify additional members that can be invited to use your app. You can use Yammer’s “Invite Relevant User Algorithm” to identify a user’s most relevant contacts, and prompt them to invite these users to use your app. With access to these relevant contacts, your app invites are more likely to be accepted. The end result: Present a face pile (dialog box) of the 5-10 most relevant users starting with 1 above with a next button that leads to the next 5-10 most relevant users (and so on). On each dialog box, provide the ability to select all and also individual users to invite to use your app. [block:code] { "codes": [ { "code": "For example:\n\n1) GET the user’s followers\nAPI Endpoint: https://www.yammer.com/api/v1/users/following/bmathews-guest\n\n2) GET the users the user is following\nAPI Endpoint: https://www.yammer.com/api/v1/users/by_email.json?email=user\n\n3) GET the users from the suggestion API\nDocumentation: https://www.yammer.com/api/v1/suggestions.json", "language": "text" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/1ADeMvzuRj2mxRAGKNTg_Facepile.a%20(2).png", "Facepile.a (2).png", "759", "370", "#99543e", "" ] } ] } [/block] **4. Leverage Yammer Data** During a user’s onboarding process to your app, you should use Yammer’s RESTful API for Autocomplete to reduce the amount of friction a user experiences to invite additional members from their network. *For example*: After a user is authenticated and is onboarding into your app, they are presented with a dialog box asking them to “Type in the name of a user to invite…”. As the user types the first few letters, the Autocomplete API will retrieve the names of existing users/groups, allowing for an instant click to invite the correct users. [block:image] { "images": [ { "image": [ "https://files.readme.io/WO3hOfHSIC5a3bRx37yq_Autocomplete.1a%20(1).png", "Autocomplete.1a (1).png", "622", "238", "#2a8bd3", "" ] } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/kOs9gGjPRqCsE9WMKUTw_Autocomplete.2a%20(1).png", "Autocomplete.2a (1).png", "752", "514", "#4c92d0", "" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "The Final Steps" } [/block] Once your app is built and tested, you can prepare it to be included in Yammer’s App Directory. Prior to launch, please make sure you have prepared your website, landing page, and marketing material. Next, complete the App Directory Configuration section and deploy the app to your network: https://www.yammer.com/client_applications Finally, submit your app to Yammer for App Directory approval by Deploying to Global App Directory. A member of the Yammer Platform team will reach out with next steps.