Note: 

This app is currently available in beta version and has limited functionalities with template recipes for configuring workflows. 


As part of the beta plan, you will receive 5000 free tasks to start using the app, valid until Dec 31, 2024.


Please reach out to our support team/CSM if you face any issues while using the app. You may encounter feature improvements or bugs while using this app as the development is still in progress. Your feedback will help us make the app experience better.


If you have additional recipe requirements, please contact our product team through your CSM or support team.


This connector is available only for pro and enterprise accounts on Freshservice.


Introduction


The integration between Freshservice and BMC Helix offers service management teams enhanced visibility and efficiency when collaborating with multiple stakeholders. Admins can seamlessly create, update, and sync tickets between both systems using predefined recipes.


With the Freshservice and BMC Helix integration, agents can:

  • Create and update records in BMC Helix whenever there is a new ticket created or updated in  Freshservice

  • Create or update a ticket in Freshservice whenever a record is created or updated in BMC Helix

  • Map custom fields across both systems

  • Select tickets for sync based on specific conditions

  • Define the workspace for tickets to be added or mapped from

  • Sync conversation notes


Prerequisites

You need to have an active BMC Helix account. You will need your login credentials and BMC Helix base URL to enable this integration.


Every account administrator within Freshservice can initiate this integration.


Installation and configuration

  1. Go to your Settings. Search for Apps using the search bar. 

  2. Click on Connector Apps. From the list of apps, click on BMC Helix Connector. 

  3. Install the app by clicking on the ‘Install’ button and you will be directed to the configuration page.

  4. Enter the Domain URL and the API Key to connect your Freshservice account. Click Next.

  5. Enter your Username, Password, and Web server URL to connect your BMC Helix account. Click Connect and once the connection is established successfully, click Install.

How to check the list of all available recipes

  1. After installation, go to Settings > Connector Apps. You will see your installed BMC Helix Connector app listed here. You have two options here
    a. Configure App: Use this to edit the default recipes, view Overview dashboard metrics, and configure your Widget settings. These are explained in the upcoming section.

b. Settings: If you wish to go back to your configuration page and disconnect or re-authenticate BMC Helix or Freshservice use this option.

  1. Click on the Configure App option. It will take you to a tab with Overview and Recipes. 

  2. Click on the Recipes tab. It will show you a list of all the available recipes


List of all the default recipes available

Here is the list of all default recipes available for the Freshservice integration with BMC Helix


Recipe

Function

BMC Helix ITSM to Freshservice - Ticket Creation/Updation

Create and update records in BMC Helix whenever there is a new ticket created or updated in  Freshservice

Freshservice to BMC Helix ITSM - Ticket Creation/Updation

Create or update a ticket in Freshservice whenever a record is created or updated in BMC Helix



How to preview, edit, activate, and stop the recipe 

You will be able to preview, edit, activate, and stop the available recipes.


Preview recipe: 

Click on the Preview button next to the recipe that you want to view. The recipe window will open and you will be able to view the steps involved in the recipe with pre-configured triggers, actions, and conditions.


On the left hand panel, you will be able to view the Recipe status, jobs executed, dependencies, and activity timeline.


Start recipe: 

You can activate the recipe in two ways:

  1. From the main recipe page, click on the Start button corresponding to the recipe you want to activate.

  2. Click on the Preview button. Within the recipe window, you will see an option to Start the recipe.


Edit recipe:

Follow the below steps to edit the recipe:

  1. Click on the preview button next to the recipe to open the recipe window. If the recipe is inactive, you will find the edit button available.

  2. If the recipe is active, stop the recipe by clicking on the Stop recipe button. Now click on Edit recipe button.


Stop recipe:

You can activate the recipe in two ways:

  1. From the main recipe page, click on the Stop button corresponding to the recipe you want to stop

  2. Click on the Preview button. Within the recipe window you will see an option to Stop the recipe.


How to customize a recipe

Each recipe has the following components: Trigger, Actions, and Conditions. You can customize any part of the recipe depending on your specific use case by just clicking them.

Let’s take one of the default recipes as an example and see how you can customize it further.


Recipe - Freshservice to BMC Helix ITSM - Ticket Creation/Updation


Trigger

The trigger acts as the starting point for any recipe. For this recipe, the trigger is a ticket being created or updated in Freshservice. You can customize the trigger in the below mentioned ways.

  • You can either add optional fields or add/modify a trigger condition. For example - you can choose the workspace which the trigger will listen to.

  • You can view the list of optional fields available for the particular trigger by clicking on the ‘optional field available’ button.

  • The trigger condition can be added by clicking on the ‘+’ option below the trigger conditions section. You can select if you want to set up an AND or OR condition.

  • You can set the trigger data by choosing from a list of available attributes. For example - you can set the priority of the ticket as one of the conditions.




Condition

The condition acts as a checkpoint within the recipe flow and executes a specific set of actions based on the condition matched. This recipe checks for two conditions. First, the recipe checks if the Freshservice workspace is as per the condition configured. After that it checks if a corresponding record matching the Freshservice ticket number exists in BMC Helix. You will be able to check and edit the following conditions.


Action

The recipe performs a specific set of actions based on the conditions specified. Based on the conditions mentioned above, the recipe either creates or updates a record in BMC Helix. You can customize the following parts of the action:

  • You can choose to perform any action from the existing set of actions available under the ‘All Actions’ tab.

  • You can map values from the Freshservice ticket to the corresponding fields in the BMC Helix record.

  • You can add more fields from the available set of optional fields 


After making all the necessary changes, you can save the recipe directly or test it first to ensure that it is working correctly.


How to check failed jobs

To view and troubleshoot the reason for a failed job under a recipe, please follow the steps mentioned below:

  1. Click on the Preview button of the specific recipe from the main recipe page.

  2. In the recipe window, navigate to the Jobs tab

  3. You will see the list of all the jobs executed under a particular recipe here

  4. You can filter to check just the failed jobs by using the Status filter on the top panel

  5. You can click any particular job to view further details about how the job was executed

  6. If you click on a job that has failed, you will be able to view the error details that will help you identify the cause of failure

  7. You can resubmit the job once you have reviewed it and fixed the issue. 


Overview dashboard

The Overview tab also helps you understand the total number of tasks that you've consumed (based on which your billing for the app will happen). It also helps you have a consolidated view of the number of successful job vs. failed jobs for a given recipe.