Send customer event data from Segment to Freshdesk Customer Success. To learn more about Segment, please visit their website.


Overview

Segment events contain information about interactions users have with your product. These interactions can be tracked and logged in Freshdesk Customer Success. Each event contains information about the specific interaction. This includes: the time at which the interaction occurred, the module and feature associated with the action, and the account and user ID that performed the action.


In addition to tracking user actions, the integration with Segment can also be used to add information about new users and/or accounts, and update existing users and/or accounts.


Our Segment Integration API doc outlines Segment events, and the properties of those events that Freshdesk Customer Success requires to perform these tasks.


Modules and Features

Modules and features specify a hierarchy by which to categorize events. Modules may include multiple features; while features are mapped to individual clicks or events within a module. For example, a dashboard is typically a module, while the specific action of adding a widget to a dashboard is a feature.


Limitations

Since Segment does not track the time a user spends within the product, Freshdesk Customer Success attempts to estimate the time spent within a module and time spent within a session. When we do not see a session ID (Segment anonymousId) for a period of 30 minutes, we 'timeout' the session and compute the time spent within that session. We perform similar calculations to determine the amount of time spent within a module.


Note: Our Freshdesk Customer Success JS event collector library tracks user idle time and provides much more accurate information regarding the time spent within sessions and modules.


Other Mappings

The Segment Integration API doc also outlines the preferred method for integrating Segment with Freshdesk Customer Success. We recognize that there are many ways to provide similar information. Thus, we built Freshdesk Customer Success' event collection layer to be flexible enough to support many different mappings. Please contact support@freshsuccess.com if your mappings are different to those outlined below.


Setup


Follow these steps to set up your Segment integration:

  1. In Freshdesk Customer Success, visit the IT Administration page to obtain your Freshdesk Customer Success API keys.
  2. Log into your Segment account.
  3. Search to find the Freshdesk Customer Success application.
  4. Turn on the Freshdesk Customer Success application and fill in the required Send Key (the Freshdesk Customer Success Event API Key) and Auth Key (the Freshdesk Customer Success Event Auth Key).
  5. Click "SAVE AND CLOSE".


As soon as the integration is enabled within Segment, Freshdesk Customer Success will start receiving your data. Notify support@freshsuccess.com once you enable the integration to verify that data is being received by Freshdesk Customer Success.