Skip to main content
PropOps delivers notifications across four channels: in-app, email, push, and WhatsApp. This guide covers setting up each channel and managing user preferences.

​
In-app notifications

In-app notifications work out of the box — no setup required. The notification bell in the top navigation bar shows unread counts and opens the notification centre.

​
Managing your notifications

  • Select a notification to mark it as read and navigate to the relevant record.
  • Use Mark All Read to clear all unread indicators.
  • Filter by type — All, Unread, Case Notes, New Users, or Blacklist.
  • Select Clear All to permanently remove all notifications from your centre.

​
Email notifications

PropOps sends transactional emails via Brevo for events that need a persistent record.

​
Setting up SMTP

Your administrator configures the email connection in the .env file: 
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
MAIL_USERNAME=postmaster@mg.yourcompany.com
MAIL_PASSWORD=your_smtp_password
MAIL_FROM_ADDRESS=noreply@yourcompany.com
MAIL_FROM_NAME="PropOps"
MAIL_ENCRYPTION=tls

​
Email threading

When you reply to a PropOps case note email, your reply is automatically added as a new case note on the relevant job. No copy-and-paste needed — the full conversation stays inside PropOps.

​
Testing email delivery

docker compose exec web php scripts/test-email.php you@yourcompany.com

​
Push notifications

Push notifications appear as system notifications outside the browser — even when PropOps is not the active tab.

​
Requirements

  • HTTPS must be enabled on your PropOps instance.
  • VAPID keys must be configured in your .env file.

​
Generating VAPID keys

docker compose exec web npm run generate-vapid
Add the output to your .env: 
VAPID_PUBLIC_KEY=your_generated_public_key
VAPID_PRIVATE_KEY=your_generated_private_key
VAPID_SUBJECT=mailto:you@yourcompany.com
Restart the web container after updating: 
docker compose restart web

​
Installing the PWA

For the most reliable push notification experience, install PropOps as a Progressive Web App:
  1. Open PropOps in your browser.
  2. Look for the install icon in the address bar.
  3. Select Install and confirm.
  4. Grant notification permission when prompted.

​
WhatsApp notifications

WhatsApp messages are sent to contractors and tenants via the WhatsApp Business API using pre-approved templates.

​
Setting up WhatsApp

  1. Obtain API credentials from your WhatsApp Business API provider.
  2. Add them to your .env:
WHATSAPP_API_URL=https://graph.facebook.com/v18.0
WHATSAPP_API_TOKEN=your_api_token
WHATSAPP_PHONE_ID=your_phone_number_id
  1. Configure message templates under Admin → WhatsApp Templates.

​
Sending a WhatsApp message from a job

  1. Open the job.
  2. Select WhatsApp from the top action bar.
  3. Choose a message template from the dropdown.
  4. PropOps fills in the job details and sends the message.
The recipient must have an active WhatsApp account on their registered phone number. Only pre-approved template messages can be sent outside of an active conversation window.

​
User notification preferences

Each user controls which notifications they receive:
  1. Select your avatar in the top navigation bar.
  2. Go to Profile → Notification Preferences.
  3. Toggle each notification type on or off for each channel (in-app, email, push).
  4. Save your changes.
Security alerts and email verification messages are mandatory and cannot be disabled.

​
Organisation-wide defaults

Your administrator can set default notification preferences for all users under Admin → Settings → Notifications. Individual users can then override these defaults from their own preferences page.