Skip to content

seven-io/redmine

Repository files navigation

seven logo

seven SMS & Voice for Redmine

Bulk and event-based SMS / voice messaging for Redmine via the seven gateway. Includes RedmineUP CRM support.

MIT License Redmine on Rails 5.2+ Ruby 2.7+


Features

  • Bulk SMS / Voice - Reach all users (or a filtered subset) via Administration > seven SMS / seven Voice
  • Issue-Based Notifications - Auto-fire SMS to the assignee on issue creation, gated by priority
  • Per-User Mobile Field - Plugin auto-installs a custom field "Mobile Phone" on users
  • CRM Integration - Bulk SMS to RedmineUP CRM contacts (when the RedmineUP CRM plugin is installed)
  • Profile Shortcuts - SMS / Voice links right on each user's profile page
  • Bilingual - English and German translations bundled

Prerequisites

Installation

cd /path/to/redmine/plugins
# extract the plugin archive into ./seven
bundle install
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=seven

Restart Redmine, then go to Administration > Plugins > seven > Configure and paste your seven API key.

Configuration

Setting Description
API Key Your seven API key
SMS From Default sender ID for SMS (max 11 alphanumeric / 16 numeric)
Voice From Default caller ID (verified or shared number)
Issue Priority Which issue priorities trigger automatic SMS
Issue Recipient Send to assignee or to a custom phone number
Issue Text Message template - supports {{id}} for the issue ID

Per-user setup

Each user fills the auto-installed Mobile Phone custom field via My Account.

Usage

Bulk Messages

  1. Go to Administration > seven SMS or seven Voice.
  2. Filter recipients (groups, admin, or RedmineUP table).
  3. Compose the message and send.

Individual Messages

Open any user profile and click seven SMS or seven Voice.

Automatic Issue Notifications

Once configured, new issues matching the priority filter trigger an SMS to the assignee or the configured number.

Troubleshooting

Problem Solution
No recipients found Make sure target users have the Mobile Phone custom field filled
API errors Verify the API key and account balance
Migration issues Confirm RAILS_ENV and NAME=seven are set correctly

Uninstalling

bundle exec rake redmine:plugins:migrate VERSION=0 RAILS_ENV=production NAME=seven

Support

Need help? Feel free to contact us or open an issue.

License

MIT