Yammer Integrations

affinities yammer integration allows events, announcements, and newsletters created in affinities erg’s to be published on yammer groups as announcements add & configure yammer application 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 for each yammer group that needs to be integrated 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 https //web yammer com/main/groups/eyjfdhlwzsi6ikdyb3vwiiwiawqioiiymjmznjuyin0k then the groupid can be extracted from the last fragment as \#echo “ eyjfdhlwzsi6ikdyb3vwiiwiawqioiiymjmznjuyin0k https //web yammer com/main/groups/eyjfdhlwzsi6ikdyb3vwiiwiawqioiiymjmznjuyin0k ” | base64 d w hich 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” manage groups 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 add new integrations page you’ll see the integration listed click on the unlock icon to activate this integration activate 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 http post https //www yammer com/api/v1/messages json https //www yammer com/api/v1/messages json if content is deleted on affinities, corresponding announcement will be deleted from yammer using http delete https //www yammer com/api/v1/messages/{messageid https //www yammer com/api/v1/messages/%7bmessageid } if content is updated on affinities, corresponding yammer announcement will be updated on yammer using http patch https //www yammer com/api/v2/messages/{messageid https //www yammer com/api/v2/messages/%7bmessageid } note service account developer token will be used as http bearer token for authorization security considerations 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