mirrors/nextcloud-documentation
3
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-10-26 11:18:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix(user): add the new features and cleanup old main files

Browse Source 
Signed-off-by: Dorra Jaouad <dorra.jaoued7@gmail.com>
This commit is contained in:
Dorra Jaouad 2025-10-08 23:07:33 +02:00
parent b857299693
commit b11337f215
11 changed files with 318 additions and 853 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

304
user_manual/talk/advanced_features.rst
View File

@ -1,304 +0,0 @@
Advanced Talk features
======================
Nextcloud Talk has a number of advanced features users might find useful.
Notifications and privacy
-------------------------
By default, Nextcloud Talk will notify you about:
- New messages in private conversations;
- Replies to messages you sent;
- Messages mentioning you or group/team you are member of;
- Started calls in conversations you are part of.
You can change this behavior in the conversation settings. Additionally, you can configure:
- **Important conversations**: you will be always notificed about new messages, even if you are in "Do Not Disturb" mode;
- **Sensitive conversations**: content of messages will not be shown in the conversation list and obscured from notifications.
.. image:: images/conversation-notifications.png
:width: 300px
To have more control over your privacy, you can also configure the visibility of your typing and read indicators in ``Talk settings``:
.. image:: images/privacy-settings.png
:width: 400px
Matterbridge
------------
Matterbridge integration in Nextcloud Talk makes it possible to create 'bridges' between Talk conversations and conversations on other chat services like MS Teams, Discord, Matrix and others. You can find a list of supported protocols `on the Matterbridge github page. <https://github.com/42wim/matterbridge#features>`_
A moderator can add a Matterbridge connection in the chat conversation settings.
.. image:: images/matterbridge-settings.png
:width: 700px
Each of the bridges has its own need in terms of configuration. Information for most is available on the Matterbridge wiki and can be accessed behind ``more information`` menu in the ``...`` menu. You can also `access the wiki directly. <https://github.com/42wim/matterbridge/wiki>`_
Lobby
-----
The lobby feature allows you to show guests a waiting screen until the call starts. This is ideal for webinars with external participants, for example.
.. image:: images/lobby-in-talk.png
:width: 600px
You can choose to let the participants join the call at a specific time, or when you dismiss the lobby manually.
Commands
--------
Nextcloud allows users to execute actions using commands. A command typically looks like:
``/wiki airplanes``
Administrators can configure, enable and disable commands. Users can use the ``help`` command to find out what commands are available.
``/help``
.. image:: images/command-help.png
:width: 600px
Find more information in the `administrative documentation for Talk. <https://nextcloud-talk.readthedocs.io/en/stable/commands/>`_
Talk from Files
---------------
In the Files app, you can chat about files in the sidebar, and even have a call while editing it. You first have to join the chat.
.. image:: images/join-chat.png
:width: 500px
|
.. image:: images/sidebar-chat.png
:width: 500px
You can then chat or have a call with other participants, even when you start editing the file.
.. image:: images/text-and-talk.png
:width: 700px
In Talk, a conversation will be created for the file. You can chat from there, or go back to the file using the ``...`` menu in the top-right.
.. image:: images/file-room.png
:width: 400px
Create tasks from chat or share tasks in chat
---------------------------------------------
If Deck is installed, you can use the ``...`` menu of a chat message and turn the message into a Deck task.
.. image:: images/deck-talk-create-card-menu.png
:width: 500px
|
.. image:: images/deck-talk-create-card-dialog.png
:width: 400px
From within Deck, you can share tasks into chat conversations.
.. image:: images/deck-talk-share-card-to-chat-menu.png
:width: 400px
|
.. image:: images/deck-talk-share-card-to-chat-in-talk.png
:width: 600px
Meetings and events
--------------------
If calendar events have a Talk conversation set as event location, you will see an information about upcoming events inside of this conversation.
That way you can stay informed about scheduled meetings or activities directly within your chat.
If Calendar app is enabled, you can click on an event to view details.
.. image:: images/events-upcoming.png
:width: 400px
It is possible to schedule a meeting directly from a conversation. In the dialog, you can set meeting details such as title, date, time and description.
You can also choose to invite all participants including email guests, or select specific ones.
.. image:: images/talk-schedule-meeting.png
:width: 400px
Schedule from Calendar
^^^^^^^^^^^^^^^^^^^^^^
When creating a new event in Calendar, you can set a Talk conversation as event location. This will create a new conversation if one does not exist yet.
.. image:: images/calendar-create-event.png
:width: 600px
When the event is created, you will see a link to the conversation in the event details. Conversation will also show up in the list of conversations (discoverable by ``Events`` filter).
.. image:: images/event-conversation-list.png
:width: 300px
Like instant meetings, event conversations will be automatically deleted after configured period of inactivity (by default 28 days).
Breakout rooms
--------------
Breakout rooms allow you to divide a Nextcloud Talk call into smaller groups for more focused discussions. The moderator
of the call can create multiple breakout rooms and assign participants to each room.
.. note:: Breakout rooms are currently not available in conversations that are joinable by guests (public conversations).
Configure breakout rooms
^^^^^^^^^^^^^^^^^^^^^^^^
To create breakout rooms, you need to be a moderator in a group conversation. Click on the top-bar menu and click on
"Setup breakout rooms".
.. image:: images/talk-breakout-rooms-setup.png
:width: 400px
A dialog will open where you can specify the number of rooms you want to create and the participants assignment method.
Here you'll be presented with 3 options:
- **Automatically assign participants**: Talk will automatically assign participants to the rooms.
- **Manually assign participants**: You'll go through a participants editor where you can assign participants to rooms.
- **Allow participants choose**: Participants will be able to join breakout rooms themselves.
.. image:: images/talk-breakout-rooms-setup-dialog.png
:width: 500px
Manage breakout rooms
^^^^^^^^^^^^^^^^^^^^^
Once the breakout rooms are created, you will be able to see them in the sidebar.
.. image:: images/talk-breakout-rooms-sidebar.png
:width: 500px
From the sidebar header
- **Start and stop the breakout rooms**: this will move all the users in the parent conversation to their respective breakout rooms.
- **Broadcast a message to all the rooms**: this will send a message to all the rooms at the same time.
- **Make changes to the assigned participants**: this will open the participants editor where you can change which participants are assigned to which breakout room. From this dialog it's also possible to delete the breakout rooms.
.. image:: images/talk-breakout-rooms-sidebar-header.png
:width: 400px
From the breakout room element in the sidebar, you can also join a particular breakout room or send a message to a
specific room.
.. image:: images/talk-breakout-rooms-sidebar-item.png
:width: 400px
Call recording
--------------
The recording feature provides users with an opportunity to:
- Start and stop recordings during a call.
- Record the video and audio stream of the speaker, as well as screen share.
- Access, share and download recorded files for future reference or distribution.
Enabling this feature requires the recording server to be set up by the system administration.
Manage a recording
^^^^^^^^^^^^^^^^^^
The moderator of the conversation can start a recording together with a call start or anytime during a call:
- **Before the call**: tick the checkbox "Start recording immediately with the call" in "Media settings", then click on "Start call".
- **During the call**: click on the top-bar menu, then click "Start recording".
.. image:: images/start-recording-before-call.png
:width: 400px
|
.. image:: images/start-recording-in-call.png
:width: 300px
The recording will start shortly, and you will see a red indicator next to the call time. You can stop the recording at any time while the call is still ongoing by clicking on that indicator and selecting "Stop recording", or by using the same action in the top-bar menu. If you do not manually stop the recording, it will end automatically when the call ends.
.. image:: images/stop-recording.png
:width: 500px
After stopping a recording, the server will take some time to prepare and save the recorded file. The moderator, who started the recording, receives a notification when the file is uploaded. From there, it can be shared in the chat.
.. image:: images/share-recording-notification.png
:width: 300px
|
.. image:: images/shared-recordings.png
:width: 400px
Recording consent
^^^^^^^^^^^^^^^^^
For compliance reasons with various privacy rights, it is possible to ask participants for consent to be recorded before joining the call. The system administration has the flexibility to utilize this feature in several ways:
- Disable consent completely.
- Enable mandatory consent system-wide, requiring consent for all conversations.
- Allow moderators to configure this option on a conversation level. In such cases, moderators can access the conversation settings to configure this option accordingly:
.. image:: images/enable-recording-consent.png
:width: 500px
If recording consent is enabled, every participant, including moderators, will see a highlighted section in the "Media settings" before joining a call.
This section informs participants that the call may be recorded. To give explicit consent for recording, participants must check the box. If they do not give consent, they will not be allowed to join the call.
.. image:: images/give-recording-consent-checked.png
:width: 500px
Federated conversation
----------------------
With Federation feature, users can create conversations across different federated Talk instances and use Talk features as if they were on a same server.
Feature is required to be set up by the system administration.
Send and accept invites
^^^^^^^^^^^^^^^^^^^^^^^
The moderator of the conversation can send an invite to participant on a different server:
.. image:: images/federation-invite-send.png
:width: 400px
When receiving a notification, user will see a counter of pending invites above the conversations list.
.. image:: images/federation-invite-pending.png
:width: 400px
Upon clicking it, more information will be provided about inviting party, and user can either accept or decline the invitation.
.. image:: images/federation-invite-dialog.png
:width: 500px
By accepting the invite, conversation will appear in the list as any other one.
.. image:: images/federation-conversations-list.png
:width: 400px
You can use it further to chat with participants from other federated servers, join calls and use other available Talk features.
Chat summary
------------
When AI assistant is enabled, a summary can be generated if there are more than 100 unread messages.
You can generate it by pressing the button that is visible in chat above the first unread messages.
.. image:: images/chat-summary-button.png
:width: 500px
.. image:: images/chat-summary-text.png
:width: 500px
Call live transcription
-----------------------
Call live transcription allows to transcribe the speech in real-time during a call. It is set up by the system administration (High-performance backend and `Live Transcription App <https://apps.nextcloud.com/apps/live_transcription>`_ are required).
Moderators need to set the language of the transcription in the conversation settings. All participants then can enable or disable the transcription for themselves in the call bottom bar.
When enabled, the transcription will appear in the bottom and will be updated in real-time.
.. image:: images/call-transcription.png
:width: 500px

