m.me Links

m.me is a URL service provided by Meta that redirects people to a person, page, or conversation in Messenger. You can use them on your website, email newsletters, and more.

How It Works

The format for an m.me link is as follows where PAGE-NAME is the Facebook Page linked to your messaging app.

http://m.me/PAGE-NAME

When a person click an m.me link, they will be redirect to either a new or exist conversation with your business. A message will appear in the conversation stating: "You have entered this conversation by following a link. We've let PAGE-NAME know you're here."

An m.me link can contain a ref parameter that, when a person clicks on the link, provides your business with more context about the conversation such as a link on your website versus a link in a store. These types of links can also direct the person to specific content or features available within your Messenger experience.

http://m.me/PAGE-NAME?ref=REF-PARAMETER-INFORMATION

When a person clicks the Get Started button to start a conversation with your business, a messaging_postbacks webhook notification will be sent to your webhooks server. As part of this webhook notification the postback object will contain a referral object with the ref parameter.

When a person clicks an m.me link and a conversation already exists between your business and the person, the link will take them to the existing conversation. This action will reset the 24-hour standard messaging window, allowing your messaging app to reply to the person and a messaging_referrals webhook notification will be sent to your webhooks server. As part of this webhook notification a ref parameter from the m.me link will be included.

QR Codes

m.me links with ref parameters can be embedded into QR Codes. QR compatible codes can be scanned with a phone's native camera. When scanned they will open the Messenger app and the message conversation with your business.

QR Code Example

The example QR code has http://m.me/OriginalCoastClothing?ref=summer_coupon encoded that will trigger an example flow about a discount coupon on Messenger.

Referral Parameters

Before You Start

This guide assumes you have read the Messenger Platform Overview and implemented the needed components such as a Facebook Page for your business (or test Page), registered as a Meta developer, and created a Meta business app ID with the Messenger product.

You will need:

  • Advanced Access for the app that is linked to your business' Facebook Page
  • A Get Started Button for your Messenger experience for new conversations
  • The app linked to your business' Facebook Page must be subscribed to the messaging_postbacks and messaging_referrals webhooks fields

Limitations

  • The referral parameter is a string with a maximum character length of 2,083
  • Apps with Standard Access can only get information from people who have a developer, tester, or admin role on your messaging app

Webhook Notifications

When you receive a webhook notification it will contain information from a person who is starting a conversation with your business or from a person who has an existing conversation with your business.

Start a Conversation

When a person clicks the Get Started button to start a conversation with your business, we will deliver the ref param as part of the messaging_postbacks webhook notification.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

Continue in an Existing Conversation

If a conversation already exists between your business and the person who clicked the m.me link, the link the messaging_referrals webhook notification will be sent.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

See Also