Yammer setup guide

With this social network integration you can automatically post your wall entries into a Yammer feed. Example of what a post looks like in Yammer for an individual recognition:

yammer.PNG

 

Warning!

When adding an integration to Yammer, the connection is made via a Yammer user account rather than the system. This means:

  • The post will come from that user (which could be confusing)
  • If the user leaves and their Yammer account is deleted, your integration will stop working

We recommend that you setup a new Yammer user:

  • It must be a Group Admin
  • Name it accordingly (e.g. in the above example screenshot we added a user called “Employee Recognition”)
  • You can also add a profile picture which can help show your employees that the post is from your recognition program rather than a normal user
 

Step 1 - Connect to your Yammer account and authorise

  1. Before you start, we suggest you logout of Yammer (and Office 365 if applicable)
  2. Login to your Workstars administrator account (must be the primary account or technical user)
  3. Click on System Settings in the top margin
  4. Then click Integrations in the left-nav menu
  5. Click Yammer
  6. Click the Connect button, you should be redirected to a Yammer login page
  7. Login to Yammer with the account you want to use (i.e. the one you created above)
    • The account must be a group admin with permission to add an app
    • Contact your Yammer administrator if you need assistance
  8. Click the Allow button to authorise access to your account

Step 2 - Configure and enable the integration

  1. If all goes well and you authorised our connection request, you should be redirected back to our integration setup page
    • If you want to post to the All Company feed, leave the ID field blank
    • If you want to post to a specific feed, enter the appropriate ID (it is approximately a 9-digit number)

    Note

    • To get the ID, click the group and look in the browsers URL bar, the ID is the value after "feedId"
    • You can also visit https://www.yammer.com/api/v1/groups.json (you must be logged in as the group admin)
    • If you can't find the ID, contact your Yammer administrator for assistance
  2. If you are running in a country with multiple languages, select the language you would like to post in

    Note

    • This only applies to the general content (e.g. “has been recognised by”), as the person making the recognition can enter the reason in any language
    • If in doubt set it to English
  3. Click the Enable button and we will post a test message to either the Company Highlights group or the group you specified
  4. Login to Yammer and view the appropriate group, there should be a post that says This message was sent to test the connection
    • If you cannot see the message, click No and contact support
    • If the message looks OK, click Yes to enable the integration

The integration is now setup and any new wall posts should also be posted into Yammer. You can view what is happening by viewing the integration log.

Troubleshooting

I get an error “You do not have permission to make an Announcement in this group”

This is because the user you have used to connect the account does not have appropriate permissions to post an announcement to a group. Please ensure that the user is a Group Admin.

I get an "Unknown Error“

Check that the feed ID you have entered is correct.

FAQs

How do I disable the integration?

In the Workstars administration portal, go to System Settings then Integrations and select the integration. Click the Disconnect button and confirm.

How do I change the settings (e.g. the account its connected to, channel it posts to, etc.)?

To ensure the setup works correctly it is not possible to change settings, please disable the integration and start again (see Step 1).

Good to know

  • Wall posts feed one-way from the recognition wall to the integrated social network
  • Comments or likes posted on the wall do not feed to the integrated social network
  • Comments or likes posted in the integrated social network do not feed back to the recognition wall

Was this article helpful?

1 out of 1 found this helpful

Comments (0 comments)

Please sign in to leave a comment.