الملاحظات

Yammer

  • Reference

Yammer is a leading social network for businesses to get work done smarter and faster. Connect to Yammer to access conversations in your enterprise network.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft
Website https://products.office.com/yammer/yammer-overview

Known issues and limitations

The following actions and triggers do not guarantee to return all messages, because of Yammer REST API limitations:

  • Get all messages
  • Get messages in a group
  • Get messages in a thread
  • Get the messages from my Following feed
  • When there is a new message in a group
  • When there is a new message in my followed feed

For more information, please refer to Getting bulk content subsection of Yammer REST API Docs

Note

Yammer API restricts the number of messages only to 20. To workaround this limit, please refer to How to get all messages in a Yammer group using Microsoft Flow. For more details related to Yammer API limits, please visit the Yammer API rate limits.

Also, the following actions and triggers do not work with All company group, because of Yammer REST API limitations:

  • Get messages in a group
  • Get messages in a group (V2)
  • When there is a new message in a group

3rd Party Applications feature must be enabled in Yammer configuration. An action response such as "The response is not in a JSON format" typically means that feature is disabled.

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds
Frequency of trigger polls115 seconds

Actions

Get all messages (V2)

This operation returns all public messages in the logged in user's Yammer network. Corresponds to "All" conversations in the Yammer web interface.
Get all messages [DEPRECATED]

This action has been deprecated. Please use Get all messages (V2) instead.

This operation returns all public messages in the logged in user's Yammer network. Corresponds to "All" conversations in the Yammer web interface.
Get groups

Gets all groups. If mine = 1, get only groups to which the user belongs
Get messages in a group (V2)

This operation returns the messages posted in a group.
Get messages in a group [DEPRECATED]

This action has been deprecated. Please use Get messages in a group (V2) instead.

This operation returns the messages posted in a group.
Get messages in a thread (V2)

This operation returns the messages posted in a thread.
Get messages in a thread [DEPRECATED]

This action has been deprecated. Please use Get messages in a thread (V2) instead.

This operation returns the messages posted in a thread.
Get my networks

Gets all the networks that the user belongs to.
Get the messages from my Following feed (V2)

This operation returns the messages from Following feed which is conversations involving people, groups and topics that the user is following.
Get the messages from my Following feed [DEPRECATED]

This action has been deprecated. Please use Get the messages from my Following feed (V2) instead.

This operation returns the messages from Following feed which is conversations involving people, groups and topics that the user is following.
Get user details

This operation returns user profile details.
Like message

This operation is used to like the specified message.
Post message

This operation is used to post a Message to a Group or All Company Feed. If group ID is provided, message will be posted to the specified group else it will be posted in All Company Feed.

Get all messages (V2)

Operation ID:
GetAllMessagesV2

This operation returns all public messages in the logged in user's Yammer network. Corresponds to "All" conversations in the Yammer web interface.

Parameters

Name Key Required Type Description
Unique identifier of the network
 network_id string

Network ID
Older than
 older_than integer

Returns messages older than the message ID specified as a numeric string. This is useful for paginating messages. For example, if you’re currently viewing 20 messages and the oldest is number 2912, you could append “?older_than=2912″ to your request to get the 20 messages prior to those you’re seeing.
Newer than
 newer_than integer

Returns messages newer than the message ID specified as a numeric string. This should be used when polling for new messages. If you’re looking at messages, and the most recent message returned is 3516, you can make a request with the parameter “?newer_than=3516″ to ensure that you do not get duplicate copies of messages already on your page.
Thread type of messages
 threaded string

Threaded=true will only return the thread starter (first message) for each thread. This parameter is intended for apps which need to display message threads collapsed. threaded=extended will return the thread starter messages and the two most recent messages all ordered by activity, as they are viewed in the default view on the Yammer web interface.
Limit
 limit integer

Return only the specified number of messages.

Returns

List of one or multiple messages.

Message List
PageableMessageList

Get all messages [DEPRECATED]

Operation ID:
GetAllMessages

This action has been deprecated. Please use Get all messages (V2) instead.

This operation returns all public messages in the logged in user's Yammer network. Corresponds to "All" conversations in the Yammer web interface.

Parameters

Name Key Required Type Description
Unique identifier of the network
 network_id string

