Manage access tokens

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 profile Acquisition token: Acquire public data from Facebook pages.
Facebook page Interaction token: Acquire private messages from Facebook pages, publish and reply to posts, and acquire author information for posts and comments.
Instagram account Acquisition token: Acquire public data from Instagram.
Twitter profile Interaction token: Acquire private messages from a Twitter profile, and publish and reply to posts.
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 acquisition profiles to acquire data from Facebook pages. You need to authenticate access tokens by logging into your account and allowing data acquisition to acquire public posts from a Facebook page.

Note

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

Important

While adding or reauthenticating a social profile for Facebook 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, and then in the Facebook page/profile details panel, select Reauthenticate your token Reauthenticate tokens button in Social Engagement under Allow data acquisition, and enter your log-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. The token will become active after you select the check box.

  4. Select Save.

Add an Instagram token and allow data acquisition

  1. Go to Settings > Social Profiles.

  2. Select the appropriate social profile (Instagram account) and in the Instagram account details panel, select Reauthenticate your token Reauthenticate tokens button in Social Engagement and enter your log-in credentials.

    Note

    If your organization owns multiple instances of Social Engagement, please add a unique Instagram profile for every instance. We can't acquire data if an Instagram profile is used in another Social Engagement instance.

  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 Instagram. 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

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