Metadata-Version: 1.1
Name: django-fbbot
Version: 0.1
Summary: fbbot is a simple Django app to showcasing the Messenger Platform, make your facebook bot with Django
Home-page: https://github.com/espacioAntonio/Django-messenger-platform-bot
Author: espacioAntonio
Author-email: espacio.antonio@gmail.com
License: MIT License
Description: ===============================
        Facebook Messenger Bot : fbbot
        ===============================
        
        fbbot is a simple Django app to showcasing the Messenger Platform, make your facebook bot with django
        
        Quick start
        ------------
        
        Note. If yo don't have a https server and domain. For development purposes I use NGROK, a good "Secure tunnels to localhost" service ( url:https://ngrok.com/ )::
        
           > Download ngrok binary https://ngrok.com/download
           > execute ./ngrok http 8000
           > Copy url like '12345678.ngrok.io'
        
        1. Clone this repo and install the requeriments::
        
            git clone https://github.com/espacioAntonio/Django-messenger-platform-bot.git
            cd Django-messenger-platform-bot
            pip install -r requirements.txt
        
        2. Add your valid settings in ./fbbot/settings.py::
        
            FB_PAGE_TOKEN = "FACEBOOK_PAGE_TOKEN"
            FB_VERIFY_TOKEN = "VERIFY_TOKEN_DEFINED_BY_DEVELOPER"
            REAL_URL = "URL_PROVIDED_BY_NGROK" #example: 12346578.ngrok.io or www.yourdomain.com
        
        3. Run::
        
            python manage.py runserver 8000
        
        4. Suscribe your new webhook in your Facebook App::
        
            WEBHOOK
            URL Callback: https://YOUR_REAL_URL/fbbot/webhook
            Verify Token: "VERIFY_TOKEN_DEFINED_BY_DEVELOPER"
        
        5. Visit http://127.0.0.1:8000/fbbot/webhook and see "Hello World, webhook enable" message.
        
        6. Send a message to your facebook page or send this messages::
        
            image
            gif
            audio
            file
            button
            generic
            receipt
            quick reply
            read receipt
            typing on
            typing off
            account linking
        
        Integrate this app with your Django App
        ----------------------------------------
        
        1. Install the django-fbbot package with python-pip::
        
            pip install django-fbbot
        
        2. Add your valid tokens in your settings file mysite/settings.py::
        
            FB_PAGE_TOKEN = "FACEBOOK_PAGE_TOKEN"
            FB_VERIFY_TOKEN = "VERIFY_TOKEN_DEFINED_BY_DEVELOPER"
            REAL_URL = "URL_PROVIDED_FOR_NGROK" #example: 12346578.ngrok.io or www.yourdomain.com
            BASE_URL = "https://"+REAL_URL
        
        3. Add "fbbot" to your INSTALLED_APPS setting like this::
        
            INSTALLED_APPS = [
                ...
                'fbbot',
            ]
        
        4. Include the fbbot URLconf in your project urls.py like this::
        
            url(r'^fbbot/', include('fbbot.urls')),
        
        5. Run `python manage.py collectstatic` to collect files to test.
        
        6. Start the development server and visit http://127.0.0.1:8000/fbbot/webhook
        
        7. Visit http://127.0.0.1:8000/fbbot/webhook and see "Hello World, webhook enable"
        
        8. Send a message to your facebook page or send this messages::
        
            image
            gif
            audio
            file
            button
            generic
            receipt
            quick reply
            read receipt
            typing on
            typing off
            account linking
        
        Uninstall
        --------------------------------------------
        
        1. If you want to uninstall this package run::
        
            pip uninstall django-fbbot
        
        2. Remove "fbbot" in your INSTALLED_APPS setting::
        
            INSTALLED_APPS = [
                ...
                'fbbot',
            ]
        
        3. Remove the fbbot URLconf in your project urls.py::
        
            url(r'^fbbot/', include('fbbot.urls')),
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
