A Telegram bot to conduct your ambulatory assessment study by sending surveys to participants’ smartphones.

The bot script is written in Python, can be simply configured by a single JSON-file and runs under Windows, MacOS and Linux.

Features

• Use fix dates and times for your surveys or use day calculation depending on the subscribe-day and time calculation depending on the wakeup time of your participants.
• Three types of links are available: start-, daily- and endlinks
• Decide how long your survey links are visible in the telegram chat
• Assign different conditions to your participants
• Randomize your survey times

For a detailed description concerning the configuration and execution of the script, take a look at our wiki.

Used Libraries

• python-telegram-bot
• apscheduler

License

Copyright: (c) 2020, Michael Barthelmäs, Marcel Killinger, Johannes Keller. GNU General Public License v3.0 (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)

Telegram Survey Bot is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Telegram Survey Bot is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Citation

If you use our script, please cite it using the following information:

Barthelmäs, M., Killinger, M., & Keller, J. (2020). Telegram-Survey-Bot (Version 1.0) [Computer software]. Retrieved from https://github.com/Raze97/Telegram-Survey-Bot

Developed by Marcel Killinger and Michael Barthelmäs, supervised by Johannes Keller from Dept. Social Psychology Ulm University