Network ID
Older than
 older_than integer

Returns messages older than the message ID specified as a numeric string. This is useful for paginating messages. For example, if you’re currently viewing 20 messages and the oldest is number 2912, you could append “?older_than=2912″ to your request to get the 20 messages prior to those you’re seeing.
Newer than
 newer_than integer

Returns messages newer than the message ID specified as a numeric string. This should be used when polling for new messages. If you’re looking at messages, and the most recent message returned is 3516, you can make a request with the parameter “?newer_than=3516″ to ensure that you do not get duplicate copies of messages already on your page.
Limit
 limit integer

Return only the specified number of messages.
Page
 page integer

Get the page specified. If returned data is greater than the limit, you can use this field to access subsequent pages

Returns

List of one or multiple messages.

Message List
MessageList

Get groups

Operation ID:
GetGroups

Gets all groups. If mine = 1, get only groups to which the user belongs

Parameters

Name Key Required Type Description
Network ID
 network_id string

Network ID
mine
 mine integer

Used for getting groups which user is part of
Show All Company Group
 showAllCompanyGroup integer

Used for showing All Company Group

Returns

response
array of YammmerEntity

Get messages in a group (V2)

Operation ID:
GetMessagesInGroupV2

This operation returns the messages posted in a group.

Parameters

Name Key Required Type Description
Network ID
 network_id string

Unique identifier of the network.
Group ID
 group_id True integer

Unique identifier of the group.
Older than
 older_than integer

Returns messages older than the message ID specified as a numeric string. This is useful for paginating messages. For example, if you’re currently viewing 20 messages and the oldest is number 2912, you could append “?older_than=2912″ to your request to get the 20 messages prior to those you’re seeing.
Newer than
 newer_than integer

Returns messages newer than the message ID specified as a numeric string. This should be used when polling for new messages. If you’re looking at messages, and the most recent message returned is 3516, you can make a request with the parameter “?newer_than=3516″ to ensure that you do not get duplicate copies of messages already on your page.
Thread type of messages
 threaded string

Threaded=true will only return the thread starter (first message) for each thread. This parameter is intended for apps which need to display message threads collapsed. threaded=extended will return the thread starter messages and the two most recent messages all ordered by activity, as they are viewed in the default view on the Yammer web interface.
Limit
 limit integer

Return only the specified number of messages.

Returns

List of one or multiple messages.

Message List
PageableMessageList

Get messages in a group [DEPRECATED]

Operation ID:
GetMessagesInGroup

This action has been deprecated. Please use Get messages in a group (V2) instead.

This operation returns the messages posted in a group.

Parameters

Name Key Required Type Description
Network ID
 network_id string

Unique identifier of the network.
Group ID
 group_id True integer

Unique identifier of the group.
Older than
 older_than integer

Returns messages older than the message ID specified as a numeric string. This is useful for paginating messages. For example, if you’re currently viewing 20 messages and the oldest is number 2912, you could append “?older_than=2912″ to your request to get the 20 messages prior to those you’re seeing.
Newer than
 newer_than integer

Returns messages newer than the message ID specified as a numeric string. This should be used when polling for new messages. If you’re looking at messages, and the most recent message returned is 3516, you can make a request with the parameter “?newer_than=3516″ to ensure that you do not get duplicate copies of messages already on your page.
Limit
 limit integer

Return only the specified number of messages.
Page
 page integer

Get the page specified. If returned data is greater than the limit, you can use this field to access subsequent pages

Returns

List of one or multiple messages.

Message List
MessageList

Get messages in a thread (V2)

Operation ID:
GetMessagesInThreadV2

This operation returns the messages posted in a thread.

Parameters

Name Key Required Type Description
Thread ID
 thread_id True integer

Unique identifier of the thread.

Returns

List of one or multiple messages.

Message List
PageableMessageList

Get messages in a thread [DEPRECATED]

Operation ID:
GetMessagesInThread

This action has been deprecated. Please use Get messages in a thread (V2) instead.

This operation returns the messages posted in a thread.

Parameters

Name Key Required Type Description
Thread ID
 thread_id True integer

Unique identifier of the thread.

Returns

List of one or multiple messages.

Message List
MessageList

Get my networks

Operation ID:
GetNetworks

