Bidirectional ticket sync between Freshdesk and Linear with error logging

How it works

This workflow synchronizes support tickets in Freshdesk with issues in Linear, enabling smooth collaboration between support and development teams. It triggers on new or updated Freshdesk tickets, maps fields to Linear’s format, and creates linked issues through Linear’s API. Reverse synchronization is also supported, so changes in Linear update the corresponding Freshdesk tickets. Comprehensive logging ensures success and error events are always tracked.

Step-by-step

1. Trigger the workflow - New Ticket Webhook – Captures new Freshdesk tickets for issue creation. - Update Ticket Webhook – Detects changes in existing tickets. - Linear Issue Updated Webhook – Listens for updates from Linear.

2. Transform and map data - Map Freshdesk Fields to Linear – Converts priority, status, title, and description for Linear. - Map Linear to Freshdesk Fields – Converts Linear state, priority, and extracts ticket ID for Freshdesk updates.

3. Perform API operations - Create Linear Issue – Sends GraphQL mutation to Linear API. - Check Linear Creation Success – Validates issue creation before linking. - Link Freshdesk with Linear ID – Updates Freshdesk with Linear reference. - Update Freshdesk Ticket – Pushes Linear updates back to Freshdesk.

4. Manage logging and errors - Log Linear Creation Success – Records successful ticket-to-issue sync. - Log Linear Creation Error – Captures and logs issue creation failures. - Log Freshdesk Update Success – Confirms successful reverse sync. - Log Missing Ticket ID Error – Handles missing ticket reference errors.

Why use this?