Freshservice Documentation ============================================= This guide will show you how to set up FreshDesk / FreshService to work with your new Helpdesk Buttons in as few as 15 minutes. Integration ------------------- Freshservice integration requires three main parts: `1) set up an unregistered user as a catchall account as a contact in your PSA `_ `2) set up the API integration. `_ `3) configure helpdeskbuttons account. `_ Video Walkthrough ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ FreshDesk and FreshService setup is very similar .. raw:: html
1) Unregistered User ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ By default, our software attempts to pair users with their contact information by checking with Freshservice. If the user is not already found in the system a catch all account submits the ticket instead. This can be disabled for PSA's that allow users to create accounts on ticket submission. Look at the :ref:`Integration Defaults ` below. This guide assumes you want to use the catch all contact: To start you will need to set up a contact that uses the email address of “unregistered@helpdeskbuttons.com” for the purposes of catching any unregistered users. You can name the account whatever you want. In our system it’s “Mystery Human”. 2) Getting an API Key ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ On the left of your screen, click the admin button. .. image:: images/fd-image-1.png Scroll down and select Agents .. image:: images/fd-image-2.png Click ‘New Agent .. image:: images/fd-image-4.png And then fill out the information needed. This account needs the Administrator and Agent Roles roles. After you have created that account, sign into it and go to the profile. You can get there by clicking your account picture and then selecting profile. In the upper right, you will see ‘Your API Key’ .. image:: images/fd-image-5.png Please take note of this API Key, you will need it in a little bit. 3) Helpdeskbuttons.com Setup ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The next step is to sign into your Helpdeskbuttons.com account and enter this information under Settings->Backend Information .. image:: images/fd-image-3.png Enter your Ticket System API endpoint and the Ticket System API Key. Your Ticket System API endpoint is the main URL that you use to log into FreshService. In this instance .. image:: images/fd-image-6.png Click update once you are done. At this point, your FreshService instance will be ready to go with your Helpdesk Buttons. Access Restrictions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ As of 0.5.x: The agent needs to have Administrator and Agent Roles. Integration Defaults ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ *auto_reg* """""""""" The "auto_reg" flag allows users to be auto_registered by their email address instead of added to an unregistered/catch all user. Keep in mind that if a user mistypes their email they will create a user. If you want to set auto_reg as an integration default, you can add it as a custom field: .. image:: images/freshdesk_auto1.png :target: https://docs.tier2tickets.com/_images/freshdesk_auto1.png Now hit update to save the changes. It should then look like this: .. image:: images/freshdesk_auto2.png :target: https://docs.tier2tickets.com/_images/freshdesk_auto2.png Anti-Virus and AntiMalware -------------------------------------- It is not always necessary, but we recommend whitelisting the tier2tickets installation folder (C:\\Program Files(x86)\\tier2tickets). We regularly submit our code through VirusTotal to make sure we are not getting flagged, but almost all AV/M interactions cause some sort of failure. `Webroot `_ in particular can cause issues with screenshots. Dispatcher Rules ---------------------------------------------------------------------- This is the list of variables that can be accessed when using the :ref:`Dispatcher Rules `. +----------------------------------------------------------------------+----------------------------------------------------+ | Read/Write | Read Only | +======================================================================+====================================================+ | :ref:`content/integration/freshservice:*priority*` | :ref:`content/automations/dispatcher:*selections*` | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/integration/freshservice:*status*` | :ref:`content/automations/dispatcher:*name*` | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/integration/freshservice:*department*` | :ref:`content/automations/dispatcher:*email*` | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/integration/freshservice:*agent*` | :ref:`content/automations/dispatcher:*ip*` | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/automations/dispatcher:*msg*` | :ref:`content/automations/dispatcher:*mac*` | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/automations/dispatcher:*subject*` | :ref:`content/automations/dispatcher:*hostname*` | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/integration/freshservice:*source*` | | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`impact` | | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`urgency` | | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/automations/dispatcher:*append*` | | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/integration/freshservice:*group*` | | +----------------------------------------------------------------------+----------------------------------------------------+ | :ref:`content/integration/freshservice:*priv_append*` | | +----------------------------------------------------------------------+----------------------------------------------------+ Field Definitions ^^^^^^^^^^^^^^^^^ *priority* """""""""" **The ticket priority level (Urgent, Low, etc.):** .. image:: images/fs-priority.png :target: https://docs.tier2tickets.com/_images/fs-priority.png | | *impact & urgency* """""""""""""""""""""" **Can set priority via the SLA priority matrix:** Impact: .. image:: images/fs-impact.png :target: https://docs.tier2tickets.com/_images/fs-impact.png | Urgency: .. image:: images/fs-urgency.png :target: https://docs.tier2tickets.com/_images/fs-urgency.png | | *status* """""""" **The ticket status (New, In Progress, etc):** .. image:: images/fs-status.png :target: https://docs.tier2tickets.com/_images/fs-status.png | | *group* """"""" **The group the ticket will be put in:** .. image:: images/fs-group.png :target: https://docs.tier2tickets.com/_images/fs-group.png | | *department* """""""""""" **The department the ticket will be put in:** .. image:: images/fs-department.png :target: https://docs.tier2tickets.com/_images/fs-department.png | | *agent* """"""" **The agent that will be assigned this ticket:** .. image:: images/fs-agent.png :target: https://docs.tier2tickets.com/_images/fs-agent.png | | *source* """""""" **The ticket source (Web Portal, Etc):** .. image:: images/fs-source.png :target: https://docs.tier2tickets.com/_images/fs-source.png | | *priv_append* """"""""""""" **Allows you to append information to the internal ticket note:** .. image:: images/fs-priv_append.png :target: https://docs.tier2tickets.com/_images/fs-priv_append.png | | *other* """"""" There are additional variables which are common to all integrations. Those are documented :ref:`here ` Webhook Walkthrough ---------------------------------- .. image:: images/coming_soon.png