Skip to main content

Facebook Messenger Slave Channel for EH Forwarder Bot, based on ``fbchat``.

Project description

PyPI release Translate this project

Channel ID: blueset.fbmessenger

EFMS is a channel that connects to Facebook Messenger for EH Forwarder Bot, based on simulation of Facebook Messenger Web, and fbchat.

Beta version

This is an unstable beta version, and its functionality may change at any time.


  • Python >= 3.6
  • EH Forwarder Bot >= 2.0.0

Getting started

  1. Install required binary dependencies

  2. Install

    pip3 install efb-fb-messenger-slave
  3. Enable the channel in the profile’s config.yaml.

    The path to the current profile may vary depends on your configuration.

    (In EFB 2.0.0a1, the default profile path is ~/.ehforwarderbot/profiles/default )

  4. Sign in

    $ efms-auth

    And follow the instructions.

Known issues

  • Message reactions from others and you on other clients will not be received by EFMS.

Optional configuration file

EFMS allows user to enable or disable experimental features with the configuration file. It is located at <Path to current profile>/blueset.fbmessenger/config.yaml.


# Experimental flags
# This section can be used to enable experimental functionality.
# However, those features may be changed or removed at any time.
# Options in this section is explained afterward.
    option_one: 10
    option_two: false
    option_three: "foobar"

Tips and tricks

  • To react to a message, reply (target) to the message with one of the following commands:
    • r`LOVE for 😍
    • r`SMILE for 😆
    • r`WOW for 😮
    • r`SAD for 😢
    • r`ANGRY for 😠
    • r`YES for 👍
    • r`NO for 👎
  • To send large emoji, send the emoji as text following by S, M, or L as small, medium and large emoji accordingly.

Experimental flags

The following flags are experimental features, may change, break, or disappear at any time. Use at your own risk.

  • proxy_links_by_facebook (bool) [Default: true]

    Deliver links (including links in share entities and thumbnails) using Facebook’s proxy. Disable this option to show the source directly.

  • send_link_with_description (bool) [Default: false]

    When processing link message from the Master Channel, attach the title and description besides the link when the option is enabled.


    Regardless of this option, link messages are sent as text, and Facebook Messenger may or may not attach its own link preview per its system configuration.*

  • show_pending_threads (bool) [Default: false]

    When showing the threads list, include threads pending approval.

  • show_archived_threads (bool) [Default: false]

    When showing the threads list, include archived threads.


EFMS’s chats provides the following vendor specific options:

  • 'chat_type' (str): Type of the thread: 'User', 'Page', or 'Group'.
  • 'profile_picture_url' (str): URL to the thread’s profile picture.

Experimental localization support

EFMS supports localized user interface prompts experimentally, by setting the locale environmental variable (LANGUAGE, LC_ALL, LC_MESSAGES or LANG) to one of our supported languages. Meanwhile, you can help to translate this project into your languages on our Crowdin page.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
efb_fb_messenger_slave-2.0.0b8-py3-none-any.whl (89.7 kB) Copy SHA256 hash SHA256 Wheel 3.7
efb-fb-messenger-slave-2.0.0b8.tar.gz (39.8 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page