Instant Messaging in Zenople Mobile App
Enable direct instant messaging between office staff (Recruiters) and employees to improve communication related to assignments, while restricting chats strictly between specified user roles and providing granular access controls.
Scope
- Allow chat between:
- Office staff (Recruiters) ↔ Employees
- Employees can only chat with office staff.
- Support new message notifications.
- Chats initiated from assignment views.
- If multiple chat-enabled Recruiters are available, employees can select whom to chat with.
- Persistent chat navigation visible across the app for enabled users.
Detailed Requirements
Chat Initiation
- User initiates chat from an assignment (card view or details).
- For Employees: If multiple Recruiters have "Enable Chat" = true, display a selection list.
- Chat appears in the chat navigation list only after initiation.
Chat Participation
- Office staff and employees can send and receive messages in their chats.
- Chats are limited to office staff and employees only, no direct chatting among employees or contacts.
Notifications
- Users receive notifications on new messages.
- Notifications clearly indicate the sender.
Chat Navigation
- Chat navigation pane/tab remains visible at all times for users with access.
- Lists all active conversations, allowing easy switching.
User Interface Changes
- Assignment Screen: New chat button/icon to initiate chats with allowed users.
- Chat Navigation Pane: Persistent display of ongoing chats.
- Chat Window: Messaging interface with typical features (send, receive, timestamps).
- User Selection Modal: For Employees when multiple chat-enabled Recruiters are available.
Configuration Details
1. User Type Level Configuration
- Property: Enable Chat (Boolean) in User Type settings.
- Behavior:
- If TRUE for a user type, employees can chat with tagged persons of that type and vice versa.
- Employees can chat with user type having "Enable Chat" = TRUE.
- If multiple user types enabled, employees see a list to select their Recruiter.
- Default: "Recruiter" role has "Enable Chat" enabled via script.
- Integration:
- Chat button appears in Employee Portal assignment card view when enabled.
- Hierarchy Lookup:
- Tagged user roles resolved in this order: assignment → job → customer → root customer.
2. Organization Level Configuration
- Property: Enable Chat (multi-select) under ATM > Option > Company > Organization.
- Default: Chat disabled for all companies by default.
- Behavior:
- Enables or disables chat per company.
- Chat navigation visible only for users of enabled companies. >> control both for office staff and employee . If set to false the chat navigation wont be visible
- Disabled companies’ users cannot access the chat feature.
- Additional Control:
- Instant Messaging activated per company via "EnableChat" option and ETC option for granular permission.
3. Person Level Configuration for Office Staff
- ETC Option Property: New "Chat" value under ATM > Option > Person > Office Staff.
- Behavior:
- Office staff must have this "Chat" option selected to access chat navigation in mobile app.
- Without selecting this option, chat navigation is not visible.
- Purpose: Granular control over which office staff members access chat.
Core Instant Messaging Functionality
- Office staff and employees communicate directly about assignments.
- Chat initiated via assignment cards or details >> Emplopyee side
- Office staff can initiate chat with employees directly from the directory listing.
- Chat navigation is always visible once enabled.
- Notifications for new messages.
- Role-based restrictions ensure proper messaging routes.
- User selector shown if multiple chat-enabled office staff available.
- Hierarchy fallback for tagged user roles implemented.
Limitations and Known Behaviors
- Chats limited strictly to office staff and employees.
- Focused primarily on assignment-related communication.
- Employees must select recruiter if multiple are enabled.
- Chat disabled by default at company-level; must be enabled explicitly.
- Office staff’s "Chat" ETC option off by default; requires manual enablement.