36
user_manual/talk/attachments.rst
View File

@ -30,4 +30,38 @@ All users will be able to click the files to view, edit or download them, irresp
.. image:: images/editing-document-in-chat-room.png
:width: 600px
.. FIXME Add polls, voice messages?, shared items view
Polls in chat
-------------
You can create a poll in groups chats from the new message additional actions.
.. image:: images/create-new-poll.png
:width: 400px
A poll has two settings:
- **Anonymous polls**: Participants cannot see who voted for which option.
- **Allow multiple choices**: Participants can select more than one option.
You can also import polls for auto-fill and export polls as JSON files to save it locally.
.. image:: images/import-poll.png
:width: 400px
Closing poll is possible from the poll dialog.
.. image:: images/close-poll.png
:width: 400px
As a moderator, you can create the poll directly or you can save it as a draft to edit it later.
.. image:: images/save-poll-draft.png
:width: 400px
You can find poll drafts in ``Shared items`` tab or next to the poll title input field.
.. image:: images/poll-drafts-list.png
:width: 400px
.. FIXME voice messages?, shared items view

33
user_manual/talk/calendar_integration.rst Normal file
View File

@ -0,0 +1,33 @@
Calendar integration with Talk
==============================
Meetings and events
--------------------
If calendar events have a Talk conversation set as event location, you will see an information about upcoming events inside of this conversation.
That way you can stay informed about scheduled meetings or activities directly within your chat.
If Calendar app is enabled, you can click on an event to view details.
.. image:: images/events-upcoming.png
:width: 400px
It is possible to schedule a meeting directly from a conversation. In the dialog, you can set meeting details such as title, date, time and description.
You can also choose to invite all participants including email guests, or select specific ones.
.. image:: images/talk-schedule-meeting.png
:width: 400px
Schedule from Calendar
^^^^^^^^^^^^^^^^^^^^^^
When creating a new event in Calendar, you can set a Talk conversation as event location. This will create a new conversation if one does not exist yet.
.. image:: images/calendar-create-event.png
:width: 600px
When the event is created, you will see a link to the conversation in the event details. Conversation will also show up in the list of conversations (discoverable by ``Events`` filter).
.. image:: images/event-conversation-list.png
:width: 300px
Like instant meetings, event conversations will be automatically deleted after configured period of inactivity (by default 28 days).

