fbchat: Facebook Chat (Messenger) for Python

Release v1.9.7. (Installation)

Facebook Chat (Messenger) for Python. This project was inspired by facebook-chat-api.

No XMPP or API key is needed. Just use your email and password.

Currently fbchat support Python 2.7, 3.4, 3.5 and 3.6:

fbchat works by emulating the browser. This means doing the exact same GET/POST requests and tricking Facebook into thinking it’s accessing the website normally. Therefore, this API requires the credentials of a Facebook account.

Note

If you’re having problems, please check the FAQ, before asking questions on GitHub

Warning

We are not responsible if your account gets banned for spammy activities, such as sending lots of messages to people you don’t know, sending messages very quickly, sending spammy looking URLs, logging in and out very quickly… Be responsible Facebook citizens.

Note

Facebook now has an official API for chat bots, so if you’re familiar with Node.js, this might be what you’re looking for.

If you’re already familiar with the basics of how Facebook works internally, go to Examples to see example usage of fbchat

Overview

• Installation
  • Install using pip
  • Get the Source Code
• Introduction
  • Logging In
  • Threads
  • Message IDs
  • Interacting with Threads
  • Fetching Information
  • Sessions
  • Listening & Events
• Examples
  • Basic example
  • Interacting with Threads
  • Fetching Information
  • Echobot
  • Remove Bot
  • “Prevent changes”-Bot
• Testing
• Full API
  • Client
  • Threads
  • Messages
  • Exceptions
  • Attachments
  • Miscellaneous
• Todo
  • Missing Functionality
  • Documentation
• FAQ
  • Version X broke my installation
  • Will you be supporting creating posts/events/pages and so on?
  • Submitting Issues