Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

How it works

Image Removed   Freshdesk integration is used to automatically open

On this page

Table of Contents
minLevel1
maxLevel2
outlinefalse
stylenone
typelist
printablefalse

📋 What’s about

Freshdesk integration automatically opens a ticket for every call depending on the conditions (Queue, Call status or Outbound) set in the trigger. The ticket will be populated with information about the call and displayed for the agent in

the Freshdesk environment. Widget Connectorwidth450

the Freshdesk environment.

Info

Any interaction occurred through this integration can be searched by the Agent from the list by:

  • contact's phone number

  • user's email

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width450px
urlhttps://www.youtube.com/watch?v=vm4igJq_fyM
height300px

(blue star) Requirements

Panel
bgColor#EAE6FF

The following are list of things you have to do to make the integration work:

Create Freshdesk account
  • Create Freshdesk account

  • Create a configuration for the account

  • Create a trigger (Tools → Triggers), set the conditions you want to trigger the integration and add integrations action (for info see V3 Voice Triggers)

 by
  •  by selecting

Freshdesk integration
  • Freshdesk integration, the

Freshdesk account
  • Freshdesk account you have configured and the configuration you want to use. 

  • Login agent

in Freshdesk and
  • in Freshdesk and Motion

Every time there is an outgoing/incoming call, the trigger conditions are checked and

Freshdesk ticket

a Freshdesk ticket is created and assigned to the agent managing the call if the conditions are met.

Note

When an agent manages a call, the agent will first be searched in Freshdesk by Email address and then assigned to the ticket only if the agent account is found.

Otherwise,

the

the ticket will be assigned to the Freshdesk administrator account used in Motion-Freshdesk integration.

Panel
titleOn this page:

Table of Contents

Info