41
user_manual/talk/call.rst
View File

@ -8,7 +8,7 @@ Starting a call
When you're in a conversation, you can start a call any time with the ``Start call`` button. Other participants will get notified and can join the call.
.. image:: images/device-settings-before-call.png
:width: 400px
:width: 600px
If somebody else has started a call already, the button will change in a green ``Join call`` button.
@ -29,6 +29,11 @@ From media settings dialog, you can also change the background of your video.
.. image:: images/background-settings-in-call.png
:width: 400px
All these settings are also available as direct actions in the bottom bar.
.. image:: images/call-bottom-bar.png
:width: 300px
You can change other settings in the ``Talk settings`` dialog.
.. image:: images/talk-settings.png
@ -43,10 +48,17 @@ If video from your camera is also available, other participants will see it in a
.. image:: images/share-screen-with-camera.png
:width: 700px
You can zoom in and out of the shared screen with mouse wheel, double click or touchpad gestures.
Changing view in a call
-----------------------
You can switch the view in a call with the little four-block icon in the top-right between promoted-view and grid view. The grid view will show everyone equally big and if the people do not fit on the screen, buttons will appear on the left and right that let you navigate.
You can switch the view in a call in the bottom bar between promoted view and grid view.
.. image:: images/call-view-toggle-button.png
:width: 300px
The grid view will show as many people as the screen can fit, allowing navigation with buttons on the left and right.
.. image:: images/talk-grid-view.png
:width: 700px
@ -56,7 +68,30 @@ The promoted view shows the speaker large and others in a row below. If the peop
.. image:: images/talk-promoted-view.png
:width: 700px
Download call participants list
-------------------------------
You can download the list of participants in a call from the ``...`` menu in the top bar. This will download a CSV file with the names and email addresses of all participants in the call.
.. image:: images/download-participants-list.png
:width: 400px
The table in the CSV file contains the following columns:
- **Name**: The name of the participant.
- **Email**: The email address of the participant.
- **Type**: Indicates whether the participant is a registered user or a guest.
- **Identifier**: Unique identifier for the participant.
Call live transcription
-----------------------
Call live transcription allows to transcribe the speech in real-time during a call. It is set up by the system administration (High-performance backend and `Live Transcription App <https://apps.nextcloud.com/apps/live_transcription>`_ are required).
Moderators need to set the language of the transcription in the conversation settings. All participants then can enable or disable the transcription for themselves in the call bottom bar.
When enabled, the transcription will appear in the bottom and will be updated in real-time.
.. image:: images/call-transcription.png
:width: 500px

5
user_manual/talk/call_recording.rst
View File

@ -57,11 +57,6 @@ For compliance reasons with various privacy rights, it is possible to ask partic
If recording consent is enabled, every participant, including moderators, will see a highlighted section in the "Media settings" before joining a call.
This section informs participants that the call may be recorded. To give explicit consent for recording, participants must check the box. If they do not give consent, they will not be allowed to join the call.
.. image:: images/give-recording-consent.png
:width: 500px
|
.. image:: images/give-recording-consent-checked.png
:width: 500px

