Use app lifecycle methods

App lifecycle events are events that mark the state changes of your app - such as,

  • Being initialized for the first time
  • Being activated
  • Being deactivated

App lifecycle methods are the methods that the Freshworks developer platform provides, to enable the app to react to the lifecycle events and accordingly refresh its app data.

The Freshsales Suite web interface is built as a single-page application. Unlike a traditional web application, a single-page app does not reload the entire page when there is a context change; it modifies only the relevant sections and passes a client object (that contains product context as well) to your app. For example, if you are on a contact page and you navigate to a new contact, only certain sections of the page are reloaded. If your app is in the reloaded section, the parent application initializes your app and passes the client object to your app. Your front-end app communicates with the parent app (the product on which the app is deployed) by using the client reference.

To enable your app to react to lifecycle events, in the app.js file,

  1. Subscribe to the app.initialized event. When the app is successfully initialized, the parent application passes a client reference to the app.
  2. After app initialization, to enable your app to react to app activation,
    1. Use the client reference, subscribe to the app.activated event, and register a callback method to be executed when the event occurs.
    2. Define the callback method.
  3. After app initialization, to enable your app to react to app deactivation,
    1. Use the client reference, subscribe to the app.deactivated event, and register a callback method to be executed when the event occurs.
    2. Define the callback method.

Subscribe to app.initialized

Use the sample code shown on the right pane, to listen to the app.initialized event.

App initialization occurs when the page that contains your app is loaded for the first time.

If app initialization is successful, the parent application (the product on which the app is deployed) passes a client reference to the app. You can use the client reference to,

  • Include the app.activated and app.deactivated listeners in your app code.
  • Include any front-end methods (data methods, events methods, and interface methods) to your app code. Front-end methods help in communication between your app and the parent app.

Unless you are building an app that is completely isolated (independent of the data on the page), ensure that the core logic of the app is not placed within the app.initialized() method. Place the logic within the app.activated() method.

The client (client.context) object returned on app initialization, contains the productContext object that specifies the name of the product and URL of the business account on which the app is being installed. You can use the client.context.productContext.name and client.context.productContext.url attributes to perform product specific actions such as rendering a product specific installation page.

Sample productContext
productContext:{
  url:"https://sample.myfreshworks.com/crm",
  name:"freshworks_crm"
}

Use app.activated

The app.activated event occurs based on certain actions on the Freshsales Suite UI that activate the app.

App locationWhen does the event occur?
Contact Details page, Deal Details page, Sales Account Details pageWhen you click the app icon for the first time to display the app (apps in these locations are in a minimized state when the page is loaded).

To subscribe to the event, register the callback method, and define the callback method, use the sample code on the right pane.

Use app.deactivated

The app.deactivated event occurs when the app goes out of scope, that is, when the app is closed and the app user navigates to another page of the parent application.

You can use app.deactivated to clean stale data, whenever your app is not in scope.

To subscribe to the event, register the callback method, and define the callback method, use the sample code on the right pane.