Gets all the networks that the user belongs to.

Returns

response
array of Network

Get the messages from my Following feed (V2)

Operation ID:
GetMessagesFollowingV2

This operation returns the messages from Following feed which is conversations involving people, groups and topics that the user is following.

Parameters

Name Key Required Type Description
Network ID
 network_id string

Unique identifier of the network.
Older than
 older_than integer

Returns messages older than the message ID specified as a numeric string. This is useful for paginating messages. For example, if you’re currently viewing 20 messages and the oldest is number 2912, you could append “?older_than=2912″ to your request to get the 20 messages prior to those you’re seeing.
Newer than
 newer_than integer

Returns messages newer than the message ID specified as a numeric string. This should be used when polling for new messages. If you’re looking at messages, and the most recent message returned is 3516, you can make a request with the parameter “?newer_than=3516″ to ensure that you do not get duplicate copies of messages already on your page.
Thread type of messages
 threaded string

Threaded=true will only return the thread starter (first message) for each thread. This parameter is intended for apps which need to display message threads collapsed. threaded=extended will return the thread starter messages and the two most recent messages all ordered by activity, as they are viewed in the default view on the Yammer web interface.
Limit
 limit integer

Return only the specified number of messages.

Returns

List of one or multiple messages.

Message List
PageableMessageList

Get the messages from my Following feed [DEPRECATED]

Operation ID:
GetMessagesFollowing

This action has been deprecated. Please use Get the messages from my Following feed (V2) instead.

This operation returns the messages from Following feed which is conversations involving people, groups and topics that the user is following.

Parameters

Name Key Required Type Description
Network ID
 network_id string

Unique identifier of the network.
Older than
 older_than integer

Returns messages older than the message ID specified as a numeric string. This is useful for paginating messages. For example, if you’re currently viewing 20 messages and the oldest is number 2912, you could append “?older_than=2912″ to your request to get the 20 messages prior to those you’re seeing.
Newer than
 newer_than integer

Returns messages newer than the message ID specified as a numeric string. This should be used when polling for new messages. If you’re looking at messages, and the most recent message returned is 3516, you can make a request with the parameter “?newer_than=3516″ to ensure that you do not get duplicate copies of messages already on your page.
Limit
 limit integer

Return only the specified number of messages.
Page
 page integer

Get the page specified. If returned data is greater than the limit, you can use this field to access subsequent pages

Returns

List of one or multiple messages.

Message List
MessageList

Get user details

Operation ID:
GetUserDetailsById

This operation returns user profile details.

Parameters

Name Key Required Type Description
User ID
 user_id True integer

Unique identifier of the user.

Returns

Properties of Yammer user.

User
User

Like message

Operation ID:
LikeMessage

This operation is used to like the specified message.

Parameters

Name Key Required Type Description
Message ID
 message_id True string

Unique id of the message.

Post message

Operation ID:
PostMessage

This operation is used to post a Message to a Group or All Company Feed. If group ID is provided, message will be posted to the specified group else it will be posted in All Company Feed.

Parameters

Name Key Required Type Description
Network ID
 network_id string

Unique id of the network.
Group ID
 group_id True integer

The group to post a message to (0 = All Company/Network).
Message Text
 body True string

Your message to be posted into your network.
Replied To Id
 replied_to_id integer

The message ID this message is in reply to.
Direct To Id
 direct_to_id integer

If set, a private message will be sent directly to the user with the indicated ID.
Broadcast
 broadcast boolean

Post message as an announcement to all users in a group.
Title
 title string

Title of the message to be posted.
Topic 1
 topic1 string

Topic to apply to the message.
Topic 2
 topic2 string

Topic to apply to the message
Topic 3
 topic3 string

Topic to apply to the message.
Topic 4
 topic4 string

Topic to apply to the message
Topic 5
 topic5 string

Topic to apply to the message.
Topic 6
 topic6 string

Topic to apply to the message.
Topic 7
 topic7 string

Topic to apply to the message
Topic 8
 topic8 string

Topic to apply to the message.
Topic 9
 topic9 string

Topic to apply to the message.
Topic 10
 topic10 string

Topic to apply to the message.
Topic 11
 topic11 string

Topic to apply to the message.
Topic 12
 topic12 string

