Video:


Overview

Exotel Freshdesk Integration enables the contextual association of calls with tickets. It enables an agent to have Incoming Call intimation, visualize the call details along with call recordings and provide Click2Call capabilities. Seamless integration for enhanced agent productivity and a better experience.

 

Key Benefits:

  1. Call Intimations - Get the notification on your Freshdesk, whenever any Incoming call comes on to your customer-facing Exotel Number or an outbound call is initiated from Freshdesk

  2. Automated Ticket Creation - Ability to create/update a ticket and associate the call with it. Automatic ticket creation is only for Missed Calls. 

  3. Click2Call - Initiate calls between you and your customer, directly from the Freshdesk

  4. Call Details - Call Recordings and Call Duration getting automatically added to the tickets.

  5. User Mapping - Map Exotel Agents to Freshdesk Users and enable Click-2-Call

  6. Work on just one interface and improve your agent productivity by eliminating context-switching.


Configuration


Follow the following prerequisites and steps to configure the integration both at Exotel and Freshdesk end.


Prerequisites


In order to have a successful integration with the Freshdesk account, you must complete the following tasks:

  1. Sign up for an Exotel Account.

  2. Verify your account through phone or email. 

  3. Get your account KYC verified.

  4. Purchase ExoPhone to be used by FreshDesk users/agents for inbound and outbound calls.

  5. From the API section, make a note of Account SID, API Key, and API Token.


Setting up of Exotel Integration


In order to set up the integration, follow these five steps:

  1. Create Co-Workers and Group

  2. Configure Freshdesk Plugin Call flow

  3. Associate the call flow to the ExoPhones

  4. Enable Integration 

  5. Map the Freshdesk User to Exotel Agents in the Integration interface and enable Click-2-Call (if required)

 

 

Step 1: Create Co-Workers and Groups


To create co-workers and groups in Exotel:

  1. Login to your Exotel dashboard and go to the ‘Co-workers and Groups’ section.

  2. Add all the co-workers corresponding to Freshdesk account, by clicking on Invite co-workers.

  3. Create a new group by clicking on the ‘Add Group’ button. Add the co-workers to that group.

 

Step 2: Configure Freshdesk Plugin Call flow


In order to create the Freshdesk Plugin Call flow, follow these five steps:

  1. Go to the ‘App Bazar’ section and under ‘Custom Apps’ click on the ‘Create’ button.

  2. Provide the App Name and click on OK.

  3. Add a Connect Applet.

  


  1. Select the Group as created earlier, under the ‘Dial a user or group’ option.

  2. Under Distribute Calls, select 'Sequentially' or 'Equally' as per your requirement.

  3. Select the remaining options as per your requirement.

  1. Under the ‘Create popup…’ section, enter the below URL (Replace the API credentials and Account sid in it with your Exotel credentials).

URL: https://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=pop

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=pop

 

  1. After the Call Conversation ends, add a Passthru applet. In that passthru applet, enter the below URL (Replace the API credentials and Account sid in it with your Exotel credentials)


URL: https://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=answered

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=answered


