Manage access tokens

Important

Microsoft Social Engagement will be discontinued on January 16, 2020. Additionally, starting October 1, 2019, the service will no longer support Twitter as a data source. For more information, see Changes coming to Dynamics 365 Market Insights preview and Microsoft Social Engagement.

Microsoft Social Engagement requires you to provide access tokens in order to acquire data from some sources and interact with posts using social profiles. Access tokens enable data acquisition and can be easily supplied by adding a social profile in Social Engagement where users sign in to social media accounts. We recommend that multiple users add tokens to guarantee a faster data acquisition and reduce the risk of data acquisition stopping due to expired access tokens.

Note

The data acquired through a user's token is exclusively available in your organization's Social Engagement solutions.

Social Engagement provides acquisition tokens (to acquire data on behalf of a user from a social media site) and interaction tokens (to post on behalf of a user to a social media site). The following table shows the tokens available for social profiles.

Type of social profile Type of token
Facebook and Instagram profile Acquisition token: Acquire public data from Facebook pages and Instagram business accounts you own.
Facebook page Interaction token: Acquire private messages from Facebook pages, publish and reply to posts, and acquire author information for posts and comments.
Twitter profile Interaction token: Acquire private messages from a Twitter profile.
YouTube account Interaction token: Comment and rate video posts and reply to comments on YouTube.

Tokens for data acquisition

Adding tokens for data acquisition allows you to acquire posts from some sources. It’s important to understand that acquiring these posts is a two-step process. After you add tokens to allow the data acquisition, you also need to create a search rule in a search topic in order to start acquiring direct messages or posts from Facebook pages and Instagram.

Add a Facebook acquisition token and allow data acquisition

You need Facebook and Instagram acquisition profiles to acquire data from Facebook pages and Instagram business accounts you own. You need to authenticate access tokens by logging into your account and allowing data acquisition to acquire public posts from a Facebook page and the Instagram business accounts linked to them.

Note

Provided tokens will expire after 60 days. Microsoft Social Engagement will notify you to reauthenticate your profile through emails sent from socialengagement@microsoft.com and through notifications in Social Engagement.

Important

While adding or reauthenticating a social profile for Facebook and Instagram data acquisition, Social Engagement might encounter an error due to rate limits on our Facebook connector app. Please wait about 15 minutes before trying to add or reauthenticate your profile.

  1. Go to Settings > Social Profiles.

  2. Select the appropriate social profile or create a new one, and then in the Facebook and Instagram acquisition profile details panel, select Reauthenticate your token Reauthenticate tokens button in Social Engagement under Allow data acquisition, and enter your sign-in credentials.

  3. Under Use for search acquisition, select the drop-down arrow next to the search acquisition symbol Keywords symbol, and select the check box next to Allow to acquire data from Facebook pages and Instagram business accounts. The token will become active after you select the check box.

  4. Select Save.

Tokens for interactions with posts

Adding tokens for interactions with posts allows you to acquire private messages from Facebook pages and Twitter, as well as publish and reply to posts. Additionally, you'll need an active Facebook page interaction token to be able to pull author information for Facebook pages you own. An interaction token is needed for every Facebook page separately. If no interaction token is provided, post and comments from users on the Facebook page will surface in Social Engagement without author information.

You can check your token health states to make sure your tokens aren't expired. More information: Check the health state of your social profiles

Note

View your social profiles page to add a token. If you don't see the social profile in question, you can add a social profile and add tokens directly.

Add a Facebook page token and allow data acquisition for private messages

  1. Go to Settings > Social Profiles.

  2. Select the appropriate social profile, and in the Facebook page details panel, select Reauthenticate your token Reauthenticate tokens button in Social Engagement and enter your credentials.

  3. Under Acquisition of private messages, select the drop-down arrow next to the private messages symbol Private messages symbol , and then select the check box next to Allow to acquire private messages to and from your Facebook account. The token will become active after you select the check box.

  4. Select Save.

Add a Twitter token and allow data acquisition for private messages

  1. Go to Settings > Social Profiles.

  2. Select the appropriate social profile, and then in the Twitter profile details panel, select Reauthenticate your token Reauthenticate tokens button in Social Engagement under Allow interactions, then enter your credentials. Under Acquisition of Private Messages, select the drop-down arrow next to the private messages symbol Private messages symbol and select the check box next to Allow to acquire private messages to and from your Twitter account. The token will become active after you select the check box.

  3. Select Save.

Reauthenticate a token

Expired tokens must be reauthenticated to continue data acquisition and interactions with posts. You can also check the health state of your tokens in your lists of social profiles. More information: Check the health state of your social profiles

  1. Select the appropriate social profile and select Reauthenticate your token Claim ownership button in Social Engagement.

  2. Enter the appropriate credentials.

Delete tokens

You can remove tokens from social profiles you own.

  1. Go to Settings > Social Profiles.

  2. Select the appropriate social profile, and in the social profile panel select the Delete your token button Delete button next to the token you want to delete.

  3. Select Save.

Privacy notice

Microsoft Social Engagement uses Microsoft Cognitive Services to detect the language of the content in private messages from Twitter and Facebook pages. To detect the language, only the title and content of private messages are sent to Microsoft Cognitive Services. The title and content of private messages are not stored in Microsoft Cognitive Services. Review the privacy statement for Microsoft Cognitive Services.

See Also

Engage on social networks
Set up searches to listen to social media conversations
Manage social profiles