WARNING: API is work in progress. Don't consider it reliable until this message is removed.
- Create your bot using the Telegram @BotFather.
- After obtaining your bot API key, store it into a file called
apikey.txtinside the bot working directory. Alternatively you can use the--apikeycommand line argument to provide your Telegram API key. - Optionally edit
mybot.cto personalized the bot. - Build the bot: you need libcurl and libsqlite installed. Just type
make. - Run with
./mybot. There is also a debug mode if you run it using the--debugoption (add --debug multiple times for even more verbose messages). For a more moderate output use--verbose. Trymybot --helpfor the full list of command line options. - Add the bot to your Telegram channel.
- IMPORTANT: The bot must be an administrator of the channel in order to read all the messages that are sent in such channel. Private messages will work regardless.
By default the bot will create an SQLite database in the working directory.
If you want to specify another path for your SQLite db, use the --dbfile
command line option.
... Work in progress ...
For the bot API check mybot.c example itself. The basic usage is pretty simple. However for all the other stuff, like the Sqlite3 abstractions, they are taken from Stonky, so the code there (which is very accessible) will provide some help. I hope to document this project better. For now my main goal was to stop duplicating Stonly to create new bots with all the common code inside.