Awesome Open Source
Awesome Open Source


Facebook Messenger Bot client for RingoJS. It provides a convenient interface to the HTTP-based Messenger Platform. The client has been tested with RingoJS 1.1.0 and newer. It supports almost all API methods of the Messenger Platform 2.0 and the Graph API v2.9 from April 18, 2017.


const bot = new FBMessenger("inser_pagetoken_here");

bot.sendTextMessage(recipientId, "Servus, I'm a bot!");

bot.sendButtonTemplate(recipientId, "Hello!", [
    "type": "web_url",
    "title": "Open Link",
    "url": ""
    "type": "postback",
    "title": "Get More Info",
    "payload": JSON.stringify({ event: "get_more" })

You can also take a look at the test bot which implements a lot of features of the Messenger Platform.

API Reference


The following APIs and methods are not implemented and not planned to be anytime soon:

  • ID Matching API
  • Payments


This package is licensed under the Apache License Version 2.0. You can copy, modify and distribute the bot client in source and/or binary form. Please mark all modifications clearly as being the work of the modifier.


  • 3.0.0 - implements changes for Messenger Platform v1.4 and v2.0, changed parameter order for templates, added message tags and changed parameter order for sendXYZ() methods, removed old thread APIs, added basic test bot
  • 2.3.0 - support for batched requests to the Graph API
  • 2.2.0 - adds support for Messenger Platform v1.3, new method isReferral() in utils to detect referral webhook calls
  • 2.1.0 - minor bugfix in the attachment methods
  • 2.0.0 - implements Messenger Platform v1.2, adds sendReusableAttachment() method, breaking change: new signatures of all sendXyzAttachment() methods to send reusable attachments
  • 1.0.0 - initial release for Messenger Platform v1.1

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (68,071
messenger-platform (17

Find Open Source By Browsing 7,000 Topics Across 59 Categories