24
user_manual/talk/chat.rst
View File

@ -78,7 +78,15 @@ You can add emoji using the picker on the left of the text input field.
.. image:: images/emoji-picker.png
:width: 400px
.. FIXME Smart picker
Smart Picker
------------
Smart picker shortcut makes it easier to insert links, files, or other content into your conversations.
Just choose the type of content you want to insert (files, Talk conversations, Deck cards, GIFs, etc.)
You can also type `/` in the chat input to open the selector.
.. image:: images/smart-picker.png
:width: 400px
.. FIXME Mention integration apps like github, gitlab, giphy, …
@ -90,7 +98,7 @@ You can reply to a message using the arrow that appears when you hover a message
.. image:: images/reply.png
:width: 600px
In the ``...`` menu you can also choose to reply privately. This will open a one-on-one conversation.
In the ``...`` menu you can also choose to reply privately. This will open a one-to-one conversation.
.. image:: images/chat-message-menu.png
:width: 600px
@ -105,3 +113,15 @@ While it is enabled, other participants will not receive notifications from your
.. image:: images/message-silent.png
:width: 600px
Chat summary
------------
When AI assistant is enabled, a summary can be generated if there are more than 100 unread messages.
You can generate it by pressing the button that is visible in chat above the first unread messages.
.. image:: images/chat-summary-button.png
:width: 500px
.. image:: images/chat-summary-text.png
:width: 500px

148
user_manual/talk/conversations.rst
View File

@ -4,15 +4,80 @@ Conversations
Nextcloud Talk lets you chat and have video calls on your own server.
Chats and calls take place in conversations. You can create any number of conversations. There are two kinds of conversations:
Chats and calls take place in conversations. You can create any number of conversations. There are different types of conversations:
1. **One-on-one conversations.** This is where you have a private chat or call with another Talk user. You can't add other people to this conversation or share it with a link. You start a direct one-on-one chat by looking for another user in the search bar and then clicking their name.
2. **Group conversations.** Besides the person who created the conversation, a group conversation can have any number of people in it. A group conversation can be shared publicly with a link, so external guest users can join a call. It can also be listed, so other people on your Nextcloud server can join the conversation.
1. Private (one-to-one) conversations
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This is where you have a private chat or call with another Talk user.
In content sidebar, you can find additional information about the person you are chatting with, such as their email address, phone number, or other details they have shared in their profile.
.. image:: images/one-to-one-right-sidebar.png
:width: 300px
Nobody except you and the other person can see this conversation or join a call in it.
You can extend an ongoing call to a new group conversation by adding more people. Call will be continued there without interruption.
.. image:: images/one-to-one-extend.png
:width: 300px
If a user becomes unavailable and set an **out-of-office** status in ``Personal settings > Availability``, you will find additional information in this conversation, such as provided description, absence date, or their replacement person.
.. image:: images/one-to-one-out-of-office.png
:width: 500px
2. Group conversations
^^^^^^^^^^^^^^^^^^^^^^
A group conversation can have any number of people in it.
You can add internal users, email guests, groups or teams to a group conversation upon creation, or when it already exists, via the ``Participants`` tab.
A group conversation can be shared with a public link, so guests can join a chat and a call.
It can also be opened to registered users (or users from 'Guests' app), so they can discover and join this conversation.
.. image:: images/group-public-settings.png
:width: 400px
3. Note to self
^^^^^^^^^^^^^^^
This is a special conversation with yourself. Messages here do not have a limit for editing or deletion. You can use it to:
- **Take notes**: write down ideas, reminders, or important information you want to keep handy.
- **Create to-do lists**: use Markdown syntax to create checklists for tasks you need to complete.
- **Forward messages from other chat**: use the message menu to forward important messages from other conversations to your Note to self.
.. image:: images/note-to-self.png
:width: 500px
4. Disposable conversations
^^^^^^^^^^^^^^^^^^^^^^^^^^^
These conversations cover some special cases and exist for a limited period of time. Retention period can be configured by an instance administration:
- **Instant meetings**: these conversations can be created for quick, ad-hoc meetings. They can be started instantly from the Talk Dashboard.
- **Event conversations**: these are created when set as an event location by Calendar app.
- **Phone conversations**: these are dedicated for SIP dial-in & dial-out phone calls (requires a SIP gateway).
- **Video verification**: these are created, when someone tries to access a public link, protected by password with video verification (deleted instantly after call ends).
.. image:: images/instant-meeting-dispose.png
:width: 500px
Talk Dashboard
--------------
The Talk Dashboard is your central hub for managing and accessing your conversations. It provides an overview of your:
- Unread mentions and messages in private chats;
- Message reminders, scheduled to be tackled on later;
- Scheduled meetings, with event details and shortcut buttons to join them;
- Shortcut actions to create new conversations, join open ones, or quickly check your media devices.
.. image:: images/talk-dashboard.png
:width: 600px
Creating a conversation
-----------------------
You can create a direct, one-on-one chat by searching for the name of a user, a group or a team and clicking it. For a single user, a conversation is immediately created and you can start your chat. For a group or circle you get to pick a name and settings before you create the conversation and add the participants.
You can create a private (one-to-one) chat by searching for the name of a user, a group or a team and clicking it. For a single user, a conversation is immediately created and you can start your chat. For a group or circle you get to pick a name and settings before you create the conversation and add the participants.
.. image:: images/chat-with-one-user.png
:width: 400px
@ -40,9 +105,10 @@ After confirmation you will be redirected to the new conversation and can start
Filter your conversations
-------------------------
You can filter your conversations using the filter button located next to the search field. There are two options for filtering:
1. Filter unread mentions: This option allows you to view group conversations with unread mentions or unread one-on-one conversations.
2. Filter unread messages: This option allows you to view all unread messages in all joined conversations.
You can filter your conversations using the filter button next to the search field. There are several options for filtering:
1. **Unread mentions**: view unread private conversations, or group conversations, where you have been mentioned.
2. **Unread messages**: view unread messages in all conversations you are a part of.
2. **Event conversations**: view all conversations, created for upcoming or past events.
.. image:: images/filters-menu.png
:width: 400px
@ -52,6 +118,28 @@ You can then clear the filter from the filters menu.
.. image:: images/clear-filter.png
:width: 400px
Compact view of conversations list
----------------------------------
Compact view allows to hide last message preview in the conversation list, providing a more focused interface.
You can enable it from the ``Talk settings`` dialog in ``Appearance`` section.
.. image:: images/talk-compact-view.png
:width: 200px
Archive conversations
---------------------
You can archive conversations that you no longer need to see in your main conversation list. When a conversation is archived, it will be moved to the ``Archived conversations`` section.
An archived conversation will not appear in your main conversation list, but it will still align with notification level set in its settings.
.. image:: images/archived-conversations-list.png
:width: 400px
The list is accessible from the button at the bottom of the navigation bar.
.. image:: images/archived-conversations-button.png
:width: 400px
Managing a conversation
-----------------------
@ -72,6 +160,28 @@ Here you can configure the description, guest access, if the conversation is vis
.. image:: images/conversation-settings-dialog.png
:width: 600px
Ban participants
----------------
To help keep discussions safe and under control, moderators can ban participants from conversations.
It could be internal users or guests (in this case their IP-addresse will additionally be banned).
In the participants list, select the user or guest you, and click ``Remove participant``.
.. image:: images/ban-participant.png
:width: 300px
There, toggle checkbox ``Also ban from this conversation`` and provide a reason for the ban. The banned user will be removed and prevented from rejoining.
.. image:: images/ban-participant-dialog.png
:width: 400px
You can later find the list of banned users in the ``Moderation`` section of conversation settings.
Here, you can see the reason for the ban and revert it if needed.
.. image:: images/ban-participant-list.png
:width: 400px
Messages expiration
-------------------
@ -80,3 +190,27 @@ The available expiration durations are 1 hour, 8 hours, 1 day, 1 week, 4 weeks,
.. image:: images/messages-expiration.png
:width: 500px
Notifications and privacy
-------------------------
By default, Nextcloud Talk will notify you about:
- New messages in private conversations;
- Replies to messages you sent;
- Messages mentioning you or group/team you are member of;
- Started calls in conversations you are part of.
You can change this behavior in the conversation settings. Additionally, you can configure:
- **Important conversations**: you will be always notificed about new messages, even if you are in "Do Not Disturb" mode;
- **Sensitive conversations**: content of messages will not be shown in the conversation list and obscured from notifications.
.. image:: images/conversation-notifications.png
:width: 300px
To have more control over your privacy, you can also configure the visibility of your typing and read indicators in ``Talk settings``:
.. image:: images/privacy-settings.png
:width: 400px

