Freshchat Source


Source Info
  • The Freshchat Source is an Event Cloud source. This means that it sends data as events, which are behaviors or occurrences tied to a user and a point in time. Data from these sources can be loaded into your Segment warehouses, and also sent to Segment streaming destinations. Learn more about cloud sources.

  • This source is in Beta
Partner Owned
  • This integration is partner owned. Please reach out to the partner's support for any issues.

Freshchat is a modern messaging software built for sales and customer engagement teams to talk to customers across websites, emails and social networks.

This source is maintained by Freshworks. For any issues with the source, contact the Freshchat Support team.

Getting started:

Before you start, make sure that you have admin rights in Freshchat and Workspace Owner or Source Admin roles in Segment.

  1. From your workspace’s Sources catalog page click Add Source.
  2. Search for “Freshchat” in the Sources Catalog, select Freshchat, and click Add Source.
  3. On the next screen, give the Source a nickname and configure any other settings.
    • The nickname is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The nickname can be anything, but Segment recommend using something that reflects the source itself and distinguishes amongst your environments (eg. Freshchat_Prod, Freshchat_Staging, Freshchat_Dev).
  4. Click Add Source to save your settings.
  5. Copy the Write key from the Segment UI to use in Freshchat.
  6. Log in to your Freshchat account.
  7. In Freshchat, navigate to Admin → Marketplace Apps → Segment Integration.
  8. Paste your Segment write key and click Authenticate account to connect.
  9. After your account is authenticated, select one or more of the following events to send to Segment:
    • On Agent Activity Create
    • On Conversation Create
    • On Conversation Update
    • On Message Create For more information about Product Events, see the Freshchat Product Events documentation.
  10. There are four events that can be pushed to Segment. You can choose the events that you want to send to Segment.
  11. You can add/remove the events that you want to send anytime after the app installation

Events

The table below lists events that Freshchat sends to Segment. These events appear as tables in your warehouse and as regular events in other Destinations. Freshchat includes the userId if available.

Event Name Description
On Agent Activity Create When the general availability or Intelliassign status changes
On Conversation Create When a conversation is initiated by a user
On Conversation Update When a conversation is:
- Assigned to an agent or group
- Reassigned to an agent
- Resolved or opened
On Message Create When a message is posted, either by the agent or user

To find the list of properties associated with the events, please refer to the Freshchat Developer Documentation.

Adding Destinations

Now that your Source is set up, you can connect it with Destinations.

Log into your downstream tools and check to see that your events are populating and they contains all the properties you expect. If all your events and properties are not showing up, refer to the Destination docs for troubleshooting.

If you experience any issues with how the events arrive in Segment, contact the Freshchat Support team

This page was last modified: 07 Aug 2024



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account