Deltabot allows to implement and run chat bots for Delta Chat.
To install deltabot run the following command (preferably in a virtualenv):
$ pip3 install deltabotTry typing "deltabot --version" to verify it worked.
Note
Deltabot requires Delta Chat's Python bindings. On Linux bindings have pre-built binary wheels and thus the above deltabot install should just work. On other platforms you need to install the bindings from source, see deltachat Python bindings readme.
Configure an e-mail address for your chat bot (using example credentials):
deltabot init [email protected] OzrSxdx5hiaD
Within a Delta Chat app (or another e-mail client), you may now send a chat /help message to [email protected] and should get a short list of available commands in the reply.
Checkout the deltabot repo to play with some example bots:
git clone https://github.com/deltachat/deltabot cd deltabot
Now you can register an example bot and send/receive messages:
Register the example "mycalc bot":
$ deltabot add-module example/mycalc.py
Now start serving the chat bot:
$ deltabot serve
Within an Delta Chat app, you may now send a chat /help message to [email protected] and should get a short list of available commands in the reply. Send /mycalc 23+20-1 and wait for the the answer.
Note that the bot-answer speed largely depends on the provider you are using for the bot-email address. On test servers we get 3-5 seconds full roundtrips, between question and answer arriving back.
You can implement your plugin as a proper python package or wheel by using setuptools. Have a look in the examples/deltachat_echo example directory which contains a complete example.
Deltabot uses Autocrypt end-to-end encryption but note that the operator of the bot service can look into messages that are sent to it.
For many more examples and Deltabot plugins see:
https://github.com/simplebot-org/simplebot