Launching Conversation Cloud - Reimagine CX in the Digital Age. Learn More
NEW! Pre-Approved WhatsApp Templates To Keep Your Customers Closer Explore
Conversational Internet is digitizing the other half of the world Learn More
You asked for our Gen AI secret sauce - Launching ACE LLM! Explore

Engage your users with Facebook’s Customer Matching API

On September 6, 2017 | 4 Minutes Read
GenericIntegrationsMessaging API
Facebook recently announced that they have over 100k bots and 100k developers working on Facebook Messenger. These impressive numbers are no doubt in part to Facebook’s commitment to listening to their developer base and improving their product constantly. Among the new features that they recently launched, their Customer Matching API went under the radar. But it is a feature that has the potential to bring in a lot of your existing users to your brand’s chatbot. This blog post will detail what the Customer Matching API is and how you can use it to engage your users.

Facebook’s announcement at F8 announcing 100k bots on the Messenger platform


Before you can implement the Customer Matching API for your chatbot, there are few prerequisites imposed by Facebook:

  • The bot has to be published. Else it works only for the admins of the FB page
  • The content sent using a phone number has to be non-promotional.
  • The content of messages sent complies with the same Platform Policies that apply for Subscription Messages.
  • The Facebook page your bot is attached to needs a United States-based admin.

In addition, you will have to pay a fee of $99 a year with a US credit or debit card to enable this feature.

Customer Matching

Essentially Customer Matching allows you to connect existing customers to your bot using their phone number or optionally, their name. Facebook has launched two versions of the same API:

  • Customer Matching API (closed beta)
  • Customer Matching with the Send API

We will talk about the latter as it is up for public use.

What this API does is match a phone number to whether a user is an FB Messenger user. This check is done via the Send API. If a matching user is found, a message request is shown on the user’s Messenger screen giving the user the option to ‘Accept’ or ‘Decline’ the invite. If the user clicks on the ‘Accept’ button, they are on-boarded to the bot.

(image source:

How to use Customer Matching

All businesses have a CRM with the customers’ details such as name and phone number. Traditionally these businesses have relied on re-engaging with their users via email or SMS. In a country like India, consumers are constantly bombarded with SMSes and emails from brands that are marketing their latest offers. What these brands don’t realize is that the engagement and conversion rates for SMS and email are very very poor. Most brands nowadays also have a strong social presence on platforms like FacebookInstagram and Twitter. Unfortunately, these brands can’t provide a unified experience for consumers across all these platforms due to a lack of identification across these platforms.

With the Customer Matching API, it becomes very simple for a brand to onboard their existing users onto their chatbot. Chatbots provide a far more engaging format for a brand to connect with their consumers. After all, we are in the age of conversational commerce. Chatbots can be used to send reminders and notifications to the user. It also supports rich media formats like images, GIFs and video. More importantly, chatbots can provide contextual and personalized responses to the user which makes the end-consumer feel closely connected with the brand they are interacting with. This experience is also opt-in from the user and the user can choose to unsubscribe at any point of time.

Advantages of a chatbot

The biggest advantage of a chatbot over SMS or email is that chatbots provide for two-way communication. Users can interact via text, interactive menus & buttons and also send emojis to the chatbot. This definitely increases the level of engagement a user has with a brand. Brands can also provide a unified experience to the user across a number of platforms including SMS, email and FB Messenger. And to top it all, mobile data is as good as free nowadays so there’s no major cost to the user as well.


The Customer Matching API is a great asset to bring users to your chatbot. To implement this feature using Gupshup, use the sendmsg API along with a specific context. Read this guide for a detailed explanation on how to do so.

Team Gupshup
Team Gupshup

Blogs you will want to share. Delivered to your inbox.

Business Email

Recommended Resources

5 Things That Can Indicate Your Customer Communication Needs a Revamp

Discover 5 signs signaling it's time to overhaul your customer communication strategy. Stay ahead in the...
Read More >

5 ways Conversational AI is Redefining Home Buying Experience in Dubai

Discover how Conversational AI is transforming the Dubai real estate market, making home buying faster, simpler,...
Read More >

The 3 Secrets to Future-proof Your Customer Engagement Efforts Through Gen AI

Learn the top strategies to future-proof your customer engagement efforts with Gen AI. Strengthen connections and...
Read More >
Read: Parametric codes, Send-to-Messenger button and other ways to drive users to your bots