> ## Documentation Index
> Fetch the complete documentation index at: https://zuperinc-section23.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start Guide

The Chat feature enables faster team communication and real-time alignment through instant messaging. Use **Direct Messages** (DM) for private one-to-one discussions and **Channels** for group collaboration on teams, jobs, or topics. Chat is available on the web (V3) and mobile apps.

## Pre-requisites

Before you start, make sure the following requirements are met:

* Chat is available on Web V3, iOS v4.0.3+, and Android v4.1.7+.
* The Chat feature must be enabled for your organization. Contact your Customer Success Manager or email [support@zuper.co](mailto:support@zuper.co) to enable it.
* Your access and actions depend on your role (Admin, Team Lead, Field Executive).

## Getting Started: Sidebar (Web) / Home (Mobile) 

The Sidebar on web and the Home screen on mobile are where all conversations live. 

From here, you can: 

* View all conversations, including Direct Messages, Channels, and Pinned conversations.
* Filter conversations by Unreads, Recents, Threads, or Mentions.
* Start a new Direct Message or Channel.
* Search across Messages, Users, and Channels.

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/18hbHd4u-4FZsHlDZJSvQj_OnNCm2f4R_/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1CP3coTAoNVhalAiI8sZByBcJ2F8NvAHQ/preview" />
  </Tab>
</Tabs>

## Direct Messages (DMs)

Direct Messages are one-to-one conversations between users.

**Who can start DMs**:

* Field Executives and Team Leads can start DMs with their own team members.
* Admins can start DMs with any user.

<Note>
  Note: Field Executives and Team Leads can view and reply to DMs initiated by Admins.
</Note>

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1dwPBHs_tyLeiPETLEBdfJbumpp6A_wV7/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1jCuzK8CoVJG_2pC_nmnUUChVokdRcom8/preview" />
  </Tab>
</Tabs>

## **Channels** 

Channels let teams collaborate in group conversations. Zuper supports three types of channels.  

### **1. General Channel** 

Every organization in Zuper automatically has a **#general** channel. All users are added to this channel by default. 

You can use the **#general** channel for: 

* Organization-wide announcements 
* All-hands updates 
* Information everyone needs to stay aligned 

<Note>
  Note: The General channel cannot be archived. 
</Note>

### **2. Job-Specific Channels** 

Job-specific channels are created to centralize all communication related to a particular job. These channels are initiated from the **Job Details page** → **Chat** → **Start Conversation** and are automatically linked to the job.

Once created, the job channel appears in the global chat with the job name and a suitcase icon <Icon icon="suitcase" />for easy identification.

<img src="https://mintcdn.com/zuperinc-section23/i9GwNQ2t_tNVW6K1/images/Chatjob.png?fit=max&auto=format&n=i9GwNQ2t_tNVW6K1&q=85&s=6d3508d6b86516c9e1ae54f3878fd368" alt="Chatjob" width="1918" height="873" data-path="images/Chatjob.png" />

By using a job-specific channel, teams can:

* Share photos, documents, and files related to the job in one place.
* Exchange real-time updates as the job progresses.
* Receive automated real-time job updates such as clock-in/out, quote acceptance/rejection status, invoice payments, status updates, and user assignment.
* Keep all job-related discussions contextually tied to the job details.
* Ensure clear communication between office teams and field technicians.

<Note>
  Note:

  * Any user with permission to view a job can create a job channel using the **Start Conversation** button.
  * By default, assigned users, their TLs, and users configured in Job General Settings below are automatically added as channel members.

  **Settings options:**

  * **Add Job Creator to Job Channels** – Automatically include the job creator in every job channel.
  * **Add These Users to All Job Channels** – Automatically add selected users to all job channels.
</Note>

### **3. Custom Channels** 

Custom channels are created to organize conversations around specific ongoing topics, teams, or projects.

By creating a custom channel, teams can:

* Keep conversations focused and relevant to a particular topic or project.
* Make it easier for members to find past discussions, files, and decisions.
* Collaborate efficiently with the right people, without unnecessary noise
* Maintain clarity as projects evolve or topics continue over time.

## Creating Custom Channels

You can create a channel with one or more members for collaboration.

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1dTg_64_FV4wUpCnw8EX0r6Fzec5tz9yN/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1eGhbLoD_4GEatXgFQ4IhGQY_uFTLrA-C/preview" />
  </Tab>
</Tabs>

### Channel Managers

Channel Managers can control member access and help keep conversations organized.

**Channel Managers can:**

* Add or remove channel members.
* Assign other users as Channel Managers.
* Delete messages in the channel.

**Who becomes a Channel Manager:**

* **#general channel:**\
  All Admins are automatically assigned as Channel Managers.
* **Job channels:**\
  The following users are automatically assigned as Channel Managers:
  1. Team Leads of the assigned technicians.
  2. Primary Technician of the job.
  3. User who created the job (if enabled in Job General Settings).
  4. Any Admins added to the channel.
* **Other channels:**\
  The user who creates the channel is automatically assigned as the Channel Manager.

<Note>
  Note: Admins have Channel Manager permissions in any channel they join, even if not explicitly assigned.
</Note>

## Managing Conversation

You can manage conversations to stay focused and respond faster. Zuper lets you pin important conversations, mute distractions, and archive channels when they’re no longer active.

### Pin a Conversation

Pinning keeps it at the top in the “Pinned Conversations” for quick access.

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1J8s_oVx5Iu0aEio252qTxlpnEPe9WzV5/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1hD3IcN16NOlHqPeguhW5d2yL32ZIr80u/preview" />
  </Tab>
</Tabs>

### Mute a Conversation

