--- title: "Instant Messaging in Zenople Mobile App" slug: "instant-messaging-in-zenople-mobile-app" tags: ["V-25-October Release"] updated: 2025-09-25T08:01:48Z published: 2025-09-25T08:01:48Z canonical: "zenoplesupport.aqore.com/instant-messaging-in-zenople-mobile-app" --- > ## Documentation Index > Fetch the complete documentation index at: https://zenoplesupport.aqore.com/llms.txt > Use this file to discover all available pages before exploring further. # Instant Messaging in Zenople Mobile App ## **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.