Manage access tokens

Microsoft Social Engagement requires you to provide access tokens in order to acquire data and interact with posts for social profiles. Facebook profiles, Facebook pages, and Twitter profiles, require access tokens before you can acquire and interact with posts. Instagram accounts require access tokens to acquire posts. Access tokens enable data acquisition and can be easily supplied by logging into your social media account. Acquisition tokens will not post anything to personal Facebook, Twitter, or Instagram accounts. We advise users to add at least two different tokens to Social Engagement. Adding more tokens can guarantee a faster data acquisition and reduce the risk of data acquisition stopping due to expired access tokens. Before adding a user token, make sure you have the appropriate user roles to add a social profile.More information: Manage social profiles

Note

Providing an access token is mandatory; not providing one will prevent Microsoft Social Engagement from acquiring private messages from Facebook pages and Twitter. The access tokens received from users are stored and encrypted in a secure database. The data acquired with tokens is not shared with any other Microsoft Social Engagement solutions.

The following table shows the tokens you need to add for your social profiles.

Type of social profile Type of token
Facebook profile Acquisition token: Acquire public data from Facebook pages

Interaction token: Publish and reply to posts on Facebook pages
Facebook page Interaction token: Acquire private messages from Facebook pages, and publish and reply to posts.
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.

Tokens for data acquisition

Adding tokens for data acquisition allows you to acquire posts from Instagram and Facebook. It’s important to understand that acquiring is a two-step process. After you add tokens and allow the data acquisition, you will not automatically start seeing posts. A power analyst or administrator needs to add a search rule for the added social profile when they set up a search topic in order to start analyzing posts from Facebook and Instagram. After users add a social profile and allowed data acquisition, they can also monitor Facebook pages and Instagram accounts they do not own. More information: Add rules to a search topic

Add a Facebook acquisition token and allow data acquisition

You need Facebook acquisition profilesto 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 re-authenticate your Facebook profile through emails sent from socialengagement@microsoft.com and through notifications in Social Engagement.

  1. Go to Settings > Social Profiles.

  2. Select the appropriate social profile, and then in the Facebook page/profile details panel, click re-authenticate Reauthenticate tokens button in Social Engagement under Allow data acquisition, and enter your log-in credentials.

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

  4. Click 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, click re-authenticate Reauthenticate tokens button in Social Engagement and enter your log-in credentials.

  3. Under Use for search acquisition, click 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. Click 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. 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 user token to interact with posts

  1. Go to Settings > Social Profiles.

  2. Select the appropriate social profile, and then in the Facebook user details panel, click re-authenticate Reauthenticate tokens button in Social Engagement and enter your log-in credentials.

  3. Under Use for Search Acquisition, click the drop-down arrow next to the search acquisition symbol Keywords symbol, and then select the check box next to Allow to interact with posts and replies on a Facebook page. The token will become active after you select the check box.

  4. Click Save.

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, click Re-authenticate Reauthenticate tokens button in Social Engagement and enter your credentials.

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

  4. Click 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, click Re-authenticate Reauthenticate tokens button in Social Engagement under Allow interactions, then enter your credentials. Under Acquisition of Private Messages, click 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. Click Save.

Re-authenticate a token

Expired tokens must be re-authenticated 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 click Re-authenticate Claim ownership button in Social Engagement.

  2. Enter the appropriate credentials.

Delete tokens

Please note that social profiles require at least one valid token to continue acquiring private messages.

  1. Go to Settings > Social Profiles.

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

  3. Click 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. More information: Microsoft Cognitive Services privacy statement

See Also

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