[IMP] live chat: update ratings doc

Author: jero-odoo

content/applications/websites/livechat/overview/ratings.rst

@@ -2,44 +2,127 @@
 Ratings
 =======
 
-Giving users the opportunity to rate their interactions can help you improving the experience you
-offer. That means staying on top of your customers' needs, besides keeping track of your operators’
-performances.
+At the end of a *Live Chat* conversation, customers have the opportunity to rate the quality of
+service they have received from the live chat *operators*. This rating, which is delivered directly
+through the chat window, allows operators to receive immediate feedback on their performance. It
+also allows customers the chance to share any final comments before closing the conversation.
 
-Customer Rating
-===============
+Rate live chat conversations
+============================
 
-| Once the user chooses to close the chat window, he can rate his interaction.
-| If the user is *Not satisfied* or *Highly dissatisfied*, a field allowing for an explanation
-  is shown.
-| A copy of the conversation can also be sent by email.
+Customers end a *live chat* conversation by clicking the :guilabel:`X` in the upper right hand
+corner of the chat window. At that point, the chat window will be replaced with a text bubble,
+that reads- *Did we correctly answer your question?*. This question is followed by three colored
+icons, which represent the following ratings:
 
-.. image:: ratings/user_chatwindow.png
+ - *Green smiling face* - Satisfied
+ - *Yellow neutral face* - Okay
+ - *Red frowning face* - Dissatisfied
+
+.. image:: ratings/live-chat-ratings-faces.png
    :align: center
-   :height: 400
-   :alt: View of the chat window from a user’s side for Odoo Live Chat
+   :alt: View of the chat window from a user's side for Odoo Live Chat.
+
+.. note::
+  When customers end a conversation, a field with the note :guilabel:`Receive a copy of this
+  conversation` appears under the *ratings* icons. Customers can enter their email either before or
+  after they submit a rating.
 
-The rating is shown on the chat window itself for the operator.
+If the customer selects :guilabel:`Satisfied` (*Green smiling face*), they are presented with a
+thank you message, and a link to :guilabel:`Close the Conversation`.
 
-.. image:: ratings/operator_chatwindow.png
+If the customer selects either :guilabel:`Okay` (*Yellow neutral face*) or :guilabel:`Dissatisfied`
+(*Red frowning face*), a text box will appear. Customers can add any comments in this text box to
+explain why they chose this rating.
+
+.. image:: ratings/live-chat-ratings-explain.png
    :align: center
-   :alt: View of a chat window from an operator’s side highlighting a rating for Odoo Live Chat
+   :alt: View of customer's live chat window with the option to add a ratings note.
+
+This message will be sent to the live chat operator, along with the rating icon.
+
+.. image:: ratings/live-chat-ratings-operator-window.png
+   :align: center
+   :alt: View of a chat window from an operator's window highlighting a rating for Odoo Live Chat.
+
+It can also be viewed in the :guilabel:`Customer Ratings` report which can be found under
+:menuselection:`Live Chat --> Report --> Customer Ratings`.
+
+.. image:: ratings/live-chat-ratings-report.png
+   :align: center
+   :alt: View of the customer ratings report in Odoo Live Chat.
+
+Publish customer ratings
+========================
+
+After a customer rating has been submitted, it can then be published to the website. Ratings are
+broken down by channel, and individual operator (if applicable).
+
+.. note::
+   The customer notes that accompany the rating are *not* published to the website, they are kept
+   internal. Only a statistical overview of the performance of operators for the *channel*.
+
+To publish a channel's ratings on the website, first navigate to a live chat channel's record by
+going to the :menuselection:`Live Chat` app and clicking on the kanban card for that team. Then
+click on the :guilabel:`Go to Website` smart button. This will open the :guilabel:`Live Chat
+Channel Statistics` page.
 
-And under :menuselection:`Report --> Customer Ratings`.
+In the upper right corner of the page, click the red :guilabel:`Unpublished` slider so that it
+reads :guilabel:`Published`.
 
-.. image:: ratings/customer_ratings.png
+.. image:: ratings/live-chat-ratings-unpublished.png
    :align: center
-   :alt: View of the customer ratings page in Odoo Live Chat
+   :alt: View of the published ratings on the portal for Odoo Live Chat.
+
+Add ratings page to site
+------------------------
+
+Once the ratings page has been published, it has to be added to the website. To do this, go to
+:menuselection:`Dashboard --> Website --> Site --> Pages --> New`.
+
+This will open a :guilabel:`New Page` window. In the :guilabel:`Page Title` field, enter
+`livechat`. Click :guilabel:`Create`.
+
+.. important::
+   The page *must* be named `livechat` in order for the database to recognize and connect the
+   ratings page. The page title can be changed later under the :guilabel:`Menu Editor` .
+
+The newly created webpage will open, with the :guilabel:`Webpage Editor` open in the right panel.
+The page will list out the names of the :guilabel:`Live Chat Channels` whose ratings pages have
+been published. Next to the channel name is a speech bubble icon, which when click will take the
+visitor to the ratings page.
+
+.. image:: ratings/live-chat-published-icon.png
+   :align: center
+   :alt: View of the webpage for Live Chat ratings emphasizing the channel icon.
+
+Make any desired changes or additions to this page, then click save on the :guilabel:`Webpage
+Editor`.
+
+To publish the `livechat` webpage, return to the list of webpages by navigating to
+:menuselection:`Site --> Pages`. Click the checkbox to the left of `livechat` in the list of pages
+to select the page. Then, click the checkbox under the column labeled :guilabel:`Is Published`.
+Then click :guilabel:`Save`.
+
+.. image:: ratings/live-chat-is-published.png
+   :align: center
+   :alt: View of the list of pages for a website with the 'is published' box emphasized.
+
+Hide individual ratings
+-----------------------
 
-Make the rating public
-======================
+Ratings are set to be published by default. However, individual ratings can be manually selected to
+be hidden from the public. The rating will still be included in internal reports, and can still be
+viewed by internal teams. However, public website visitors and portal users will not have access.
 
-Go to :menuselection:`Website --> Configuration --> Settings`, access your channel form, click on
-*Go to Website* and on *Unpublished*, to publish the rating of that channel on your website.
+To hide a rating, first go to :menuselection:`Live Chat --> Reports --> Customer Ratings`. Click on
+the kanban card for a rating to be hidden. On the rating's detail page, check the box labeled
+:guilabel:`Visible Internally Only`.
 
-.. image:: ratings/publish_ratings.png
+.. image:: ratings/live-chat-ratings-visible-internally.png
    :align: center
-   :alt: View of the public ratings in the website for Odoo Live Chat
+   :alt: View of an individual rating's detail page with the visible internally setting checked.
 
 .. seealso::
+   - :doc:`get_started`
    - :doc:`responses`