> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/administration/using-the-essential-assistant/team-chat.md).

# Team chat: message the people in your business

Team chat is a private chat between the people in your business, inside Essential. Office staff use it from the web app's assistant panel, and technicians use **More > Team Chat** in the mobile app. Messages are live: a reply appears as soon as it is sent, without refreshing.

Someone with **Set up Business Profile** permission can turn on Team chat under **Settings > Team > Team Chat**.

> **Where to find it:** Click the assistant bubble in the corner of any page, then the **Team Chat** tab (between **AI Chat** and **Essential Support**). On a phone, see [Message your team in the mobile app](https://learn.withessential.com/field-operations/mobile/message-your-team.md).

## Start a conversation

1. Open the assistant bubble and click **Team Chat**.
2. Click **New message**.
3. Tick one person for a direct message, or two or more for a group. Use **Search people** to find someone quickly.
4. For a group, type a **Group name** if you want one. Without a name, the group shows its members' names.
5. Click **Start conversation** (or **Start group**).

A direct message with someone is one conversation: starting a new message with the same person opens the conversation you already have. Anyone in your business can start a conversation with anyone else.

On desktop, the conversation list stays on the left, like past chats in **AI Chat**. On a narrow screen, use the menu or back arrow to choose another conversation. Team chat headers are teal to distinguish them from the assistant.

Team chat remembers where you were. If you close the assistant panel and open it again, it returns to the **Team Chat** tab and the conversation you had open.

## Send messages and files

Type in the message box and press **Enter** to send. Press **Shift + Enter** for a new line. Click the paperclip to attach photos, PDFs, CSVs, or spreadsheets; attachments upload before you send, and you can remove one with its **x** before it goes out.

You can also drop files over an open conversation or paste copied files into it. Up to ten attachments can be included in a message. Photos, including HEIC images, and animated GIFs show in the conversation as the whole image, not cropped. Click a photo or any other attachment to open it full size in the file viewer.

Type `:` to open the emoji grid, then keep typing to filter it (for example, `:smile`). Press Enter to select a match, use the arrow keys to browse, or Escape to dismiss. You can also choose **Add emoji** to browse the full picker and skin tones. Links in messages are clickable. A link to a record in Essential (a property, customer, quote, and so on) shows the record's type and name, for example **Property · 12 Main St**, instead of the raw link. If you can't open that kind of record, the link shows its type only.

If a message cannot be sent, it stays in the conversation marked **Not sent** with **Retry** and **Discard**.

Team chat is turned on for the whole business by someone with the **Set up Business Profile** permission under **Settings > Team > Team Chat**. Until then the **Team Chat** tab is not shown.

## Send a GIF or sticker

1. In the message box, click the sticker button next to the emoji button (**Add a GIF or sticker**).
2. Choose the **GIFs** or **Stickers** tab. Popular ones show first.
3. Type in **Search KLIPY** to find something specific. Scroll down and click **Load more** for more results.
4. Click a GIF or sticker to select it; a send arrow appears on it. Click it again (or the arrow) to send it as its own message, or click a different one instead.

GIFs and stickers play in the conversation without a bubble around them. In the conversation list, notifications, and emails they show as **Sent a GIF** or **Sent a sticker**. You can also paste or upload a GIF file like any other attachment.

## Voice notes

Click **Record voice note**, allow microphone access, then **Stop recording**. You can listen to the recording or remove it before clicking **Send**. Recordings stop at two minutes.

A voice note in the conversation shows a play button, a waveform, and its length. Click the play button to listen and again to pause; a playhead moves across the waveform as it plays. Click anywhere on the waveform to jump to that point.

## Search messages

Use **Search chats and messages** in the left menu to find conversations by name or messages by their text. Message search starts after two characters and includes older messages. Choose **More results** to continue through matches. Click a result to open its conversation. Click the **x** in the search box to clear it and see all your conversations again.

## Unread messages, the badge, and the sound

* The assistant bubble shows a red count of conversations with messages you have not read. The **Team Chat** tab shows the same count, and an unread conversation has a red dot in the list.
* Opening a conversation marks it read. Your read position is shared with the mobile app.
* When a new message arrives in a conversation you are not looking at, the browser plays a short chime. Turn it off under **Settings > Personal Settings > Notifications > Team chat**.
* While you have unread conversations and the panel is closed, the bubble pulses and the browser tab's title shows the count, for example **(2) Essential**, so you can see it from another tab.
* You can also get a **desktop notification** when a message arrives while you are in another tab or window. Click **Turn on desktop notifications** at the bottom of the conversation list and allow notifications when the browser asks. Click its **x** to hide that prompt if you don't want them. You can change this later under **Settings > Personal Settings > Notifications > Team chat**. Clicking the notification opens that conversation. This is set per browser.

## Groups

In a group conversation, use the **⋮** menu in the conversation header to **Add people**, **Rename group**, or **Leave group**. The header lists the current members. Someone who leaves keeps the messages they already saw but receives nothing new.

### Rename a group

Anyone in a group can rename it.

1. Open the group and click the **⋮** menu in the header.
2. Click **Rename group**.
3. Type the new **Group name** and click **Save**.

Everyone in the group sees the new name right away, on the web and in the mobile app. Clear the name and save to show the members' names instead.

## Avatars and colors

Each person appears in Team chat with their avatar: an avatar made from their photo, their photo, or a standard avatar in a circle of their color, or their initials on their color. Everyone chooses their own under **Settings → Personal Settings → Account → Avatar** (see [Choose your avatar](https://learn.withessential.com/administration/settings/choose-your-avatar.md)). A person's color is the same one used on the schedule and map; anyone without a color shows in gray.

## Mute a conversation

Use the **⋮** menu and choose **Mute**. A muted conversation does not count toward the unread badge, does not chime, and does not email you; you still see its messages when you open it. Choose **Unmute** to turn notifications back on.

## Notifications when you are away

Team chat notifies people who are not looking at the conversation:

* **Push notifications** go to the mobile app for every new message, except while that conversation is open on the phone. Tapping one opens the conversation.
* **Email** covers messages that stay unread. Depending on your setting, Essential emails you a summary if a message is still unread after 15 minutes or 1 hour, or once a day. One email covers everything unread since the last one; you never get an email per message.
* **Outside working hours** (your business's hours in Settings), you can choose to still get push notifications, to get nothing (**Don't send anything**), or to get an email instead of a push. This choice only affects push; emails about unread messages still follow your email setting.

Your business sets the defaults under **Settings > Team > Team Chat** (see [Turn on team chat for your business](https://learn.withessential.com/administration/settings/turn-on-team-chat-for-your-business.md)); change yours under **Settings > Personal Settings > Notifications > Team chat**. Mobile users find the same choices under the mobile app's Settings. Nobody is emailed about a conversation they have muted.

## Who can see a conversation

Only its members. Essential staff cannot read conversations either. In some businesses an administrator has been given access to every conversation in the business; they see an **All conversations** section in the list and can read, but not post in, conversations they are not a member of.

## Related

* [Using the Essential Assistant](https://learn.withessential.com/administration/using-the-essential-assistant.md)
* [Message your team in the mobile app](https://learn.withessential.com/field-operations/mobile/message-your-team.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://learn.withessential.com/administration/using-the-essential-assistant/team-chat.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
