On a page of the Freshsales user interface, there are various locations where an app can be rendered. This section specifies the locations and how to configure the manifest.json file, for an app to be displayed in the specified location. An app can be rendered in multiple locations.

Note: Freshsales apps are supported as web apps.

Global Navigation Pane

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

manifest.json

1
2
3
4
5
6
7
8
9
10
"product": {
    "freshsales": {
      "location": {
        "full_page_app": {
          "url": "myfirstapp.html",
          "icon": "logo.svg"
        }
      }
    }
  }

Notes:
1. For a Freshsales account, a maximum of 10 full page apps can be installed and they are displayed as a menu on the left navigation pane.
2. The logo.svg file should have a resolution of 64 x 64 pixels and fill value set to FFF.
3. Testing a full-page app locally is not supported. To test a full-page app, publish it as a custom app.

Lead Details Page

lead_entity_menu - The app is displayed in the Integration section on the Lead Details page.

1
2
3
4
5
6
7
8
9
10
"product": {
    "freshsales": {
      "location": {
        "lead_entity_menu": {
          "url": "myfirstapp.html",
          "icon": "logo.svg"
        }
      }
    }
  }

Contact Details Page

contact_entity_menu - The app is displayed in the Integration section on the Contact Details page.

1
2
3
4
5
6
7
8
9
10
"product": {
    "freshsales": {
      "location": {
        "contact_entity_menu": {
          "url": "myfirstapp.html",
          "icon": "logo.svg"
        }
      }
    }
  }

Deal Details Page

deal_entity_menu - The app is displayed in the Integration section on the Deal Details page.

1
2
3
4
5
6
7
8
9
10
"product": {
    "freshsales": {
      "location": {
        "deal_entity_menu": {
          "url": "myfirstapp.html",
          "icon": "logo.svg"
        }
      }
    }
  }

Sales Account Details Page

sales_account_entity_menu - The app is displayed in the Integration section on the Account Details page.

manifest.json

1
2
3
4
5
6
7
8
9
10
"product": {
    "freshsales": {
      "location": {
        "sales_account_entity_menu": {
          "url": "myfirstapp.html",
          "icon": "logo.svg"
        }
      }
    }
  }

CTI

left_nav_cti - The app runs in the background and is displayed at the bottom-left corner. The location is allocated for the Computer Telephony Integration (CTI)/phone app alone.

manifest.json

1
2
3
4
5
6
7
8
9
10
"product": {
    "freshsales": {
      "location": {
        "left_nav_cti": {
          "url": "myfirstapp.html",
          "icon": "logo.svg"
        }
      }
    }
  }

Note:
1. The logo.svg file should have a resolution of 20 x 20px.
2. Only one app can be active per app location. Also, using Freshcaller counts as using the CTI location.

Chat

left_nav_chat - The app runs in the background and is displayed at the bottom-left corner. The location is allocated for Chat app alone.

manifest.json

1
2
3
4
5
6
7
8
9
10
"product": {
    "freshsales": {
      "location": {
        "left_nav_chat": {
          "url": "myfirstapp.html",
          "icon": "logo.svg"
        }
      }
    }
  }

Note:
1. The logo.svg file should have a resolution of 20 x 20px.
2. Only one app can be active per app location. Also, using Freshchat counts as using the chat location.