documentation/content/applications/websites/livechat/overview/responses.rst
Antoine Vandevenne (anv) 1d5e549b36 [MOV] content/*: move resource files into their related page's directory
Since odoo/documentation#903, the guideline for the location of new
resource (images, downloadable files, RST includes...) files is to place
those inside the directory of the RST page that references them.

For example, if `doc1.rst` has a reference to `image.png` and to
`download.zip`, the file structure should look like this:

├── parent_doc/
│     └── doc1/
│     │     └── image.png
│     │     └── download.zip
│     └── doc1.rst
│     └── doc2.rst
├── parent_doc.rst

Before this commit, most of the resource files were still located inside
'media' directories holding all the resource files referenced by RST
pages located at the same level as these directories. In the example
above, a single 'media' directory would hold all the resource files
referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from
figuring out easily which resource file was referenced by which RST page
and, thus, lead to unused resource files piling up in the repository. It
also made it more complicated to define codeowners regex rules because a
team could not simply be assigned to `/some_page.*` but needed to be
assigned to both `/some_page\.rst` and to the location of 'media'.

In order to help new content writers figure out the guideline when
taking examples from other RST pages, this commit retroactively applies
the guideline to existing resource files and 'media' directories. The
left-over resource files that are not referenced by any RST page are
removed.

task-2497965

Part-of: odoo/documentation#2065
2022-05-20 16:08:16 +02:00

49 lines
1.7 KiB
ReStructuredText

=============================
Commands and Canned Responses
=============================
Using canned responses can help you save time and have a previous, well-thought response, to some
of your most common questions and comments.
Use commands
============
Commands are shortcuts that do specific actions within the chat window:
#. **/help**: shows a help message.
#. **/helpdesk**: creates a helpdesk ticket.
#. **/helpdesk_search**: searches for a helpdesk ticket.
#. **/history**: shows the last 15 visited pages.
#. **/lead**: creates a new lead.
#. **/leave**: leaves the channel.
.. important::
| - For *helpdesk tickets*: make sure the application is installed on your database and the
option *Live Chat* under :menuselection:`Helpdesk --> Configuration --> Helpdesk Teams`
is enabled.
| - For *leads*: the *CRM* application must be installed on your database.
To access the ticket or lead created from the chat, click on the shortcut link.
.. image:: responses/create_ticket.png
:align: center
:alt: View of the chat window with a helpdesk ticket created in Odoo Live Chat
.. tip::
Helpdesk tickets created from the chat automatically add the conversation as a description of
the ticket. The same goes for the creation of a lead.
Send canned responses
=====================
| Canned responses allow you to have a full piece of text being placed when you type a shortcut word.
To create them, go to :menuselection:`Live Chat --> Configuration --> Canned Responses`.
| To use them during a conversation, simply type **:** followed by the shortcut word you created.
.. image:: responses/canned_response.png
:align: center
:alt: View of a chat window and the use of a canned response in Odoo Live Chat
.. seealso::
- :doc:`ratings`