MS Yammer - Privacy Documentation
Data Starmind has access to
![yammer_p1.png 582](https://files.readme.io/29bbaca-yammer_p1.png)
The chapter Data Starmind has access to describes which data we can read from the Yammer API. We restrict access to the data as far as the API allows it to limit the amount of data Starmind can read. The connector filters the data, which can not be excluded by access rights or filtering on the endpoint. More details on this topic are in the chapter “Data Starmind learns.”
The connector authenticates over OAuth with a technical user. More details are available in the documentation of Yammer . The Yammer API does not allow to restrict the access further.
Sequence Diagram
The sequence diagram below shows which requests Starmind makes to the Yammer API. In the subchapters, there are more details for each request. The ID is corresponding with the number in the diagram.
The data used by the connector (listed in the tables in the chapters below) is not stored permanently. Some of the data points are not used on the connector level but are sent to Starmind. These data points have an “X” in the column Starmind in the chapters below. Starmind uses them to extract expertise topics from the data and assign them to the corresponding users. The expertise topics are stored permanently.
![yammer_p2.png 1600](https://files.readme.io/d18e409-yammer_p2.png)
List all users
Get the attributes of the users.
Field | Example | Description | Starmind |
---|---|---|---|
[email protected] | Send as an identifier for the user to Starmind. | x | |
id | 1692898527 | Used in the connector to identify the user. |
List all groups
This endpoint will list all groups which are accessible to the technical user.
ID | 2 |
Endpoint | GET /v1/groups.json |
Query Parameter | mine=0 |
Response
The list below shows which of the returned attributes are used by the connector or Starmind.
Field | Example | Description | Starmind |
---|---|---|---|
privacy | public | Filter out groups that are not public. | |
full_name | All Company | Show the name of the group in the logs | |
id | 34877095936 | To search for messages in this group |
List all messages
This endpoint will return all new messages from a group since the last run.
ID | 2 |
Endpoint | GET /v1/messages/in_group/{group_id}.json |
Query Parameter | newer_than=21837981 |
Documentation | https://developer.yammer.com/docs/messagesin_groupgroup_id |
Response
The list below shows which of the returned attributes are used by the connector or Starmind.
Field | Example | Description | Starmind |
---|---|---|---|
privacy | public | Filter out messages which are not public. | |
message_type | update | Filter out messages from the system and to define the type of the message | x |
body.parsed | What is... | What is... | x |
created_at | 2020/07/10 12:10:1 | The timestamp of the post | x |
Updated about 2 years ago