{"_id":"57be19a0c90f500e0082a3a2","version":{"_id":"545137a814af501a00b50cfc","project":"545137a814af501a00b50cf9","__v":11,"createdAt":"2014-10-29T18:53:28.525Z","releaseDate":"2014-10-29T18:53:28.525Z","categories":["545137a814af501a00b50cfd","545138eaa66f020800dbab4a","546b9072b47b5d1400109edf","546b9082b47b5d1400109ee0","546b9088b47b5d1400109ee1","546b909462515a14007ebc43","546b90a0b47b5d1400109ee2","546ced235884600e007a92f6","5481008eea7fd40b00cd7c2b","573b9d83ee2b3b220042291f","57be1efa15efc70e006a5f99"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":2,"parentDoc":null,"category":{"_id":"57be1efa15efc70e006a5f99","project":"545137a814af501a00b50cf9","version":"545137a814af501a00b50cfc","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-08-24T22:26:02.805Z","from_sync":false,"order":10,"slug":"external-participants","title":"External Participants"},"project":"545137a814af501a00b50cf9","user":"5638f69b22afbc0d001f23c1","updates":["593943810073e80027c8adf3"],"next":{"pages":[],"description":""},"createdAt":"2016-08-24T22:03:12.995Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Yammer has a feature that allows users to add external participants to any thread (private conversations, public and private group messages) in their Yammer Network. This feature is supported by the REST API, Data Export API, and Open Graph integration.\n\nIf you are looking for more information about how the external participant feature works, you can visit: https://support.office.com/en-ca/article/Add-external-participants-to-your-Yammer-conversations-423653bb-86b2-4eac-9d7e-dca121f7c16c. \n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"REST API\"\n}\n[/block]\nTo get access to the API format that supports external participants, you need to provide the header\nyammer-capabilities: external-messaging, external-groups \nwhen making requests to the Yammer API. If you don't pass this header, you will get the older API format which filters out objects belonging to external participants.\n\n**External References**\nReferences to objects belonging to external participants will be provided in the external_references section of the payload; these references will contain only the subset of attributes that are visible to an external user. *Note: When you inspect the payload in search for references, you need to look for references also in the external_references section.*\n\n**Network ID**\nEvery object has a network_id attribute which can be used to check whether an object is external or not.\n\n**Autocomplete Endpoint**\nThe autocomplete endpoint will return suggestions for external users the current user has already interacted with.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"DATA EXPORT API\"\n}\n[/block]\n**MessageThread**\nData export includes the MessageThread model, which has information about the external participants in the thread plus the files included in those message threads.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"OPEN GRAPH\"\n}\n[/block]\n**Attachments**\nAttaching an Open Graph object, a topic, or a tag to a message as an external participant is not allowed.","excerpt":"","slug":"external-participants","type":"basic","title":"External Participants"}

External Participants


Yammer has a feature that allows users to add external participants to any thread (private conversations, public and private group messages) in their Yammer Network. This feature is supported by the REST API, Data Export API, and Open Graph integration. If you are looking for more information about how the external participant feature works, you can visit: https://support.office.com/en-ca/article/Add-external-participants-to-your-Yammer-conversations-423653bb-86b2-4eac-9d7e-dca121f7c16c. [block:api-header] { "type": "basic", "title": "REST API" } [/block] To get access to the API format that supports external participants, you need to provide the header yammer-capabilities: external-messaging, external-groups when making requests to the Yammer API. If you don't pass this header, you will get the older API format which filters out objects belonging to external participants. **External References** References to objects belonging to external participants will be provided in the external_references section of the payload; these references will contain only the subset of attributes that are visible to an external user. *Note: When you inspect the payload in search for references, you need to look for references also in the external_references section.* **Network ID** Every object has a network_id attribute which can be used to check whether an object is external or not. **Autocomplete Endpoint** The autocomplete endpoint will return suggestions for external users the current user has already interacted with. [block:api-header] { "type": "basic", "title": "DATA EXPORT API" } [/block] **MessageThread** Data export includes the MessageThread model, which has information about the external participants in the thread plus the files included in those message threads. [block:api-header] { "type": "basic", "title": "OPEN GRAPH" } [/block] **Attachments** Attaching an Open Graph object, a topic, or a tag to a message as an external participant is not allowed.