Include placeholders for app deployment

On the product UI, an app can be rendered in any of the locations that the module supports. This module supports rendering an app in common placeholders and module-specific placeholders.

To render an app in the common placeholder, in manifest.json > modules.common.location.<placeholder-name>, you can specify the placeholder in the product’s left-navigation pane where the app is eventually rendered.

To render an app in a module-specific placeholder, in manifest.json > modules.deal.location.<placeholder-name>, you can specify the placeholder on a page where the app is eventually rendered.

Notes:
  • You can specify multiple placeholders in manifest.json > modules.
  • Freshworks product apps are supported only as web apps (and not as mobile apps).

This section provides information on all locations (and the placeholders in these locations) where an app can be rendered for the deal module.

Common placeholders

full_page_app

The app icon is displayed on the left navigation pane and when clicked, the app page occupies the entire viewport.

Image of full page app in Freshsales SuiteApp rendered at full_page_app placeholder

left_nav_cti

The app runs in the background and the app icon is displayed at the bottom-left corner. This placeholder supports an app that uses the Computer Telephony Integration (CTI) technology.

Notes:
  • Ensure that the app icon's resolution is 20 x 20 pixels.
  • This placeholder can display only one CTI app at a time. Freshcaller is also considered as a messaging app.

left_nav_chat

The app runs in the background and the app icon is displayed at the bottom-left corner. This placeholder supports messaging apps only.

Image of app in account details sectionApp rendered at left_nav_chat placeholder

Freshsales Suite - Deal details page

deal_entity_menu

The app is displayed in the Deal details section of the deal details page.

Image of app in the deal details sectionApp rendered at deal_entity_menu placeholder in the Deal details page

deal_quick_actions

The app icon is displayed as an option in the more options menu of the deal details page.

Image of app in the deal details sectionApp rendered at deal_quick_actions placeholder in the Deal details page