Notification Settings

Notification Types

Repair Lifecycle

• • New repair created → Assigned manager + contractor
• • Contractor assigned → Manager + tenant (if portal enabled)
• • Contractor en route → Manager + tenant
• • On site / work started → Manager
• • Repair completed → Manager + tenant + admin (audit)
• • Repair needs parts / follow-up → Manager + contractor
• • Quote submitted → Manager (for approval)

Safety & Compliance

• • Safety latch triggered → All admins + designated safety officer (immediate, all channels)
• • Gas safety certificate expiring (30/7/1 days) → Admin + property manager
• • EPC expiring → Admin + property manager
• • HMO licence expiring → Admin
• • Fire risk assessment due → Admin + safety officer

System

• • New team member joined → Admins
• • Contractor certificate expiring → Admin
• • Payment failed / subscription issue → Billing contact
• • API rate limit warning → Technical contact

Configuring Recipients

Go to Settings → Notifications.

Per notification type, you can:

• • Enable/disable
• • Choose channels (email, SMS, Slack, in-app)
• • Set recipients by role (Admin, Manager, Safety Officer, All)
• • Add custom email addresses
• • Set quiet hours (e.g., 22:00–07:00 for non-emergency)

Emergency safety alerts (gas, fire, structural) cannot be silenced and always use all channels.

Slack Integration

1. Go to Settings → Notifications → Slack

2. Click "Add to Slack"

3. Authorise the MaintenanceOS app

4. Select default channel for repair updates

5. Map notification types to channels (optional)

MaintenanceOS posts rich messages with repair details, photos, and action buttons.

Webhook Events

For custom integrations, configure webhooks at Settings → Integrations → Webhooks.

Event payload example:

```json

{

"event": "repair.completed",

"timestamp": "2025-01-15T14:32:00Z",

"workspace": "wks_abc123",

"data": {

"repairId": "rep_xyz789",

"propertyId": "prop_456",

"category": "plumbing",

"contractorId": "ctr_111",

"cost": 245.00

}

}

```

Headers: `X-MaintenanceOS-Signature` (HMAC-SHA256 for verification)

Testing Notifications

Use the "Send Test Notification" button on each notification type to verify delivery.

Next Steps

• • Slack Integration Guide
• • Webhook Developer Guide
• • Safety Alert Escalation

---

Pre-launch documentation. Features and workflows may change before general availability.