6
user_manual/talk/federation.rst
View File

@ -2,10 +2,6 @@ Federation
==========
With Federation feature, users can create conversations across different federated Talk instances and use Talk features as if they were on a same server.
.. FIXME clarify the statement
**Important** Under current development. Basic chat features are available, more to come in the future!
Feature is required to be set up by the system administration.
Sending an invitation
@ -35,3 +31,5 @@ By accepting the invite, conversation will appear in the list as any other one.
.. image:: images/federation-conversations-list.png
:width: 400px
You can use it further to chat with participants from other federated servers, join calls and use other available Talk features.

2
user_manual/talk/guest.rst
View File

@ -37,7 +37,7 @@ You can start a call any time with the ``Start call`` button. Other participants
Before actually joining the call you will see a device check, where you can pick the right camera and microphone, enable background blur or even join with any devices.
.. image:: images/device-settings-before-call.png
:width: 400px
:width: 600px
During a call, you can find the Camera and Microphone settings in the ``...`` menu in the top bar.

46
user_manual/talk/messages.rst
View File

@ -44,3 +44,49 @@ The available expiration durations are 1 hour, 8 hours, 1 day, 1 week, 4 weeks,
:width: 500px
.. FIXME Mention integration with Note-to-self and Forwarding
Messages search in a conversation
---------------------------------
In addition to global unified search, you can search for messages within a specific conversation. In the content sidebar of a conversation, click the search icon to open the search tab.
.. image:: images/chat-search-messages.png
:width: 500px
You can narrow down your search by using filters such as date range, and sender.
.. image:: images/chat-search-messages-tab.png
:width: 500px
Threaded messages
-----------------
You can create threads in conversations to keep discussions organized. The thread creation option is available in the new message additional actions.
.. image:: images/thread-create-action.png
:width: 500px
Then, you can add a title and description for the thread and start the discussion.
.. image:: images/thread-example.png
:width: 500px
You can view all replies in a thread either from the replies button on the message or from ``Shared items`` tab in the content sidebar.
.. image:: images/threads-list-shared-items.png
:width: 500px
You can subscribe to a thread to receive notifications about new replies. It is possible to subscribe from the thread itself or from the sidebar.
.. image:: images/thread-notifications.png
:width: 500px
Subscribed threads are easily accessible from the navigation bar in ``Threads`` navigation.
.. image:: images/threads-followed.png
:width: 500px
Editing thread title is possible from the thread itself or from the sidebars.
.. image:: images/thread-edit-title.png
:width: 500px

