Yammer Integrations
Affinities Yammer Integration allows Events, Announcements, and Newsletters created in Affinities ERG’s to be published on Yammer Groups as announcements.
Create a service account e.g. affinities_ergs. Log in as a service account to your Yammer network and type in the address https://www.yammer.com/client_applications.
Register a new application. You can put a fake address in the expected redirect URL field. Since we will be using developer token, redirects will not be used. Once registered, generate a developer token for this application.
Save the developer token for a later step. It will be used as Access Token when configuring integrations in Teleskope Admin Panel. Note the developer token will be used as a bearer token by Affinities platform to post announcements in the connected Yammer groups.
- Make the service account an Admin of the Yammer Group
- Note the Group ID
Group id can also be extracted from the Yammer Group URL. For example, if the Yammer Group URL is https://web.yammer.com/main/groups/eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIyMjMzNjUyIn0K Then the groupid can be extracted from the last fragment as:
#echo “eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIyMjMzNjUyIn0K” | base64 -d
Which will print the groupid: {"_type":"Group","id":"2233652"}
Next go to Teleskope Admin Panel and associate the Yammer groups with corresponding Teleskope Group, Chapter or Subgroup.
For this step, Login into the admin panel. Now navigate to the Groups > Manage Groups section
Click on Integration icon next to the group you want to add the integration link. For this document, we will choose the icon next to the group “Asian Affinities Link”.
This is the page where you’ll see all integrations linked to the group. Click on the + icon to add integration.
This is the page where we create integration for the group. Follow these steps
- Select “Yammer” from the dropdown
- Add a name for integration
- Checkmark where you want the integrations to work
- Paste Yammer Group Id and Access Token
- Click Save
You’ll see the integration listed. Click on the unlock icon to activate this integration.
Teleskope Affinities will use the following Yammer REST API end points to publish updates. Content updates will be posted as Yammer Announcements.
- New content (Announcements/Events/Newsletters) posted on Affinities will be published in corresponding Yammer group using:
- If content is deleted on Affinities, corresponding announcement will be deleted from Yammer using:
- If content is updated on Affinities, corresponding yammer announcement will be updated on Yammer using:
Note: Service account developer token will be used as HTTP Bearer token for authorization.
- Teleskope does not need to sign in to the service account, so the service account credentials should never be shared with Teleskope.
- Teleskope application functions as a Service Account Bot. Thus it is important to create developer token from the Service Account. Use of Service account instead of real person account ensures there is no disruption of service in case the person who created the token leaves the organization.
- Please apply security controls on the service account and restrict the access only to API’s listed on this page. Disable access to all other API’s.
- Restrict service accounts access to the groups that need to be integrated.
- If there is a mechanism to implement IP allowlist for the API’s please implement it. A list of source IP’s can be obtained from Teleskope support team.