Topic to apply to the message.
Topic 13
 topic13 string

Topic to apply to the message.
Topic 14
 topic14 string

Topic to apply to the message.
Topic 15
 topic15 string

Topic to apply to the message.
Topic 16
 topic16 string

Topic to apply to the message.
Topic 17
 topic17 string

Topic to apply to the message.
Topic 18
 topic18 string

Topic to apply to the message.
Topic 19
 topic19 string

Topic to apply to the message.
Topic 20
 topic20 string

Topic to apply to the message.

Returns

List of one or multiple messages.

Message List
MessageList

Triggers

When there is a new message in a group

This operation triggers when a new message is posted in a group.
When there is a new message in my followed feed

This operation triggers when there is a new message in a network followed by you.

When there is a new message in a group

Operation ID:
OnNewMessagesInGroup

This operation triggers when a new message is posted in a group.

Parameters

Name Key Required Type Description
Network Id
 network_id string

Unique identifer of the network.
Group Id
 group_id True integer

Unique identifier of the group.

Returns

List of one or multiple messages.

Message List
MessageList

When there is a new message in my followed feed

Operation ID:
OnNewMessagesFollowing

This operation triggers when there is a new message in a network followed by you.

Parameters

Name Key Required Type Description
Network ID
 network_id string

Pick a network.

Returns

List of one or multiple messages.

Message List
MessageList

Definitions

User

Properties of Yammer user.

Name Path Type Description
Username
 name string

Username.
Job title
 job_title string

User job title.
Location
 location string

User location.
Full name
 full_name string

User full name.
First name
 first_name string

User first name.
Last name
 last_name string

User last name.
Profile url
 web_url string

User profile url.
Email
 email string

User email.
Birth date
 birth_date string

User birth date.
Photo url
 mugshot_url string

User photo url.

Message

Properties of a single Yammer message.

Name Path Type Description
ID
 id integer

ID associated with the post.
Text
 content_excerpt string

Text Content of the post.
Sender
 sender_id integer

Unique ID of user who posted the message.
Replied to
 replied_to_id integer

ID of the message to which this message is a reply.
Created At
 created_at string

Time at which the message was created.
Network
 network_id integer

Id of the network message is associated with.
Type
 message_type string

Descripton of the message type.
Sender Type
 sender_type string

Description of the type of sender.
Url
 url uri

API url of the post.
Web Url
 web_url uri

Web url of the post.
Group ID
 group_id integer

Unique ID of group who posted the message.
Message Body
 body MessageBody

Content associated with a single message.
Thread ID
 thread_id integer

Unique ID of thread.
Direct message
 direct_message boolean

Flag to specify if the post is a a direct message.
Client Id
 client_type string

Type of the client.
Client URL
 client_url uri

Web link of the client.
Language
 language string

Language used in the message.
Tagged User
 notified_user_ids array of integer

Details of users notified.
Privacy
 privacy string

Details of the privacy associated with the message.
liked_by
 liked_by LikedBy

Liked By
Is System Message
 system_message boolean

Flag to specify if the post is a system generated message or not.
Topics
 topics array of Topic

List of topics.

Topic

Properties of a single topic.

Name Path Type Description
ID
 id integer

Unique identifier of the topic.
Name
 name string

Name of the topic.

PageableMessageList

List of one or multiple messages.

Name Path Type Description
Messages
 value array of Message

MessageList

List of one or multiple messages.

Name Path Type Description
Messages
 messages array of Message

messages

MessageBody

Content associated with a single message.

Name Path Type Description
Text
 parsed string

Parsed text format.
Plain
 plain string

Plain text format.
Rich
 rich string

Rich text format.

LikedBy

Liked By

Name Path Type Description
Count
 count integer

Number of distinct likes.
Names
 names array of object

List of people who liked the post.
Full Name
 names.full_name string

The full name of the person who liked the post.

Network

Properties of a single network.

Name Path Type Description
ID
 id string

Unique identifier of the network.
Name
 name string

Summary of the network.
Link
 permalink string

Web link to the network page.

YammmerEntity

Properties of a single yammer entity.

Name Path Type Description
Description
 type string

Details of the yammer entity.
Group ID
 id integer

Unique identifier of the group.
Full Name
 full_name string

Name of the yammer entity.