documentation/content/applications/websites/livechat/participate.rst
jero-odoo 07ac9eda1f [ADD] Live chat: participate
closes 

X-original-commit: 9ed575b01e
Signed-off-by: Samuel Lieber (sali) <sali@odoo.com>
Signed-off-by: Jessica Rogers (jero) <jero@odoo.com>
Co-authored-by: hojo-odoo <123424465+hojo-odoo@users.noreply.github.com>
Co-authored-by: ksc-odoo <73958186+ksc-odoo@users.noreply.github.com>
2024-06-28 19:23:50 +00:00

99 lines
4.3 KiB
ReStructuredText

========================
Participate in live chat
========================
*Operators* are the users who respond to live chat requests from customers and website visitors. The
information below outlines the necessary steps for operators participating in live chat
conversations on an Odoo database.
Set an online chat name
-----------------------
Before participating in a live chat, operators may choose to update their *Online Chat Name*. This
is the name displayed to site visitors in the live chat conversation.
To update the *Online Chat Name*, click on the user avatar in the top-right corner of any page in
the database. Select :guilabel:`My Profile` from the drop-down menu to open the profile page. On the
right side of the :guilabel:`Preferences` tab, locate the :guilabel:`Online Chat Name` field, and
enter a preferred name.
If a user's :guilabel:`Online Chat Name` is not set, the name displayed defaults to the user's name
that is designated on their profile page.
.. example::
A user has their full name as their :guilabel:`User Name`, but they do not want to include their
last name in a live chat conversation. They would then set their :guilabel:`Online Chat Name` to
include only their first name.
.. image:: participate/online-chat-name.png
:align: center
:alt: View of user profile in Odoo, emphasizing the Online Chat name field.
Set online chat languages
-------------------------
If an operator speaks multiple languages, they can add this information to their user profile. This
information can then be used to determine which conversations the operator is assigned. A visitor's
language is determined via their browser's language settings.
.. note::
Conversations are assigned to operators based on a number of criteria, including availability and
the number of ongoing conversations. While the operator's main language and additional languages
are taken into consideration, they do **not** supersede all other criteria.
To add *Online Chat Languages*, click on the user avatar in the top-right corner of any page in the
database. Select :guilabel:`My Profile` from the drop-down menu to open the profile page. On the
right side of the :guilabel:`Preferences` tab, click into the :guilabel:`Online Chat Language`
field, and select one or more languages from the drop-down menu.
.. important::
Only :doc:`languages <../../general/users/language>` that are enabled on the database can be
selected in the :guilabel:`Online Chat Language` field.
Join or leave a channel
-----------------------
To join a live chat channel, go to the :menuselection:`Live Chat app --> Channels`, and click the
:guilabel:`Join` button on the Kanban card for the appropriate channel.
Any channel where the user is currently active shows a :guilabel:`Leave` button. Click this button
to disconnect from the channel.
.. image:: participate/leave-channel.png
:align: center
:alt: View of a channel form and the option to join a channel for Odoo Live Chat.
.. important::
Operators that do not show any activity in Odoo for more than thirty minutes are considered
disconnected, and subsequently removed from the channel.
Manage live chat requests
-------------------------
When an operator is active in a channel, chat windows open in the bottom-right corner of the
screen, no matter where they are in the database. This allows them to access other pages and apps,
while still participating in the conversation.
.. tip::
Conversations can also be accessed by clicking the :icon:`fa-comments` :guilabel:`(messages)`
icon in the menu bar.
.. image:: participate/menu-bar.png
:align: center
:alt: View of the menu bar in Odoo emphasizing the comments icon.
Live chat conversations can also be viewed by navigating to the :menuselection:`Discuss app`. New
conversations appear in bold under the :guilabel:`LIVECHAT` heading, located along the left panel.
.. image:: participate/managing-chat-responses.png
:align: center
:alt: View of the discuss application with a message sent through live chat in Odoo.
Click on a conversation in the left panel to select it. This opens the conversation. From this
view, an operator can participate in the chat the same as they would in the normal chat window.
.. seealso::
- :doc:`../../productivity/discuss`
- :doc:`../livechat`
- :doc:`../livechat/responses`