Any interaction occurred through this integration can be searched by the Agent from the list by:

  • contact's phone number
  • user's email

    If all the configurations are properly configured, the Freshdesk ticket will be opened as shown below.

    Image Removed
    Image Added
    Info

    The Ticket Subject, Description, Fields and Tags can be managed and customized in the CreateaFreshdeskConfiguration section.

    ⚙️ Important configuration Hints

     In order to

     To create and assign

    ticket

    tickets to agents properly, you have to make sure:

    • Agent's Email in the

    Freshdesk profile
    • Freshdesk profile is

    exactly
    • the same as Agent's Email in Motion

    • the Agent is logged in:  XCALLY Motion Phonebar, XCALLY Motion web interface and Freshdesk web interface

    • the Agent ENABLE the browser pop-ups

    ,
    • when he/she receives the first call

    Image Removed
    Image Added

    💡 The Freshdesk Accounts Section

    The Freshdesk Accounts Section is under the Integrations Menu:

    Image Removed
    Image Added
    Image Removed
    Image Added

    Create

    Freshdesk Account

    a Freshdesk Account

    To create a new Freshdesk Account click on 

    Image Removed

    (blue star)

    Image Removed
    Image Added

    Enter the following details and click on Add Freshdesk Account

    • Name: name for the integration

    • Username: same as

    Freshdesk Administrator
    • a Freshdesk Administrator Account

    • URI: your Freshdesk URL

    • API Key: your API Key string. See herehow to find it in Freshdesk.

    • Motion or Proxy IP Address: written in <protocol>://<ipaddress>[:<port>] form. It is required to use the Recording URL in the Ticket Configuration.   Example: https://X.Y.Z.W   

    • Description (optional)     

    After the Account is created, you can view it in the list of accounts, edit the account parameters and remove the account. You can verify if the account credentials are correct by clicking on Test

    Freshdesk

    Freshdesk Account.

    Edit

    Freshdesk Account

    a Freshdesk Account

    Find the account from the accounts list and Click on Edit Freshdesk Account.

      

      

    Image Removed
    Image Added

    You will see two tabs: Account and Configurations. In the Accounts tab, you can modify the account parameters and in the Configurations tab, you can create, update or

    delete Freshdesk configurations

    delete Freshdesk configurations

    Create a Freshdesk Configuration

    A

    Freshdesk configuration

    Freshdesk configuration is used to design the content of the

    Freshdesk ticket

    Freshdesk ticket (Subject, Description, Fields and Tags )

    that is

    created and displayed for the agent managing calls. You can create multiple configurations for a single

    Freshdesk Account

    Freshdesk Account and use them in different triggers. In this way, you

    will be able to

    can use different ticket

    layout

    layouts for outbound and inbound calls.

    To create a new configuration, edit the

    Freshdesk account

    Freshdesk account, go under the configurations tab and click on Image Modified

    Image Removed
    Image Added

    Choose a Name, Channel and Type and click on Add

    Freshdesk Configuration

    Freshdesk Configuration.  

    The configuration will be created with default Subject and Description settings that you can simply use without any modification.

    You can also edit the configuration

    and customize

    and customize the SubjectDescriptionFields and Tags of

    the Freshdesk Ticket

    the Freshdesk Ticket according to your needs.

    Note

    The default Subject and Description settings depends on the type of configuration. For example, the default subject configuration for Queue Type is [XCALLY Ticket] Queue calleridnum while for Outbound Type it's [XCALLY Ticket] Outbound Call destcalleridnum.

    Note

    Configuration changes are automatically applied, without any service restart.

    Info

    You can use Motion Standard Variables or Custom Variables in the configuration.

    Subjects

    Image Removed
    Image Added

    By default, you will find the following three

    fields already

    fields already configured

    • the String [XCALLY Ticket]

    • the Queue Variable

    • the Caller number Variable

    You can add more than one field in the Subject and all fields will be join by the blank space.

    Use Image Modifiedbutton to add a new fields. New fields are added at the end of the field list.

    You can insert 3 different type of fields:

    1. String: static

    string e
    1. string e.g. [XCALLY Ticket]

    2. Variable: Motion System Variable (e.g. queue or calleridnum)

    3. Custom Variable: dynamic variable created under Tools

    Variables
    1. > Variables

    Descriptions

    Image Removed
    Image Added

    You can add more than one

    fields

    field in the Description. All fields will be

    join

    joined by new line.

    Use Image Modifiedbutton to add a new

    fields

    field. New fields will be added at the end of the field list.

    You can insert two different type of fields:

    1. String: static string e.g. *** Call Info ***

    2. Key Value: name-value item in the form name: value

    where the first field is a static string (e.g. Caller Number) and the second field could be filled with the following:

    • String: static string

    • Variable: System

    Variable
    • Variables like Caller Number

    • Custom Variable: dynamic variable created under  Tools

    Variables
    • > Variables

    Note

    The colon character in the Key Value type is automatically added by the system

    Fields

    Image RemovedImage Added

    You can add more than one field.

    In the drop-down list you can find the complete list of fields available in your Freshdesk account: Standard and  and Custom Ticket fields fields.

    Choose the field from the list (Standard or Custom):

    Image Removed

    Image RemovedImage AddedImage Added

    and define the the Type:Image Removed

    Image Added
    • String: static string (you must insert it)

    • Variable: a System Variable (choose it from the list: e.g. Queue, uniqueid, calleridnum, etc.)

    • Custom Variable: one of the dynamic variables (created under Tools > Variables)

    • Picklist: choose among the list of the integrated Application Fields. You can only select one of the predefined values available for that field (if any).

    Tags

    Image RemovedImage Added

    You can add multiple Tags.

    You can select the tags that you configured in Tools > Tags

    Create a Trigger 

    It is mandatory to create a trigger to make the

    Freshdesk integration

    Freshdesk integration work. Go to Tools -> Triggers Section and click on New Trigger.

    Image RemovedImage Added

    Enter the trigger Name, select Voice Channel and click on Add Trigger. 

    Edit the trigger to define the trigger's Conditions and Actions.

    Note

    Do not forget to set the trigger's status ON.

    Add Trigger Conditions

    You can

    use properties like Queue

    use properties like Queue, Call status or outbound

    to define

    to define the conditions you want to trigger the

    Freshdesk integration

    Freshdesk integration. The conditions show in the following figure means that the integration will be active for Calls in Sales Queue and when the call is answered.

     For

     For more information on trigger conditions, take a look at Voice Trigger Conditions.

    Image Removed
    Image Added

    Add Trigger Action

    To execute the

    Freshdesk integration

    Freshdesk integration when the conditions are met, click on Add Action and select Integrations and Freshdesk. You can then select one of

    the the Freshdesk account

    the Freshdesk account you have created and the configuration you want to use.

    Image Removed
    Image Added