Stops notifications and unread indicators (access remains). 

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1bCsCiocgZKk5Eq3uu2Wpo6ycxnaO3ii7/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1A96t_GAy94BlPdynk8stNRQajrUu1DyH/preview" />
  </Tab>
</Tabs>

### Archive a channel

Removes it from view for all users (searchable and restorable later).

<Note>
  Note: DMs and the #general channel cannot be archived.
</Note>

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1QOAJum27o0a357kihxjLuiSwkU9829n9/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1p1lAt61pX8nDjKEbpJYbx3tfj69Fb-tB/preview" />
  </Tab>
</Tabs>

## Sending and Managing Messages

### Mentions

Tag users (@username) or entities (Jobs, Projects, Customers, Quotes, Invoices) — triggers notifications for user mentions; entity mentions link to details.

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1yl6nqS25rpz8ojiuXpHhXk8L8LoQPJnI/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1LxvJpY1WmQsQQMYju9zapuPghdu8MzcP/preview" />
  </Tab>
</Tabs>

### Threads

Reply to a specific message to keep related discussions organized.

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1ClkRW1zMmhC8OCyk89yas_7j2hT_pezd/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/15-XpwtESikpS-HTuCAql6x92-psWMu9d/preview" />
  </Tab>
</Tabs>

### Reactions

Add emojis to acknowledge messages quickly.

<Tabs>
  <Tab title="Web">
    <img src="https://mintcdn.com/zuperinc-section23/7VdJ_IxSaA1jVOQk/images/Emoji.png?fit=max&auto=format&n=7VdJ_IxSaA1jVOQk&q=85&s=864205db87f45b8b3263d6f9f5f4cf56" alt="Emoji" width="1919" height="873" data-path="images/Emoji.png" />
  </Tab>

  <Tab title="Mobile">
    <img src="https://mintcdn.com/zuperinc-section23/cVfsjv9ToXcslK6O/Chat/Emoji.png?fit=max&auto=format&n=cVfsjv9ToXcslK6O&q=85&s=ed17e5a9ac88a767e74c2fba39c19005" alt="Emoji" width="1419" height="2796" data-path="Chat/Emoji.png" />
  </Tab>
</Tabs>

### Attachments

Share images, videos, documents — media appears in "**Photos & Videos**"; files in "**Files**" section.

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1iiDu-YycU3GZ6J-2BEDIpBUWSrKl5OeE/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1NDlAXrskl_7P-IRAke3_YKQIDHSCojeq/preview" />
  </Tab>
</Tabs>

### Pinning a message

Highlight key info within a conversation for easy reference. 

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1Cv-dvM1Z1gb8G-FY6WFr7MQXYlit8DAQ/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/1dMzRPlu5otJCsqMO1V_suH-LAWxYLhCl/preview" />
  </Tab>
</Tabs>

### Mark as unread

Flag messages to review later (thread replies excluded). 

<Tabs>
  <Tab title="Web">
    <img src="https://mintcdn.com/zuperinc-section23/cVfsjv9ToXcslK6O/Chat/unreadweb.png?fit=max&auto=format&n=cVfsjv9ToXcslK6O&q=85&s=2e86b3ce6afd41a67039e5131d43b35d" alt="unreadweb" width="1916" height="873" data-path="Chat/unreadweb.png" />
  </Tab>

  <Tab title="Mobile">
    <img src="https://mintcdn.com/zuperinc-section23/cVfsjv9ToXcslK6O/Chat/unreadmobile.png?fit=max&auto=format&n=cVfsjv9ToXcslK6O&q=85&s=073362f012aaeb9fbfd3f0f20d99cb08" alt="unreadmobile" width="1419" height="2796" data-path="Chat/unreadmobile.png" />
  </Tab>
</Tabs>

### Edit/Delete Messages:

* Users: Can edit/delete their own messages. 
* Channel Managers: Can delete others' messages (but can’t edit them).

<Tabs>
  <Tab title="Web">
    <img src="https://mintcdn.com/zuperinc-section23/cVfsjv9ToXcslK6O/Chat/Editdeleteweb.png?fit=max&auto=format&n=cVfsjv9ToXcslK6O&q=85&s=ca92e0783335395b04c6917c9799dc87" alt="Editdeleteweb" width="1917" height="876" data-path="Chat/Editdeleteweb.png" />
  </Tab>

  <Tab title="Mobile">
    <img src="https://mintcdn.com/zuperinc-section23/cVfsjv9ToXcslK6O/Chat/Editdeletemobile.png?fit=max&auto=format&n=cVfsjv9ToXcslK6O&q=85&s=823cb96c63ff3c727761e6ffb71567e7" alt="Editdeletemobile" width="1419" height="2796" data-path="Chat/Editdeletemobile.png" />
  </Tab>
</Tabs>

## Search

Quickly locate content: 

* Search across Messages, Users, and Channels. 
* Sort message results by creation date. 
* Filter message results by sender or channel. 

<Tabs>
  <Tab title="Web">
    <iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1Jn2pcHw1GqfRMl4aDFmICaHQpcHrbi8z/preview" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Tab>

  <Tab title="Mobile">
    <iframe width="325" height="515" src="https://drive.google.com/file/d/14BB5Jo46dVePfZldT5wOXiiU3o-iJZgP/preview" />
  </Tab>
</Tabs>

This streamlined guide focuses on essential steps to get you started quickly. For deeper details, refer to the articles below:

* **Channels**\
  Learn how to create, manage, and collaborate with your team using channels.
* **Direct Messages**\
  Learn how to start and manage private conversations with individuals.
* **Messages**\
  Learn how to send, receive, and organize messages effectively.
* **Search**\
  Learn how to quickly find messages, channels, and conversations using search.
