Plugin is designed to send notifications to Redmine’s users by Telegram or E-mail.
Please help us make this plugin better telling us of any issues you'll face using it. We are ready to answer all your questions regarding this plugin.
default
and telegram
. Config example - place it to redmine/config
directory (Or copy from plugins/redmine_intouch/extras/sidekiq.yml to config/sidekiq.yml).cd {REDMINE_ROOT}
git clone https://github.com/southbridgeio/redmine_intouch.git plugins/redmine_intouch
bundle install RAILS_ENV=production
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
The extras
folder has the examples of the plugin config files and the init.d
startup script
v1.4.0 introduces Redmine 4 support. If you're running Redmine 4, you need to run this task:
RAILS_ENV=production bundle exec rake intouch:fix_settings
to fix compatibility with Rails 5.
From 1.3.0 redmine_intouch depends on redmine_bots instead of redmine_telegram_common. Make sure to remove redmine_telegram_common from plugins and follow installation instruction for redmine_bots.
From 1.1.0 redmine_intouch (as well as other Southbridge telegram plugins) is using bot from redmine_telegram_common.
In order to perform migration to single bot you should run bundle exec rake telegram_common:migrate_to_single_bot
.
Bot token will be taken from one of installed Southbridge plugins in the following priority:
Also you should re-initialize bot on redmine_telegram_common settings page. Note that you need to manually replace old bot with the new one in group chats.
Since version 1.0.0 this plugin uses redmine_telegram_common 0.1.0 version, where removed Telegram CLI dependency. Please, take a look on new requirements.
Since version 0.2 this plugin uses redmine_telegram_common plugin.
Before upgrade install this plugin.
Then upgrade and run bundle exec rake intouch:common:migrate RAILS_ENV=production
for migrate data to new table.
Since 0.4 version, model TelegramUser
will be removed, also table telegram_users
will be removed.
You should specify all the necessary notification protocols in the "Protocols" section. These are 'telegram', 'slack' and 'email' available at the moment.
The section "Working days" should contain:
The section "Urgent Tasks" contains the ticket priorities, that will have notifications being sent despite of the time or day of a week.
The plugin contains the fuctionality that allows you to send scheduled notifications tagged as "In work" or "Feedback". Specify these statuses in appropriate sections so the plugin could parse them correctly.
Specify the following things before launching the bot:
User needs to add a bot with /start
command.
After that the bot prompts to enter the command /connect account@redmine.com
.
After the command, the user will receive an email with a link.
Following the link will connect the user's accounts.
If you have changed the bot, then each user needs to greet it personally.
One has to connect to the new bot if it has been changed. To do that all the participating Users should find the new bot via search and type the /start
command again.
The groups are added to Redmine, if the bot was added to them.
The group name is saved on addition. Issue the /rename
command in the group chat to change the group name in Redmine.
/help
- list of available commands with its descriptionsPrivate chat with bot
/connect e@mail.com
- connect Telegram and Redmine accounts/update
- update Telegram account info (after change name or username)Group chat
/update
- update group name (after change Telegram group name)Use command /setcommands
with @BotFather. Send this list for setup hints:
start - Start work with bot
connect - Connect Redmine and Telegram account
update - Update Telegram account info or group name
help - Help about commands
The settings templates allow you to set all the required project settings once, and then just choose the right template for each project. Read below of the settings of the plugin integrated into the project.
The plugin is provided with:
The periodicity of the repeating messages and the recipients settings are configured separately for each project or with templates. The regular notifications schedule is set on the Periodic tasks schedule tab located on the Plugin Settings page.
One has to initialize the periodic tasks before the plugin's first run.
To do this, click "Initialize periodic tasks" in the "Schedule periodic tasks" tab in the plugin settings.
You can also set periodic notifications schedule convenient for you.
Schedule is set using the cron syntax.
Select the Intouch module in the project settings on the "Modules" tab. As a result, the "Intouch" tab will appear in the Settings.
This tab includes three sections:
This section allows you to set instant notifications for the following recipients:
Important note: The Telegram user should issue the /start
command to recieve messages.
The intervals of Periodic Notifications for different priority types are specified in General Settings.
These tabs contain recipients of the Periodic Notifications with the "In work" and "Feedback" statuses.
This tab contains recipients of the Periodic Notifications that are:
This tab contains recipients of the Periodic Notifications that are:
Perhaps you have not initialized Periodic tasks schedule.
In plugin settings go to the Periodic tasks schedule tab and click Initialize periodic tasks.
The plugin is designed by Southbridge