@Mentions

@Mentions allows a Facebook Page to have public conversations with Users who have commented on a Page. The Page can mention the User publicly in a comment or a reply within the post and the User will be notified that they have been mentioned. In order for a Page to mention a user, the User must have commented on the Page post or be the author of the Page post.

Users can mention a Page in their posts using `@[page-id]`. For example the following message would mention the Facebook Developers Page inline:

"Test message @[19292868552] tag"

Usage of this feature is subject to review. To test in dev mode, use Pages you are an admin of (both to make the API call, and to be used in a mention) and an app of which you are a developer. You must set Tagging Ability to on to allow mentioning of your Page.


Mentioning a User in a Comment

Work Flow Example

Step 1. Get the post_id.

GET graph.facebook.com
  /page_id/feed

Example Response:

{
  "created_time": "2017-10-19T17:21:09+0000",
  "message": "Happy Friday!",
  "id": "post_id"
},

Step 2. Use the post_id to get the comment_id. Select the comment_id with fields from to get the user_id of the person you wish to mention.

GET graph.facebook.com
  /post_id/comments?field=from

Example Response:

{
  "data": [
    {
      "created_time": "2017-10-30T22:34:27+0000",
      "from": {
        "name": "Liz",
        "id": "user_id"
      },
      "message": "Happy Monday!",
      "id": "comment_id"
    },
    {
      "created_time": "2017-10-31T16:40:16+0000",
      "from": {
        "name": "JP",
        "id": "user_id"
      },
      "message": "Happy Tuesday!",
      "id": "comment_id"
    }
  ],
}

Step 3. Post your reply mentioning the user.

POST graph.facebook.com
  /{post_id}/comments?
    access_token={access-token}&
    message="Happy Friday! @[user_id]"

Example Response:

{
  "id": "{new-comment-ID}"
}

Why Use @Mentions

A conversation occurs on a business' page with multiple replies. The business wishes to reply to a specific user's comment or reply. With @mentions, the business can reply to that specific user in the conversation.

@Mentions is also a great way for businesses to batch respond to users to address broader themes that surface in a conversation. For example, let's say a business posts about their new Fall Sale and they receive hundreds comments and replies on the post. Instead of finding each individual person's comment and replying, they could comment or reply back once and @mention multiple users. Also, there may be multiple responses on a comment but wish to submit one response @mentioning everyone who replied.