January 2021
6.9.5: Known issues and minor bugs have been fixed.
December 2020
FDK 6.9.0, 6.9.1, 6.9.2, 6.9.3, and 6.9.4: Known issues and minor bugs have been fixed.
FDK 6.8.0: Known issues and minor bugs have been fixed.
October 2020
FDK 6.7.0, 6.7.1, and 6.7.2: Known issues and minor bugs have been fixed.
The cti.triggerDialer event method has been added.
September 2020
FDK 6.6.1, 6.6.2, and 6.6.3: Known issues and minor bugs have been fixed.
FDK 6.5.5, 6.5.6, and 6.6.0: Known issues and minor bugs have been fixed.
July 2020
The following Interface methods have been added for fields on the Edit contact details window and CONTACT DETAILS pane (requestor widget) of the Ticket Details page, Edit contact window of the Contact Details page, and Edit contact window of the Contact List page.
- hide field
- show field
- disable field
- enable field
iparams callback functionality: A new feature to invoke a callback function when an event associated with an iparam occurs has been added. This feature enables making an installation page dynamic.
June 2020
Support has been added for running apps in the background when the Company Details and Company List pages are loaded.
The following Interface methods have been added for fields on the Company Details page and the Edit company window of the Company List page.
- hide
- show
- disable
- enable
FDK v6.5.4: Known issues and bugs have been fixed.
FDK v6.5.3: Known issues and bugs have been fixed.
FDK v6.5.2: Support has been added for a new iparams attribute, visible, that enables displaying or hiding an iparam on the installation page.
FDK v6.5.1: Support has been added to detect sensitive iparams when running the fdk validate and fdk pack commands and display a warning to mark them as secure.
FDK v6.5.0: Known issues and bugs have been fixed.
FDK v6.4.0: Known issues and bugs have been fixed.
May 2020
FDK v6.3.2: Known issues and bugs have been fixed.
April 2020
As part of CLI v6.3.1, the OAuth refresh token handler has been enhanced to use appropriate refresh tokens to retrieve access tokens. At times, third-party resource providers do not issue new refresh tokens as part of their refresh strategy. The handler uses the old refresh token in such cases.
As part of CLI v6.3.0, the FDK has been enhanced to include a testing framework (beta) that enables creating automated unit tests for serverless apps. The framework uses the popular mochaV5. For information on how to write and run tests, see the Testing Framework documentation.
As part of CLI v6.2.7, the --fix option has been added to the validate command, to enable auto-fixing certain lint errors.
As part of CLI v6.2.6, some FDK bugs have been fixed.
As part of CLI v6.2.5, some FDK bugs have been fixed.
As part of CLI v6.2.4, the FDK has been updated to load static resources over HTTPS, by default.
March 2020
We have added the Show Missed Calls and Hide Missed Calls methods for the Global CTI location.
As part of CLI v6.2.2, we have added fixes for number of bugs.
February 2020
We have documented Lint validations which happen when running the fdk validate and fdk pack commands on an app.
As part of CLI v6.1.1, we have added support for two new types of installation parameters, domain and api_key, to validate the domain name and API key specified for a product, during app installation.
To accommodate the changes in Chrome 79 and higher versions, where HTTPS pages only load secure subresources, the app testing process has been modified. According to the latest Chrome release notes, HTTPS pages will only be able to load secure subresources, with changes from Chrome 79 to Chrome 81.
January 2020
The following enhancements have been made:
- In Request method, added new options, maxAttempts and retryDelay, and a new attribute, attempts.
- You can test external events on your computer using ngrok.
As part of CLI v6.0.1,
- You need to uninstall the previous CLI version by using the npm uninstall fdk -g command and install the latest CLI version.
- When testing scheduled events on your computer, the schedules will be triggered at the specified time and frequency after they are created or updated.
As part of CLI v6.0.0, added support for Node 10.x. Support for Node 8.10.x has been deprecated.
December 2019
As part of CLI v5.4.0, the iparam_test_data.json file has been deprecated. Before testing the app, navigate to http://localhost:10001/custom_configs and enter appropriate values for the configured installation parameters.
As part of CLI v5.3.0, added fixes for a number of minor bugs.
November 2019
As part of CLI v5.2.8, you can add external assets, such as .css and .js, in the config/assets folder to render the Custom Installation page.
As part of CLI v5.2.6, added fixes for a number of minor bugs.
October 2019
As part of CLI v5.2.5, added fixes for a number of minor bugs.
As part of CLI v5.2.4, added fixes for a number of minor bugs.
September 2019
As part of CLI v5.2.1, added fixes for a number of minor bugs.
As part of CLI v5.1.0, added fixes for a number of minor bugs.
July 2019
As part of CLI v5.0.10, Request method now supports text/javascript content type.
As part of CLI v5.0.9, added fixes for a number of minor bugs.
June 2019
As part of CLI v5.0.8, the README.md file, describing app features and working, can now be packed in the app zip file.
As part of CLI v5.0.7, added fixes for a number of minor bugs.
The following methods were added to the Ticket Details page:
- Hide Mark as Spam Option
- Set Note Options
- Set Note Type
- Set Notify to Field
- Hide Edit Option in Notes
- Show Edit Option in Notes
Tags, a new element with hide, show, enable, and disable properties, was added to the Ticket Details page methods.
A new attribute, abilities, was added to the Global Data methods.
A new Events method, ticket.fromChanged, was added to the New Email page.
As part of CLI v5.0.6, added fixes for a number of minor bugs.
May 2019
As part of CLI v5.0.4, you can now detect bugs in your app caused by improperly assigned variables.
As part of CLI v5.0.3, added fixes for a number of minor bugs.
As part of CLI v5.0.2, added fixes for a number of minor bugs.
April 2019
The new CLI v5.0.0 adds support for Node 8.10.x. For more information, see Moving on to Node.js 8.
As part of CLI v4.9.5, added fixes for a number of minor bugs.
March 2019
The new CLI v4.9.2 adds support for fdk generate.
February 2019
As part of CLI v4.8.0, added fixes for a number of minor bugs.
January 2019
Requests from apps can now be received from predetermined IP ranges.
The following serverless events were added:
December 2018
Merry Christmas! Added support for the following Time Entry serverless events:
The new CLI v4.5.0 adds support for agent-level OAuth2.
November 2018
A new Interface method, setOptions, was added to the Ticket Details and New Ticket pages.
The new CLI v4.4.11 adds support for the set and remove actions in Data Storage.
The following Editor Window methods were added to the Ticket Details page:
A new Intercept Event method, ticket.sendReply, was added.
October 2018
You can now retrieve a list of options from the status, priority, type, or custom field objects available on the Ticket Details, New Ticket, and New Email pages.
The email_config object can now be retrieved from the Ticket Details and New Email pages.
The new CLI v4.4.8 adds support for the Update operation in Data Storage.
The following Global Data Methods can now be used by CTI apps:
- loggedInUser
- domainName
The minimum height limit for Instance method has been removed.
September 2018
The new CLI v4.4.3 adds support for the following enhancements in Data Storage:
The new CLI v4.4.1 adds support for the following locations:- Full page apps and
- Global CTI.
August 2018
As part of CLI v4.3.12, client ID and secret can be configured during installation using OAuth installation parameters. Also, OAuth installation parameters can be used to whitelist domains.
Added new methods to hide/show/enable/disable the Edit Ticket option on the Ticket Details page.
Added a new method to remove quoted text in the Ticket Reply editor.
July 2018
Added a new app location in the Ticket Details page. Apps can now be placed in the background of the time entry modal.
The hourly rate limit for data storage has been removed. Only the per minute limit applies.
The new CLI v4.3.8 adds support for secure iparams. Read more about securing sensitive installation parameters from this blog post.
The following tutorials have been added to the platform blog.
Apps can now be added in the Contact List page.
June 2018
Added the Scheduled Events sample app to the repository.
Schedules can now be created from the front-end component of the app using Server Method Invocation (SMI).
Updates to custom apps will now be reflected within 5 minutes.
May 2018
The new CLI v4.3.2 adds support for Scheduled Events which enable serverless apps to be executed in response to one time or recurring schedules.
Fixed validation for NPM dependencies in CLI v4.3.1.
The new CLI v4.3.0 supports local testing for an upcoming platform feature, Scheduled Events.
Data storage limit for the combined size of the key and value is now 8 KB.
Apr 2018
To improve security, we sandboxed the Custom Installation page in an IFrame. If you are already using this feature, please follow this migration guide to ensure that your app is unaffected.
The Insert into Editor Window Interface method now allows attachments to be added in the Editor window.
Revamped the Sample Apps page classifying sample apps by specific features and use cases. Also, added the following sample apps to the repository:
Mar 2018
Added logging to enable developers troubleshoot the serverless component of custom apps.
As part of CLI v4.2.1, added fixes for a number of minor Windows bugs.
Added a new Instance method to enable developers close modals and dialogs.
Feb 2018
The following enhancements have been made to Installation Parameters:
- Added new types of parameters such as URL, email, number, phone number, date, and multiselect.
- Regexes can now be used to validate parameters entered by a user.
- Added support for setting installation parameters as either required or optional.
- Optional parameters need not be set in the iparam_test_data.json file.
The enhanced Insert text into editor window method now allows developers to add text at the beginning or end of existing content.
The following Interface methods were added to the Ticket Details page:
As part of CLI v4.1.9, added two more app locations for Freshservice apps and fixed a few minor bugs.
The following Interface methods were added to the Editor window:
Added a new Instance method to help developers manually set the height of app instances.
As part of CLI v4.1.8, added fixes for a number of minor bugs.
Jan 2018
Published documentation on how apps can make requests that are authenticated using JSON Web Tokens (JWT).
As part of CLI v4.1.7, added support for local testing of the Custom Installation page.
The following sample apps were added to the repository:
- Ticket Background app
- Ticket Top Navigation app
- Intercepting Events app
- Intercepting Events app 2
- Instance API and Modal app
- Simple Events API app
The following intercepting Event methods were added:
- Ticket Close
- Ticket Properties Updated
Happy New Year! As part of CLI v4.1.5, added support for OAuth installation parameters. This enables developers to build integrations with OAuth providers, such as Shopify, that have dynamic authorization and token URLs.
Dec 2017
For CLI v4.1.5, we added a new CRM template and fixed several bugs.
The following Interface methods were added:
- Enable and Disable the ticket delete buttons
- Hide and Show the ticket attachment delete buttons
- Stop and Start the timer
- Expand conversation
- Insert text in the open conversation editor window
Added Event methods to enable apps to listen for and react to timer start, stop, delete, and update events.
Added support for more Installation parameters to help developers enhance the app installation experience.
Added the Simple CRM app to the repository.
Published coding guidelines to help developers create apps that quickly pass through the review process.
Nov 2017
For CLI v4.1.2, we increased the size limit for entries to the data store from 1 KB to 4 KB and added an encode method that can be used to base64 encode API keys and usernames and passwords when making requests.
For CLI v4.1.1, OAuth access tokens are now available for use in serverless apps.
For CLI v4.1.0, wildcards are now supported while whitelisting domains.
The following sample apps were added to the repository:
As part of CLI v4.0.3, we can now build apps for Freshservice.
Added Instance methods to allow communication between multiple instances of the same app. This can also be used to enable modals to communicate with the parent instance and vice versa.
Added support for Custom Installation pages for apps. This enables developers to build installation pages that contain UI elements and workflows which are not available in the standard installation page.
Oct 2017
The following app locations have been added as part of CLI v4.0.2:
- On the Ticket Details page, apps can now be placed in the attachment icon, conversation editor window, and background.
- On the Contact Details page, apps can now be placed in the background.
- On the New Ticket page, apps can now be placed in the contact sidebar and background. Events methods have been added for this location.
- On the New Email page, apps can now be placed in the contact sidebar and background. Events methods have been added for this location.
New in v2
Here are some brand new features in the v2 App Development Platform.
- Apps run in IFrames creating a layer of abstraction between the app and page.
- Apps in the new Freshdesk UI now have a dedicated section in the Ticket and Contacts page sidebar for easy access.
- Local testing is now built-in to the CLI, eliminating the need for a separate browser plugin.
- App locations can now be configured in the manifest file rather than having to specify them in multiple locations.
- Features need not be specified in the manifest file, they are automatically inferred.
- File format of configuration files (manifest, iparam, oauth config) has been changed from YAML to JSON making them easier to use.
- There is no need to manually install dependencies before testing a serverless app, they are automatically installed.