documentation/content/applications/productivity/discuss.md
2025-02-27 18:56:07 +07:00

169 lines
6.4 KiB
Markdown

---
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
```