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


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.