526
user_manual/talk/talk_basics.rst
View File

@ -1,526 +0,0 @@
========================
Basics of Nextcloud Talk
========================
Nextcloud Talk lets you chat and have video calls on your own server.
Getting started
---------------
Chats and calls take place in conversations. You can create any number of conversations. There are different types of conversations:
1. Private (one-to-one) conversations
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This is where you have a private chat or call with another Talk user.
In content sidebar, you can find additional information about the person you are chatting with, such as their email address, phone number, or other details they have shared in their profile.
.. image:: images/one-to-one-right-sidebar.png
:width: 300px
Nobody except you and the other person can see this conversation or join a call in it.
You can extend an ongoing call to a new group conversation by adding more people. Call will be continued there without interruption.
.. image:: images/one-to-one-extend.png
:width: 300px
If a user becomes unavailable and set an **out-of-office** status in ``Personal settings > Availability``, you will find additional information in this conversation, such as provided description, absence date, or their replacement person.
.. image:: images/one-to-one-out-of-office.png
:width: 500px
2. Group conversations
^^^^^^^^^^^^^^^^^^^^^^
A group conversation can have any number of people in it.
You can add internal users, email guests, groups or teams to a group conversation upon creation, or when it already exists, via the ``Participants`` tab.
A group conversation can be shared with a public link, so guests can join a chat and a call.
It can also be opened to registered users (or users from 'Guests' app), so they can discover and join this conversation.
.. image:: images/group-public-settings.png
:width: 400px
3. Note to self
^^^^^^^^^^^^^^^
This is a special conversation with yourself. Messages here do not have a limit for editing or deletion. You can use it to:
- **Take notes**: write down ideas, reminders, or important information you want to keep handy.
- **Create to-do lists**: use Markdown syntax to create checklists for tasks you need to complete.
- **Forward messages from other chat**: use the message menu to forward important messages from other conversations to your Note to self.
.. image:: images/note-to-self.png
:width: 500px
4. Disposable conversations
^^^^^^^^^^^^^^^^^^^^^^^^^^^
These conversations cover some special cases and exist for a limited period of time. Retention period can be configured by an instance administration:
- **Instant meetings**: these conversations can be created for quick, ad-hoc meetings. They can be started instantly from the Talk Dashboard.
- **Event conversations**: these are created when set as an event location by Calendar app.
- **Phone conversations**: these are dedicated for SIP dial-in & dial-out phone calls (requires a SIP gateway).
- **Video verification**: these are created, when someone tries to access a public link, protected by password with video verification (deleted instantly after call ends).
.. image:: images/instant-meeting-dispose.png
:width: 500px
Talk Dashboard
--------------
The Talk Dashboard is your central hub for managing and accessing your conversations. It provides an overview of your:
- Unread mentions and messages in private chats;
- Message reminders, scheduled to be tackled on later;
- Scheduled meetings, with event details and shortcut buttons to join them;
- Shortcut actions to create new conversations, join open ones, or quickly check your media devices.
.. image:: images/talk-dashboard.png
:width: 600px
Creating a chat
---------------
You can create a private (one-to-one) chat by searching for the name of a user, a group or a team and clicking it. For a single user, a conversation is immediately created and you can start your chat. For a group or circle you get to pick a name and settings before you create the conversation and add the participants.
.. image:: images/chat-with-one-user.png
:width: 400px
If you want to create a custom group conversation, click the button next to the search field and filters button and then on ``Create a new conversation``.
.. image:: images/create-new-conversation.png
:width: 400px
You can then pick a name for the conversation, put a description, and set up an avatar for it (with uploaded photo or emoji), and select if the conversation should be open to external users and if other users on the server can see and join the conversation.
.. image:: images/creating-open-conversation.png
:width: 500px
In the second step, you get to add participants and finalize the creation of the conversation.
.. image:: images/add-participants.png
:width: 500px
After confirmation you will be redirected to the new conversation and can start communicating right away.
.. image:: images/new-room.png
:width: 700px
View all open conversations
---------------------------
You can view all the conversations that you can join by clicking the button next to the search field and filters button and then on ``Join open conversations.``
.. image:: images/join-open-conversations.png
:width: 400px
Filter your conversations
-------------------------
You can filter your conversations using the filter button next to the search field. There are several options for filtering:
1. **Unread mentions**: view unread private conversations, or group conversations, where you have been mentioned.
2. **Unread messages**: view unread messages in all conversations you are a part of.
2. **Event conversations**: view all conversations, created for upcoming or past events.
.. image:: images/filters-menu.png
:width: 400px
You can then clear the filter from the filters menu.
.. image:: images/clear-filter.png
:width: 400px
Archive conversations
---------------------
You can archive conversations that you no longer need to see in your main conversation list. When a conversation is archived, it will be moved to the ``Archived conversations`` section.
An archived conversation will not appear in your main conversation list, but it will still align with notification level set in its settings.
.. image:: images/archived-conversations-list.png
:width: 400px
The list is accessible from the button at the bottom of the navigation bar.
.. image:: images/archived-conversations-button.png
:width: 400px
Sharing files in a chat
-----------------------
You can share files in a chat in 3 ways.
First, you can simply drag'n'drop them on the chat.
.. image:: images/drag-and-drop.png
:width: 600px
Second, you can select a file from your Nextcloud Files or a file manager by choosing the little paperclip and selecting where you'd like to pick the file from.
.. image:: images/share-files-in-chat.png
:width: 500px
.. image:: images/share-files-in-chat-selection.png
:width: 600px
You can add more files until you are done and decide to share the files. You can also add a text caption to your shared files, providing a brief description or context.
.. image:: images/talk-upload-files.png
:width: 500px
All users will be able to click the files to view, edit or download them, irrespective of them having a user account. Users with an account will have the file automatically shared with them while external guest users will get them shared as a public link.
.. image:: images/editing-document-in-chat-room.png
:width: 600px
Inserting emoji
---------------
You can add emoji using the picker on the left of the text input field.
.. image:: images/emoji-picker.png
:width: 400px
Smart Picker
------------
Smart picker shortcut makes it easier to insert links, files, or other content into your conversations.
Just choose the type of content you want to insert (files, Talk conversations, Deck cards, GIFs, etc.)
You can also type `/` in the chat input to open the selector.
.. image:: images/smart-picker.png
:width: 400px
Editing messages
----------------
You can edit messages and captions to file shares up to 6 hours after sending.
.. image:: images/message-editing.png
:width: 600px
Using Markdown
---------------
You can enhance your messages with a markdown syntax support. See list for usage:
**Headings and dividers**
.. code-block:: none
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Heading
===
Normal text
***
Normal text
**Inline decorations**
.. code-block:: none
**bold text** __bold text__
*italicized text* _italicized text_
`inline code` ``inline code``
```
.code-block {
display: pre;
}
```
**Lists**
.. code-block:: none
1. Ordered list
2. Ordered list
* Unordered list
- Unordered list
+ Unordered list
**Quotes**
.. code-block:: none
> blockquote
second line of blockquote
**Task lists**
.. code-block:: none
- [ ] task to be done
- [x] completed task
**Tables**
.. code-block:: none
Column A | Column B
-- | --
Data A | Data B
Polls in chat
-------------
You can create a poll in groups chats from the new message additional actions.
.. image:: images/create-new-poll.png
:width: 400px
A poll has two settings:
- **Anonymous polls**: Participants cannot see who voted for which option.
- **Allow multiple choices**: Participants can select more than one option.
You can also import polls for auto-fill and export polls as JSON files to save it locally.
.. image:: images/import-poll.png
:width: 400px
Closing poll is possible from the poll dialog.
.. image:: images/close-poll.png
:width: 400px
As a moderator, you can create the poll directly or you can save it as a draft to edit it later.
.. image:: images/save-poll-draft.png
:width: 400px
You can find poll drafts in ``Shared items`` tab or next to the poll title input field.
.. image:: images/poll-drafts-list.png
:width: 400px
Setting reminder on messages
----------------------------
You can set reminders on specific messages. If there's an important message you want to be notified about later, simply hover over it and click on the reminder icon.
.. image:: images/set-message-reminder.png
:width: 400px
In the submenu, you can select an appropriate time to receive a notification later.
.. image:: images/configure-message-reminder.png
:width: 400px
Replying to messages and more
-----------------------------
You can reply to a message using the arrow that appears when you hover a message.
.. image:: images/reply.png
:width: 600px
In the ``...`` menu you can also choose to reply privately. This will open a one-to-one chat.
.. image:: images/chat-message-menu.png
:width: 600px
Here you can also create a direct link to the message or mark it unread so you will scroll back there next time you enter the chat. When it is a file, you can view the file in Files.
Silent messages
---------------
If you don't want to disturb anyone in the middle of the night, there is a silent mode for chatting.
While it is enabled, other participants will not receive notifications from your messages.
.. image:: images/message-silent.png
:width: 600px
Managing a conversation
-----------------------
You are always moderator in your new conversation. In the participant list you can promote other participants to moderators using the ``...`` menu to the right of their user name, assign them custom permissions or remove them from the conversation.
Changing permissions of a user that joined a public conversation will also permanently add them to the conversation.
.. image:: images/participant-menu.png
:width: 400px
Moderators can configure the conversation. Select ``Conversation settings`` from the ``...`` menu of the conversation on the top to access the settings.
.. image:: images/open-settings.png
:width: 400px
Here you can configure the description, guest access, if the conversation is visible to others on the server and more.
.. image:: images/conversation-settings-dialog.png
:width: 600px
Ban participants
----------------
To help keep discussions safe and under control, moderators can ban participants from conversations.
It could be internal users or guests (in this case their IP-addresse will additionally be banned).
In the participants list, select the user or guest you, and click ``Remove participant``.
.. image:: images/ban-participant.png
:width: 300px
There, toggle checkbox ``Also ban from this conversation`` and provide a reason for the ban. The banned user will be removed and prevented from rejoining.
.. image:: images/ban-participant-dialog.png
:width: 400px
You can later find the list of banned users in the ``Moderation`` section of conversation settings.
Here, you can see the reason for the ban and revert it if needed.
.. image:: images/ban-participant-list.png
:width: 400px
Messages expiration
-------------------
A moderator can configure message expiration under the ``Conversation settings`` within the ``Moderation`` section. Once a message reaches its expiration time, it is automatically removed from the conversation.
The available expiration durations are 1 hour, 8 hours, 1 day, 1 week, 4 weeks, or never (which is the default setting).
.. image:: images/messages-expiration.png
:width: 500px
Starting a call
---------------
When you're in a conversation, you can start a call any time with the ``Start call`` button. Other participants will get notified and can join the call.
.. image:: images/device-settings-before-call.png
:width: 600px
If somebody else has started a call already, the button will change in a green ``Join call`` button.
.. image:: images/join-call.png
:width: 600px
During a call, you can mute your microphone and disable your video with the buttons on the right side of the top bar, or using the shortcuts ``M`` to mute audio and ``V`` to disable video. You can also use the space bar to toggle mute. When you are muted, pressing space will unmute you so you can speak until you let go of the space bar. If you are unmuted, pressing space will mute you until you let go.
You can hide your video (useful during a screen share) with the little arrow just above the video stream. Bring it back with the little arrow again.
You can access your settings and choose a different webcam, microphone and other settings in the ``...`` menu in the top bar.
.. image:: images/media-settings.png
:width: 300px
From media settings dialog, you can also change the background of your video.
.. image:: images/background-settings-in-call.png
:width: 400px
All these settings are also available as direct actions in the bottom bar.
.. image:: images/call-bottom-bar.png
:width: 300px
You can change other settings in the ``Talk settings`` dialog.
.. image:: images/talk-settings.png
:width: 600px
Starting a screen share
-----------------------
You can click the monitor icon on your video stream to share your screen. Depending on your browser, you will get the option to share a monitor, an application window or a single browser tab.
If video from your camera is also available, other participants will see it in a small presenter view next to the screen share.
.. image:: images/share-screen-with-camera.png
:width: 700px
You can zoom in and out of the shared screen with mouse wheel, double click or touchpad gestures.
Changing view in a call
-----------------------
You can switch the view in a call in the bottom bar between promoted view and grid view.
.. image:: images/call-view-toggle-button.png
:width: 300px
The grid view will show as many people as the screen can fit, allowing navigation with buttons on the left and right.
.. image:: images/talk-grid-view.png
:width: 700px
The promoted view shows the speaker large and others in a row below. If the people do not fit on the screen, buttons will appear on the left and right that let you navigate.
.. image:: images/talk-promoted-view.png
:width: 700px
Download call participants list
-------------------------------
You can download the list of participants in a call from the ``...`` menu in the top bar. This will download a CSV file with the names and email addresses of all participants in the call.
.. image:: images/download-participants-list.png
:width: 400px
The table in the CSV file contains the following columns:
- **Name**: The name of the participant.
- **Email**: The email address of the participant.
- **Type**: Indicates whether the participant is a registered user or a guest.
- **Identifier**: Unique identifier for the participant.
Compact view of conversations list
----------------------------------
Compact view allows to hide last message preview in the conversation list, providing a more focused interface.
You can enable it from the ``Talk settings`` dialog in ``Appearance`` section.
.. image:: images/talk-compact-view.png
:width: 200px
Messages search in a conversation
---------------------------------
In addition to global unified search, you can search for messages within a specific conversation. In the content sidebar of a conversation, click the search icon to open the search tab.
.. image:: images/chat-search-messages.png
:width: 500px
You can narrow down your search by using filters such as date range, and sender.
.. image:: images/chat-search-messages-tab.png
:width: 500px
Threaded messages
-----------------
You can create threads in conversations to keep discussions organized. The thread creation option is available in the new message additional actions.
.. image:: images/thread-create-action.png
:width: 500px
Then, you can add a title and description for the thread and start the discussion.
.. image:: images/thread-example.png
:width: 500px
You can view all replies in a thread either from the replies button on the message or from ``Shared items`` tab in the content sidebar.
.. image:: images/threads-list-shared-items.png
:width: 500px
You can subscribe to a thread to receive notifications about new replies. It is possible to subscribe from the thread itself or from the sidebar.
.. image:: images/thread-notifications.png
:width: 500px
Subscribed threads are easily accessible from the navigation bar in ``Threads`` navigation.
.. image:: images/threads-followed.png
:width: 500px
Editing thread title is possible from the thread itself or from the sidebars.
.. image:: images/thread-edit-title.png
:width: 500px