9. In case of automatic ticket creation requirement for incoming calls, please use the below URL in the passthru applet instead((Replace the API credentials and Account sid in it with your Exotel credentials)


URL: https://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=automated_answered

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=automated_answered


10. In the section ‘If Nobody Answers..’, select 'Go To' and add a Passthru applet. In that passthru applet, enter the below URL (Replace the API credentials and Account sid in it with your Exotel credentials)

URL: https://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=missed  

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=missed

11. Save the flow and click on Close.


Step 3: Associate the call flow to the ExoPhones


  1. Go to the ExoPhones section 
  2. Click on the button ‘Assign ExoPhones to Flow’ and select the flow created in Step 2 with the ExoPhone and click on ‘Attach Flow’
  3. In the subsequent pop-up, click on OK and you can see the flow getting associated with ExoPhone.


Step 4: Enable Integration - Freshdesk App Installation

  1. Login to your Freshdesk account.

  2. Click on the settings icon.


  1. Click on Apps under Support Operations.


  1. Click on the Apps tab.

  2. Search for the Exotel CTI App.

  3. Click on the Install button.



  1. Open the Freshdesk page in a separate tab and capture the Freshdesk API Key from the Profile page (Click on your profile picture on the top right and select 'Profile Settings'. In the sidebar on the right, you will find the API Key. In the sidebar on the right, you will find the API Key.)  

  2. Enter all required fields on the installation page. 

Freshdesk Domain

Freshdesk API Key

  • Enter the Freshdesk API key

Region of Exotel Account

  • Select the region from the dropdown list.

Exotel SID

  • Enter the Exotel Account SID.

Exotel API Key (recommended to create a new API key & token for 

  • Enter the Exotel API Key

Exotel API Token

  • Enter the Exotel API Token

EndPoint URL

Ticket Auto-Assignment to Agents

  • Enable the option to assign the tickets to the agents

Click to get agent roles

  •  Enable the option to list the Agent Roles

Freshdesk Agent Roles

  •  Select required roles from the dropdown list (Multiple roles can be selected) that can access the user Mapping Screen to map Freshdesk Agents to Exotel Mobile Numbers

  • Click on the Install Button.

  1. Once the installation is complete, refresh the page and verify that the Exotel CTI icon is added to the side panel successfully.


Step 5: User Mapping

  1. Go to the Home page (Dashboard)
  2. Click on the Exotel CTI icon in the left panel. Pop up should open up
  3. Click on the Settings icon on the top right corner
  4. The user Mapping panel opens up on the right side of the screen.

     
  5. Click on the Sync button so that all your common users between Freshdesk and Exotel will appear here.
  6. You can now use the Edit icon against each user to add or modify their data.

Device on-off

Objective: 

To Provide Agents using Exotel CTI in Freshdesk CRM a CTA to get their device status and alter the same from the CRM. This will eliminate the need for context switching and performing this action from the Exotel dashboard.


Sub - Features:

  • Get Device status

  • Update user device

  • Refresh (in case of error or as a fallback)


How to: 

  1. Launch the Exotel CTI in the Freshdesk account.

  2. Click on the device status button. The present status gets reflected.






  1. Use the toggle button to change the device status of the agent.



  1. Use the Refresh button in case of an error.


  1. If the error repeats, please contact hello@exotel.in




IVR/Gather digits in ticket details

Objective: 

To provide Freshdesk CTI users, who specifically use IVR and/or Gather applet in their Exotel call flows, with the IVR/Gather digits along with their respective representation as a part of call ticket details in the CRM. 


Sub - Features:

  • Automated ticket creation in FD for all incoming call flows which have IVR and/or Gather applet. 

  • IVR Digit inputs for incoming calls get automatically updated in a new FD ticket. 

  • Gather Digit inputs for incoming calls.

  • Representation of each IVR digit in the order of occurrence.


How to:

  1. Edit the Exotel call flow in the Exotel app bazaar.

  2. In the IVR applet, for each IVR keypress add a pass-thru applet

  3. In the pass-thru applet URL, enter the following URL:

URLhttps://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=ivr

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=ivr

 

If you want the respective representation of each IVR digit to also be added in the ticket details then:

 

URL: https://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=ivr&ivr_tag_<number>=<representation_of_keypress>

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=ivr&ivr_tag_1=lang_english

 

  1. To notify the end of the flow, add another pass-thru applet in the “In response” section of the last pass thru of the last IVR keypress or Gather applet and add the following URL. This is a mandatory step for passing the inputs to the FD ticket.

URLhttps://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=end

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=end

 

  1. For the Gather applet, add a pass-thru applet, in the “When the caller entered one or more input digits... “ section and enter the below URL:

URLhttps://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=gather

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=gather

 

If you want the respective representation of the gather digits to also be added in the ticket details then:

 

URL: https://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=gather&gather_tag_<number>=<representation_of_gather_input>

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=ivr&gather_tag_1=customer_account_number

Screenshots of tickets with IVR and Gather inputs:

Voicemail recording passed to FD tickets:

Objective: 

To provide Freshdesk CTI users, who specifically use the voicemail applet in their Exotel call flows, with the voicemail recording in the call ticket details of Freshdesk.

 

How to:

  1. Edit the Exotel call flow in the Exotel app bazaar.

  2. In the voicemail applet, add a passthru applet at the end

  1. In the passthru applet URL, enter the following URL:

URLhttps://<exotel_APIKey>:<exotel_APIToken>@<middleware_subdomain>/v2/accounts/<accountSid>/call-events?event=voicemail

Middleware_subdomain: freshdesk.mum1.exotel.in 

E.g: https://<exotel_APIKey>:<exotel_APIToken>@freshdesk.mum1.exotel.in/v2/accounts/exotel535/call-events?event=voicemail

  

Screenshots of tickets with voicemail recording:

Call a new number

Objective: 

To provide users with the capability to make a call to a new number from Freshdesk without having to add a contact.


How to:

  • Open the Exotel app in Freshdesk, the window that opens by default is where you can type in the number and click on call.


            

  • Click on the     button to go to the call history page


  • From the call history page, click on the    button to go back to the default calling page



Known Limitations:

  • On-Call Events: For both Incoming Call and Outbound Call pop-ups, the call events (like CallAnswered, Ringing, etc.) will not be triggered. Hence, once the call is over, click on ‘Answered’ and do the subsequent action.
  • Call Recording Upload: The call recordings will be uploaded under ticket details within an interval of 5 minutes. The agent needs to refresh the Freshdesk ticket screen after 5 minutes of calls completed, in order to see the respective call recordings.



Freshdesk App - UI screens


 Call History Screen



Call Notes Screen

Incoming Call Notification screen



Ticket History screen to Add notes to existing Ticket



Automatic ticket created for incoming call



Points to remember:

  • You cannot integrate multiple Freshdesk accounts with a single Exotel account. 
  • The integration is currently enabled only for the website application. The integration features are not compatible with the FreshDesk mobile application.
  • All the users should be added to both Exotel and Freshdesk with the same email ID and the phone number for the integration to work.


Looking out for answers to your queries?


Say ‘Hello’ to us at:

Support Email ID: fdksupport@sirahu.com