c81d7d2bfb
Removed deprecations Removed new event system Added documentation for all events Added FAQ Changed Client.uid to Client.id Improved User model Prepared for support of pages
67 lines
2.4 KiB
ReStructuredText
67 lines
2.4 KiB
ReStructuredText
.. highlight:: python
|
|
.. module:: fbchat
|
|
.. fbchat documentation master file, created by
|
|
sphinx-quickstart on Thu May 25 15:43:01 2017.
|
|
You can adapt this file completely to your liking, but it should at least
|
|
contain the root `toctree` directive.
|
|
|
|
.. This documentation's layout is heavily inspired by requests' layout: https://requests.readthedocs.io
|
|
Some documentation is also partially copied from facebook-chat-api: https://github.com/Schmavery/facebook-chat-api
|
|
|
|
fbchat: Facebook Chat (Messenger) for Python
|
|
============================================
|
|
|
|
Release v\ |version|. (:ref:`install`)
|
|
|
|
.. generated with: https://img.shields.io/badge/license-BSD-blue.svg
|
|
|
|
.. image:: /_static/license.svg
|
|
:target: https://github.com/carpedm20/fbchat/blob/master/LICENSE.txt
|
|
:alt: License: BSD
|
|
|
|
.. generated with: https://img.shields.io/badge/python-2.7%2C%203.4%2C%203.5%2C%203.6-blue.svg
|
|
|
|
.. image:: /_static/python-versions.svg
|
|
:target: https://pypi.python.org/pypi/fbchat
|
|
:alt: Supported python versions: 2.7, 3.4, 3.5 and 3.6
|
|
|
|
Facebook Chat (`Messenger <https://www.facebook.com/messages/>`_) for Python.
|
|
This project was inspired by `facebook-chat-api <https://github.com/Schmavery/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 :ref:`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 <https://developers.facebook.com/docs/messenger-platform>`_ 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 :ref:`examples` to see example usage of `fbchat`
|
|
|
|
|
|
Overview
|
|
--------
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
install
|
|
intro
|
|
examples
|
|
testing
|
|
api
|
|
todo
|
|
faq
|