Negotiation Thread Unread Message Re-Notification
Negotiation Thread Unread Message Re-Notification
Overview
The Unread Message Re-Notification workflow automatically reminds agents and organisation admins when a tenant or landlord message in a negotiation thread has not received an agent reply within two days. It runs as a scheduled background job every morning at 10:00 UTC.
This prevents negotiation threads from going cold and ensures timely, compliant communication throughout the deposit deduction process.
How It Works
Each day at 10:00 UTC, the system evaluates all open negotiation threads against the following criteria:
| Condition | Value |
|---|---|
| Thread status | Open |
| Last message sender | tenant or landlord |
| Last message age | More than 2 days ago (lastMessageAt < today - 2 days) |
| Agent reply since last message | None |
If all conditions are met, a warning in-app notification is inserted for:
- The assigned agent on the negotiation thread
- All organisation admins in the agent's org
Notification Details
- Type:
warning - Channel: In-app notification
- Delivery: Once per qualifying thread per daily run
- Recipients: Assigned agent + all org admins
Schedule
Cron: 0 10 * * *
Time: 10:00 UTC, every day
Entities Involved
negotiationThreads— source of open threads to evaluatenegotiationMessages— used to determine last message sender and timestamp, and to check for agent repliesnotifications— where the warning notification record is insertedorgMembers— used to resolve assigned agents and identify all org admins
Frequently Asked Questions
Will an agent be notified multiple times for the same unanswered message? The workflow runs daily, so if a thread continues to have no agent reply, a reminder will be generated on each subsequent daily run until the condition is resolved.
What counts as an agent reply?
Any message on the thread where senderParty is not tenant or landlord — i.e. a message posted by an agent — sent after the last tenant/landlord message.
Does this affect closed or resolved threads? No. Only threads with an open status are evaluated.
Who receives the notification if no agent is assigned? All organisation admins will still receive the warning notification regardless of agent assignment.