> 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/field-operations/mobile/message-your-team.md).

# Message your team in the mobile app

Team chat lets you message the office and other technicians from the field. Open **More**, then tap the **Team Chat** square. **Support** remains separate for **AI Chat** and **Essential Support**. Messages are live, and the office sees them in the web app's assistant panel.

Someone with **Manage users** permission turns on team chat under **Settings > Team > Team Chat** in the web app. Until then, the Team Chat square is hidden.

> **Where to find it:** Mobile app > **More > Team Chat**.

## Start a conversation

1. Open **More > Team Chat**.
2. Tap the compose button (the pencil) at the bottom right of the conversation list, beside the search box.
3. Tick one person for a direct message, or two or more for a group. Use **Search people** to find someone.
4. For a group, add a **Group name** if you want one.
5. Tap **Start conversation** (or **Start group**).

## Search your chats

The search box at the bottom of the conversation list, **Search chats and messages**, finds conversations by name and messages by their text. Tap a result to open its conversation.

## Send messages and photos

Type in the message box and tap the arrow to send. Tap the paperclip to attach a **Photo** from your library or a **File**; photos appear as thumbnails while they upload. Tap a thumbnail to preview it, or tap its **×** to remove it before sending.

Photos in a conversation show the whole image, not cropped. Tap a photo to open it full size.

Tap the paperclip and choose **Record voice note**, allow microphone access, then tap **Stop** to attach the recording. Tap the send arrow when ready. Recordings stop at two minutes; leaving the app cancels an unfinished recording. Recording and uploading need a connection.

A voice note in the conversation shows a play button, a waveform, and its length. Tap play to listen and tap again to pause; a playhead moves across the waveform as it plays.

## Send a GIF or sticker

1. In a conversation, tap the paperclip and choose **GIF or sticker**.
2. Choose **GIFs** or **Stickers**. Popular ones show first; type in **Search KLIPY** to find something specific, and scroll for more.
3. Tap one to select it; a send arrow appears on it. Tap it again to send it as its own message, or tap a different one instead. Use the back arrow to return to the conversation without sending.

GIFs and stickers play in the conversation without a bubble around them. Finding GIFs and stickers needs a connection.

## When you are offline

You can still write messages. Each one shows **Queued to send** under it and goes out, in order, as soon as the phone reconnects. A message the server rejects shows **Not sent** with **Retry** and **Discard**. Starting a new conversation and adding people need a connection.

## Unread messages and notifications

* The **More** tab in the bottom bar shows a badge with the number of conversations that have unread messages. An unread conversation has a red dot in the list.
* You get a push notification for each new message unless that conversation is open on your screen. Tapping the notification opens the conversation.
* If a message stays unread, Essential can email you a summary; see the **Team chat notifications** section of the app's Settings to choose the email timing, turn push on or off, and decide what happens outside working hours.

## Groups and muting

In a conversation, tap the **⋮** button in the header to open its options: **Add people**, **Rename group**, and **Leave group** (groups only), or **Mute** the conversation. A muted conversation does not badge, push, or email; you still see its messages when you open it.

To rename a group, choose **Rename group**, type the new **Group name**, and tap **Save**. Anyone in the group can rename it, and everyone sees the new name right away. Clear the name and save to show the members' names instead.

## Your avatar

Your teammates see your avatar next to your messages: an avatar made from your photo, your photo, or a standard avatar in a circle of your color, or your initials on your color. To change it, tap your avatar at the top right, then **Settings → Avatar** (see [Choose your avatar](https://learn.withessential.com/administration/settings/choose-your-avatar.md)).

## Related

* [Get help in the mobile app](https://learn.withessential.com/field-operations/mobile/get-help-in-the-mobile-app.md)
* [Team chat on the web](https://learn.withessential.com/administration/using-the-essential-assistant/team-chat.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/field-operations/mobile/message-your-team.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.
