Reminders for redmine_qbo_calendar appointments, to the customer's email in QuickBooks, sent from your own mailbox through Google Workspace's SMTP relay (or Gmail SMTP with an app password, or Redmine's email settings). - Schedule: N days before at a set time, only within sending hours, not within N hours of the appointment; rescheduling sends one for the new time - Plain text + HTML from an editable template with placeholders and sections, calendar (.ics) attachment, Message-ID on the sending domain - Each reminder claimed in the database before sending (no duplicates across processes); failures retried 3 times - Appointment page: status and Send now / Send again; customer page: turn reminders off; settings: test email, recent reminders, send due now - Runs on page loads every 10 minutes, or from cron via rake redmine:appointment_reminders:send - README covers Google Workspace setup and SPF/DKIM/DMARC Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BiwYMjhoQvL7XsKKfRz4pM
Redmine QBO Reminders
Emails customers a reminder before their appointments in redmine_qbo_calendar, at the email address on their QuickBooks Online customer (redmine_qbo). The email comes from your own mailbox (for example sales@yourdomain.com through Google Workspace), so there's nothing extra to pay for, and customers can reply to confirm or reschedule.
- When: a set number of days before the appointment at a set time (default: the day before at 4 PM), only between set hours (default 8 AM–8 PM), and not within a set number of hours of the appointment (default 2). An appointment booked after its reminder time gets one right away. Rescheduling an appointment sends a reminder for the new time.
- Which: appointments with the chosen statuses (default: Scheduled), with a customer who has an email address in QuickBooks and hasn't had reminders turned off.
- What: a short plain-text and HTML email in your words (placeholders for the customer, vehicle, day, time and shop details), with the appointment attached as a calendar file.
- Appointment page: whether the reminder was sent (when, to whom), when it will be, or why it won't be, with Send now / Send again.
- Customer page: turn reminders off (or back on) for a customer.
- Settings page: send a test email with the settings as they are on the page, see recent reminders (and why any failed), and send due reminders now.
Each reminder is recorded before it's sent, so a customer never gets two for the same appointment time, even with several Redmine processes. A failed send is tried again (3 times in all); it can always be sent from the appointment page.
Requirements
- Redmine 7
- redmine_qbo and redmine_qbo_calendar 2026.11.0 or later
Installation
cd /path/to/redmine/plugins
git clone https://github.com/rickbarrette/redmine_qbo_reminders.git
cd ..
bundle exec rake redmine:plugins:migrate
Restart Redmine, then set it up under Administration » Plugins » Redmine QBO Reminders plugin » Configure, and give the roles that should send reminders or turn them off for customers the Send appointment reminders permission.
Sending through Google Workspace
Reminders go out through Google's mail servers as your mailbox, which keeps them out of spam folders far better than mail sent straight from the Redmine server. Two ways, both included with Google Workspace:
SMTP relay service (recommended). In the Google Admin console: Apps » Google Workspace » Gmail » Routing » SMTP relay service » Configure:
- Allowed senders: Only addresses in my domains
- Authentication: Require SMTP Authentication (and/or Only accept mail from the specified IP addresses with your server's public IP)
- Encryption: Require TLS encryption
Then in the plugin's settings: SMTP server smtp-relay.gmail.com, port 587, domain your domain, and the mailbox's address and an app password (or leave both blank when the relay allows your server's IP). The relay allows up to 10,000 messages a day per user.
Gmail SMTP. SMTP server smtp.gmail.com, port 587, with the mailbox's address and an app password. Simpler (no Admin console change), with lower daily limits, and each reminder also lands in the mailbox's Sent folder.
App passwords: the mailbox needs 2-Step Verification; then Google Account » Security » App passwords. Google no longer accepts the account's regular password over SMTP.
Or choose Redmine's email settings to send through whatever config/configuration.yml uses.
The password is kept in Redmine's plugin settings (in the database), like other plugin settings, and is visible to administrators on the settings page.
Staying out of spam
-
DNS. Make sure your domain has:
- SPF: a TXT record including Google, e.g.
v=spf1 include:_spf.google.com ~all(one SPF record per domain; add the include to the one you have). - DKIM: Admin console » Apps » Google Workspace » Gmail » Authenticate email: generate a 2048-bit key, publish the TXT record it shows, then click Start authentication.
- DMARC: a TXT record at
_dmarc.yourdomain.com, e.g.v=DMARC1; p=none; rua=mailto:you@yourdomain.com. Move top=quarantineonce the reports look clean.
Check by sending a test (settings page) to a Gmail address and choosing Show original: SPF, DKIM and DMARC should all say PASS.
- SPF: a TXT record including Google, e.g.
-
From address on your domain, the same mailbox you send through, with your shop's name as the From name.
-
Keep the message personal and short. The default asks customers to reply to confirm; replies help your reputation. Avoid link shorteners and image-only mail.
-
Reminders are transactional, so they don't need an unsubscribe link; turning reminders off on the customer page covers customers who'd rather not get them.
-
Optional: Google Postmaster Tools shows how Gmail sees your domain once you send more.
Running on schedule
With Check on page loads on (the default), Redmine looks for due reminders every 10 minutes while anyone is using it. That's enough when Redmine is open during business hours.
To send them whether or not anyone is using Redmine, run the rake task every 15 minutes from cron:
*/15 * * * * cd /path/to/redmine && bundle exec rake redmine:appointment_reminders:send RAILS_ENV=production
In Docker, from the host's crontab:
*/15 * * * * docker exec <redmine container> bundle exec rake redmine:appointment_reminders:send RAILS_ENV=production
(Use the RAILS_ENV your Redmine runs in.) The task is safe to run alongside page-load checks.
Message placeholders
{{first_name}} (QuickBooks first name, else the first word of the name), {{customer}}, {{day}} (Tuesday, November 3), {{date}} (11/03/2026), {{time}} (9:00 AM), {{vehicle}}, {{subject}} (the appointment's subject), {{shop_name}}, {{shop_phone}}, {{shop_address}}.
{{#vehicle}}…{{/vehicle}} shows its text only when the appointment has a vehicle, and {{^vehicle}}…{{/vehicle}} only when it doesn't (any placeholder works). Lines left empty by missing values are dropped.
Time zone
Appointment times are read as entered, in the Shop time zone setting (default Eastern), whatever time zone the server runs in.
License
MIT