---
hide-page-toc: true
show-content: true
---

# Discuss

Odoo **Discuss** is an internal communication app that allows users to connect through messages,
notes, file sharing, and video calls. **Discuss** enables communication through a persistent chat
window that works across applications, or through the dedicated *Discuss* dashboard.

Upon opening the {menuselection}`Discuss app`, the {guilabel}`Discuss` dashboard appears.

## Inbox, starred, and history

Upon opening the {menuselection}`Discuss app`, the *Discuss* dashboard appears.

On the {guilabel}`Discuss` dashboard, unread messages are visible in the {icon}`fa-inbox`
{guilabel}`Inbox`. {icon}`fa-star-o` {guilabel}`Starred` is where starred messages are stored.
{icon}`fa-history` {guilabel}`History` shows chatter updates for records in the Odoo database the
user has been assigned to, or tagged on.

## Direct messages

*Direct messages* allow the user to communicate privately with one or multiple team members. To
start a new direct message, click the {icon}`fa-plus` icon, next to {guilabel}`Direct Messages` on
the {guilabel}`Discuss` dashboard, and enter the name of the desired person in the {guilabel}`Start
a conversation` search bar that appears.

:::{tip}
Multiple names can be selected in the {guilabel}`Start a conversation` search bar. Once all of
the names have been entered, press {kbd}`Enter`.
:::

### Direct message actions

Hover over a direct message in the chat window to see a menu of actions to take on the message.

- {icon}`oi-smile-add` {guilabel}`(Add a Reaction)`: open a drop-down menu of emojis that can be
  used to react to the direct message.

- {icon}`fa-reply` {guilabel}`(Reply)`: reply to the direct message in a thread.

- {icon}`fa-star-o` {guilabel}`(Mark as Todo)`: add the message to the {guilabel}`Starred` tab.

- {icon}`fa-ellipsis-h` {guilabel}`(Expand)`: reveals more message actions, including:

  - {icon}`fa-thumb-tack` {guilabel}`Pin`
  - {icon}`fa-eye-slash` {guilabel}`Mark as Unread`
  - {icon}`fa-pencil` {guilabel}`Edit`
  - {icon}`fa-trash` {guilabel}`Delete`

### Conversation actions

The icons in the top-right corner of a direct message conversation represent different actions the
user can take on that conversation.

Click {icon}`fa-bell` {guilabel}`Notification Settings` to set up notification preferences for the
conversation, or click {icon}`fa-phone` {guilabel}`Start a Call` to begin a meeting. See the
{ref}`Meetings <discuss/meetings>` section for more information about meetings.

At the top of the direct message window, click the name of the direct message to change the group
name, and choose to add a description in the adjacent {guilabel}`Add a description` field.

```{image} discuss/conversation-actions.png
:alt: View of the conversation actions.
```

:::{note}
The {guilabel}`Add a description` field is **only** available for group messages with more than
two participants.
:::

### User status

It is helpful to see what colleagues are up to, and how quickly they can respond to messages, by
checking their status. The status is displayed as a circle in the bottom-right corner of a contact's
photo in the {icon}`fa-users` {guilabel}`(Members List)`.

The color of the circle represents the user's status:

- Green = online
- Orange = away
- White = offline
- Airplane = out of the office

### Leave a direct message conversation

To leave a direct message conversations, click the {icon}`fa-times` {guilabel}`(Leave this channel)`
icon next to the conversation name in the {guilabel}`Direct Messages` section of the sidebar.

:::{note}
Leaving a conversation does **not** delete the direct messages in the conversation. The direct
message conversation's history is visible when another direct message with the same person, or
group, is created.
:::

(discuss-meetings)=

## Meetings

In **Discuss**, *Meetings* are video calls. To start a meeting from the {guilabel}`Discuss`
dashboard, click {guilabel}`Start a meeting` in the top-left corner, and select who to invite to the
meeting, via the {guilabel}`Invite People` drop-down window that appears. To start a meeting from a
direct message, click the {icon}`fa-phone` {guilabel}`Start a Call` icon in the top-right corner.

```{image} discuss/meeting.png
:alt: View of a Meeting in Odoo Discuss.
```

Once a meeting has been started, the following buttons can be used:

| Icon                        | Use                            |
| --------------------------- | ------------------------------ |
| {icon}`fa-microphone`       | {guilabel}`Mute`               |
| {icon}`fa-microphone-slash` | {guilabel}`Unmute`             |
| {icon}`fa-headphones`       | {guilabel}`Deafen`             |
| {icon}`fa-deaf`             | {guilabel}`Undeafen`           |
| {icon}`fa-video-camera`     | {guilabel}`Turn camera on/off` |
| {icon}`fa-hand-paper-o`     | {guilabel}`Raise Hand`         |
| {icon}`fa-desktop`          | {guilabel}`Share Screen`       |
| {icon}`fa-arrows-alt`       | {guilabel}`Enter Full Screen`  |

(discuss-app-notification-preferences)=

## User-specific notification preferences

Access user-specific preferences for the **Discuss** app by navigating to {menuselection}`Settings
app --> Manage Users`, select a user, then click the {guilabel}`Preferences` tab.

```{image} discuss/preferences-user.png
:alt: View of the Preferences tab for Odoo Discuss.
```

By default, the {guilabel}`Notification` field is set as {guilabel}`Handle by Emails`. With this
setting enabled, a notification email is sent by Odoo every time a message is sent from the chatter
of a record, a note is sent with an `@` mention (from the chatter of a record), or a notification is
sent for a record the user follows.

By choosing {guilabel}`Handle in Odoo`, the above notifications are shown in the **Discuss** app's
*Inbox*.

## Chat from different applications

The **Discuss** application enables communication across all of Odoo's applications. To view chats
and channels, or start a new message, select the speech bubbles that are consistently present in the
upper-right corner of the database header.

```{image} discuss/discuss-in-other-apps.png
:alt: Use Discuss across other applications by clicking the speech bubbles.
```

:::{seealso}
- {doc}`discuss/team_communication`
- {doc}`/applications/essentials/activities`
- {doc}`discuss/ice_servers`
- {doc}`discuss/chatter`
:::

```{toctree}
:titlesonly: true

discuss/team_communication
discuss/ice_servers
discuss/chatter
discuss/canned_responses
```