Entry Points

People can discover and enter into a conversation with your bot from a number of different places or entry points.

Entry Points:

  • If your app is Public, you can be discovered through Search in Messenger
  • By clicking on the "Send Message" button on your Page
  • By scanning your Messenger Code using their phone camera
  • By clicking on your Messenger Link with the format https://m.me/PAGE_USERNAME
  • Through our Send To Messenger or Message Us web plugins
  • Phone Number (Customer) Matching

"Send to Messenger" Plugin

The "Send to Messenger" plugin is a web plugin that works on desktop and mobile web. You can place it on your website at points of entry for Messenger. When a person opts into communication with your bot through this plugin, we refer to it as "authentication." When the user is authenticated, we will send a backend callback so the person will not be taken out of your experience.

If the person successfully completes the flow, an authentication event is delivered to your webhook. The button will visually confirm completion by showing a check mark. If the plugin is reloaded (e.g., through a subsequent visit to the page or a visit to another page), the visual state will reset. Each time a person clicks the Send-to-Messenger plugin, it will send an authentication event.

You can surface the plugin on any page. Using a pass-through parameter, you can identify the page and context under which it was clicked. This parameter can be used to link the context of the link to the thread.

Active Session

When we detect an active Facebook session, we display a person's name and profile pic. This shows which identity is being connected to the bot. The first time a person clicks on this button, a confirmation popup will be presented.

If a person clicks 'Not you?', we will logout that person and present a Login dialog just like the flow when there is no existing active session.

No Active Session

When there isn't an active session, no identity is surfaced. When the button is clicked, we will present a Login dialog.

When your app is in development mode, or if your app is public but does not have approval for Messenger platform, the plugin is only visible to admins, developers and testers of the app. Therefore, the plugin will not be visible when there isn't an active session since the user cannot be identified.

Buttons Styles

Buttons come in different colors and sizes.

Implementation

The "Send to Messenger" plugin uses the Javascript SDK and requires an app ID and page ID. When a person completes the flow successfully, an authentication event is sent to the webhook you defined.

The plugin takes in a pass-through parameter defined by you. This parameter is sent back to you via a callback. You can use this to link the authentication event to a person and/or transaction. For example, a person may enter an online flow for a specific transaction and click the Send-to-Messenger button. You can pass in data to know which user and transaction was tied to the authentication event. You should encode and encrypt this parameter.

All plugins require the platform version to be set to 2.6 or greater.

Render the Plugin

Add the plugin to your page. Select a color and size.

<div class="fb-send-to-messenger" 
  messenger_app_id="APP_ID" 
  page_id="PAGE_ID" 
  data-ref="PASS_THROUGH_PARAM" 
  color="blue" 
  size="standard"></div>

Use the data-ref param to pass state with the authentication. If you surface the plugin in multiple places, you may want to modify the state based on the place where the plugin is shown.

View the plugin reference doc to learn more details on the plugin.

Receive the Authentication Event

When a person clicks on the plugin, an authentication event is sent to your webhook. You must have subscribed to the messaging_optins field when you setup your webhook. Read about the Opt-in Callback for more information.

"Message Us" Plugin

The "Message Us" plugin can be used to immediately start a conversation and send the person to Messenger. The user is either sent to messenger.com on desktop web or the Messenger native app on mobile.

Active Session

If there is an active session, the person is taken directly to Messenger and into a chat with the Page.

No Active Session

When there is no active session, a Login dialog will appear and, upon authentication, the person will be taken to a chat with the Page.

Buttons Styles

Buttons come in different colors and sizes.

Implementation

You will not receive any events just from the conversation being opened. The first event you would receive is when the person sends a message.

Render the Button

<div class="fb-messengermessageus" 
  messenger_app_id="APP_ID" 
  page_id="PAGE_ID"
  color="blue"
  size="standard" ></div>

The Facebook Javascript SDK is required for our plugins.

View the plugin reference doc to learn more details on the plugin.

Phone Numbers (Customer Matching)

With the pages_messaging_phone_number permission, you can send messages to people in Messenger if you have their phone number and their consent to be contacted by you. We will match the person in Messenger for verified phone numbers.

When using phone numbers, messages for new conversations will appear in Message Requests. People have the choice to Accept or Ignore your message. If they accept, then the thread will be moved to the inbox and subsequent messages will appear there.

Until your message has been accepted, the person will be in an anonymized state. As a consequence, the User Profile API will not return a person's profile information.

In order to use Customer Matching, the Page must have a United States address or have at least one admin who is in the United States.

Link ads with Messenger as a destination

To further enable targeted discovery of experiences on the Messenger Platform, advertisers will now be able to select Messenger as a destination under the website clicks objective. They can use any call-to-action in their ad, including "Send Message", to link to Messenger. All clicks on the News Feed ads will directly open up a Messenger thread with a copy of the ad or configurable structured message. Read more information about ad setup and experience.

Other Entry Points

Pages

Some people will discover your bot through your Page. You may wish to configure your Page to use the "Send Message" call to action (CTA).

Messenger Search

Your bot is also discoverable from Messenger Search. Whilst typing in the search box, we'll show a typeahead dialog that will enable people to find your bot.

We will also display a list of bot's that we think people might want to connect with.

Your bot is only discoverable once your app has been through App Review and been approved.

With https://m.me/username, you can:

  • Follow a link to be taken directly into a thread with that business or bot
  • Share your own Messenger Link via SMS, Facebook, email, or anywhere else to help someone find you more easily within Messenger

Messenger links make it easy to find a business in Messenger. You can share your link with people or publish it to help them start a conversation with your business or bot.
Find the Messenger Link for your page by tapping the settings link from the Facebook Pages Manager app.

Messenger Codes

With Messenger Codes, you can:

  • Scan a Messenger Code when you first meet someone to automatically find them and send them a message
  • Share your own Messenger Code in person with friends
  • Publish your own Messenger Code anywhere (profile images, business cards, marketing material) so people can find you

People can find their Messenger code by tapping People followed by Scan Code on the Messenger app. You can then view and share your code or scan someone else's.

You can find and download your bots Messenger code by clicking Messages at the top of your page. Then clicking the i (information) icon which appears at the bottom of your Messages inbox.

Please ensure your Page profile image is greater than 1000px by 1000px to ensure you can download high resolution Messenger Codes.