diff --git a/content/applications/services/helpdesk.rst b/content/applications/services/helpdesk.rst index 6f65cce11..2ab71a01c 100644 --- a/content/applications/services/helpdesk.rst +++ b/content/applications/services/helpdesk.rst @@ -5,7 +5,7 @@ Helpdesk ======== -Odoo *Helpdesk* is a ticketing-based customer support application. Multiple teams can be configured +Odoo **Helpdesk** is a ticket-based customer support application. Multiple teams can be configured and managed in one dashboard, each with their own pipeline for tickets submitted by customers. Pipelines are organized in customizable stages that enable teams to track, prioritize, and solve customer issues quickly and efficiently. @@ -13,12 +13,11 @@ customer issues quickly and efficiently. Create a Helpdesk team ====================== -To view or modify *Helpdesk* teams, go to :menuselection:`Helpdesk app --> Configuration --> -Helpdesk Teams`. To create a new team, click the :guilabel:`New` button in the top-left of the +To view or modify **Helpdesk** teams, go to :menuselection:`Helpdesk app --> Configuration --> +Helpdesk Teams`. To create a new team, click the :guilabel:`New` button on the top-left of the dashboard. .. image:: helpdesk/helpdesk-teams-list.png - :align: center :alt: View of the Helpdesk teams page in Odoo Helpdesk. On the blank Helpdesk team form, enter a :guilabel:`Name` for the new team. Then, enter a @@ -32,7 +31,6 @@ team is assigned to, select it from the :guilabel:`Company` drop-down menu. use only. .. image:: helpdesk/team-description-webform.png - :align: center :alt: View of a Helpdesk team's website form displaying the team description. Visibility & Assignment @@ -47,13 +45,13 @@ Determine team visibility Under the :guilabel:`Visibility` section, select one of the following options to determine who can view this team and its tickets: -- :guilabel:`Invited internal users (private)`: internal users can access the team and the tickets +- :guilabel:`Invited internal users (private)`: Internal users can access the team and the tickets they are following. This access can be modified on each ticket individually by adding or removing the user as a follower. Internal users are considered *invited* once they are added as followers to an individual ticket, or :ref:`to the team itself `. -- :guilabel:`All internal users (company)`: all internal users can access the team and all of its +- :guilabel:`All internal users (company)`: All internal users can access the team and all of its tickets. -- :guilabel:`Invited portal users and all internal users (public)`: all internal users can access +- :guilabel:`Invited portal users and all internal users (public)`: All internal users can access the team and all of its tickets. Portal users can only access the tickets they are following. .. example:: @@ -65,7 +63,8 @@ view this team and its tickets: .. warning:: A team's visibility can be altered after the initial configuration. However, if the team changes - from public access to either private or company-only access, portal users are removed as + from *Invited portal users and all internal users (public)* access to either *Invited internal + users (private)* or *All internal users (company)*-only access, portal users are removed as followers from both the team, and from individual tickets. .. _helpdesk/follow: @@ -86,23 +85,20 @@ Automatically assign new tickets ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When tickets are received, they need to be assigned to a member of the team. This is done either -manually on each ticket individually, or through :guilabel:`Automatic Assignment`. Check the +manually on each individual ticket, or through :guilabel:`Automatic Assignment`. Check the :guilabel:`Automatic Assignment` checkbox to enable this feature for the team. .. image:: helpdesk/helpdesk-visibility-assignment.png - :align: center :alt: View of a Helpdesk team settings page emphasizing the automatic assignment features in Odoo Helpdesk. -As soon as :guilabel:`Automatic Assignment` has been enabled, additional fields appear. - Select one of the following assignment methods, based on how the workload should be allocated across the team: -- :guilabel:`Each user is assigned an equal number of tickets`: tickets are assigned to team members +- :guilabel:`Each user is assigned an equal number of tickets`: Tickets are assigned to team members based on total ticket count, regardless of the number of open or closed tickets they are currently assigned. -- :guilabel:`Each user has an equal number of open tickets`: tickets are assigned to team members +- :guilabel:`Each user has an equal number of open tickets`: Tickets are assigned to team members based on how many open tickets they are currently assigned. .. note:: @@ -118,7 +114,7 @@ field empty to include all employees who have the proper assignments and access their user account settings. .. important:: - If an employee has time off scheduled in the *Time Off* application, they are **not** assigned + If an employee has time off scheduled in the **Time Off** application, they are **not** assigned tickets during that time. If no employees are available, the system looks ahead until there is a match. @@ -129,7 +125,7 @@ their user account settings. Merge tickets ============= -If duplicate tickets are found in *Helpdesk*, they can be combined into a single ticket using the +If duplicate tickets are found in **Helpdesk**, they can be combined into a single ticket using the *merge* feature. .. important:: @@ -143,6 +139,44 @@ drop-down menu. Doing so opens a new page where the selected tickets are listed :guilabel:`Similarity` rating. From here, click either :ref:`Merge ` to combine the tickets, or :guilabel:`DISCARD`. +Convert tickets to opportunities +================================ + +Some tickets may be better handled by the sales team, rather than the support team. In this case, +tickets can be converted to *opportunities* and assigned to a sales team for follow-up. + +.. important:: + This feature is **only** available if the :doc:`CRM <../sales/crm>` app is installed. + +To convert a ticket to an opportunity, first navigate to a ticket, either from a team's pipeline, +or by navigating to :menuselection:`Helpdesk app --> Tickets` and clicking a ticket to open it. + +At the top of the ticket, click the :guilabel:`Convert to Opportunity` button. + +.. note:: + If :doc:`leads <../sales/crm/acquire_leads/convert>` are enabled on the **CRM** app, tickets are + converted to *leads*, and the button reads :guilabel:`Convert to Lead`. + +This opens the :guilabel:`Convert to Opportunity` pop-up. Fill in or select the following +information on the pop-up: + +- :guilabel:`Customer`: Select whether to :guilabel:`Create a new customer`, :guilabel:`Link to an + existing customer`, or :guilabel:`Do not link to a customer`. If :guilabel:`Link to a customer` is + chosen, select the appropriate customer name from the :guilabel:`Customer` drop-down. + +- :guilabel:`Sales Team`: Specify which :guilabel:`Sales Team` and :guilabel:`Salesperson` this + created opportunity is assigned to. + +.. image:: helpdesk/convert-to-opp.png + :alt: The convert to opportunity pop-up window. + +After completing the form, click :guilabel:`Convert to Opportunity`. Doing so creates a new +opportunity in the **CRM** app. The original ticket is linked in the chatter of the new opportunity +for traceability. + +.. note:: + After the ticket is converted to an opportunity, the ticket is archived. + .. seealso:: - `Odoo Tutorials: Helpdesk `_ diff --git a/content/applications/services/helpdesk/convert-to-opp.png b/content/applications/services/helpdesk/convert-to-opp.png new file mode 100644 index 000000000..b88e2eb71 Binary files /dev/null and b/content/applications/services/helpdesk/convert-to-opp.png differ diff --git a/content/applications/services/helpdesk/helpdesk-visibility-assignment.png b/content/applications/services/helpdesk/helpdesk-visibility-assignment.png index 0703e368e..c28b74db5 100644 Binary files a/content/applications/services/helpdesk/helpdesk-visibility-assignment.png and b/content/applications/services/helpdesk/helpdesk-visibility-assignment.png differ diff --git a/content/applications/services/helpdesk/team-description-webform.png b/content/applications/services/helpdesk/team-description-webform.png index b4b88068f..3006fa545 100644 Binary files a/content/applications/services/helpdesk/team-description-webform.png and b/content/applications/services/helpdesk/team-description-webform.png differ