per

permabots

Connect instant messaging bots to your APIs.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

80

Maintenance

Last Commit

2yrs ago

Contributors

1

Package

Dependencies

0

License

BSD

Categories

Readme

=============================

Permabots

.. image:: https://github.com/jlmadurga/permabots/raw/master/docs/images/logos/permabots.png :target: https://github.com/jlmadurga/permabots

CI:

.. image:: https://travis-ci.org/jlmadurga/permabots.svg?branch=master :target: https://travis-ci.org/jlmadurga/permabots

.. image:: https://coveralls.io/repos/github/jlmadurga/permabots/badge.svg?branch=master :target: https://coveralls.io/github/jlmadurga/permabots?branch=master

.. image:: https://requires.io/github/jlmadurga/permabots/requirements.svg?branch=master :target: https://requires.io/github/jlmadurga/permabots/requirements/?branch=master :alt: Requirements Status

PyPI:

.. image:: https://img.shields.io/pypi/v/permabots.svg :target: https://pypi.python.org/pypi/permabots

Docs:

.. image:: https://readthedocs.org/projects/permabots/badge/?version=latest :target: https://readthedocs.org/projects/permabots/?badge=latest :alt: Documentation Status

Build chat bots and connect then to your app APIs.

With Permabots you can build chat bots and with the same configuration use it for several instant messaging providers. Permabots was born to be a microservice to connect messaging providers to your apps using REST APIs.

.. image:: https://github.com/jlmadurga/permabots/raw/master/docs/images/demo.gif :target: https://github.com/jlmadurga/permabots

Documentation

The full documentation is at https://permabots.readthedocs.org.

Features

  • Telegram, Kik and Facebook Messenger bots
  • Message handling definition with regex, as django urls.
  • HTTP methods: GET/POST/PUT/DELETE/PATCH
  • Text responses and keyboards with Jinja2 templates
  • Chat State handling
  • Asynchronous processing of messages
  • Media messages not supported

Quickstart

Install permabots::

pip install permabots

Add permabots to your INSTALLED_APPS, and run::

$ python manage.py migrate permabots

Instant messaging providers uses webhooks to send messages to your bots. Add permabots processing urls to your urlpatterns::

url(r'^processing/', include('permabots.urls_processing', namespace="permabots"))

Webhooks are generated with django.contrib.sites. You need it installed and SITE_ID configured. If you want to generate webhook manually you can do it::

MICROBOT_WEBHOOK_DOMAIN = 'https://yourdomain.herokuapp.com' 

It is usefull when you don't have https in your public domain but you have it in your autogenerated domain. i.e. heroku.

Bots are associated to Django Users. You need at least one user, for example admin user.

Then you can create all permabots data, Bots, Conversation Handlers, Notitication Hooks,... via Django admin or with REST API (recommended).

Demo

You can check and deploy a Permabots demo https://github.com/jlmadurga/permabots-demo

.. image:: https://www.herokucdn.com/deploy/button.svg :target: https://heroku.com/deploy?template=https://github.com/jlmadurga/permabots-demo/tree/master

Running Tests

Does the code actually work?

::

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install -r requirements/test.txt
(myenv) $ make test
(myenv) $ make test-all

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial