Skip to main content

Connect chats bots to your API apps

Project description

CI: Requirements Status



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.


The full documentation is at


  • Telegram, Kik and Facebook Messenger bots
  • Message handling definition with regex, as django urls.
  • Text responses and keyboards with Jinja2 templates
  • Chat State handling
  • Asynchronous processing of messages
  • Media messages not supported


Install permabots:

pip install permabots

Add permabots to your INSTALLED_APPS, and run:

$ python 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:


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).

Remember there is an online implementation in to use it for free.


You can check and deploy a Permabots demo

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


0.1.0 (2016-05-16)

  • First release on PyPI.

Project details

Download files

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

Files for permabots, version 2.2.3
Filename, size File type Python version Upload date Hashes
Filename, size permabots-2.2.3.tar.gz (45.7 kB) File type Source Python version None Upload date Hashes View
Filename, size permabots-2.2.3-py2.py3-none-any.whl (71.5 kB) File type Wheel Python version 2.7 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page