App extensions overview
What are app extensions?
App extensions allow apps to add interactive features that extend their app’s functionality in Pipedrive’s user interface. The extensions can help users to keep an eye on all of their everyday processes, share context about deals and contacts, and, above all, interact with different data provided by apps without switching between different tools.
Across Pipedrive’s UI, there are different extension points where apps can add interactive features, for example, sidebar panels, modals, actions menu and app settings.
Apps with app extensions bring extra value to their users as your app’s functionality is available directly inside Pipedrive’s UI, which helps to increase its visibility. App extensions increase the app's brand awareness as the app icon will be displayed inside Pipedrive after installation.
Furthermore, your app will have more visibility in the Pipedrive Marketplace as it will be labeled with "Interactive features" filtering option, allowing it to be highlighted in the chosen app categories’ sections.
Types of app extensions
We offer several app types extensions: app actions, JSON panels, custom UI extensions and manifest-based app extensions.
App actions
App actions let users perform your app’s related actions in Pipedrive’s list and detail views. We have two types of app actions: links and JSON modals.
Links
Links are app actions that reroute users from Pipedrive to an external page hosted by your app to complete an action.
JSON modals
JSON modals are modals with predefined components that enable users to complete full actions inside Pipedrive, with the data being consistent between both platforms.
JSON panels
JSON panels allow users to see and use the data from your app through a panel with predefined components in Pipedrive’s detail views. They provide a visual representation of existing data from your app inside the Pipedrive web app.
Having your app's data inside the panel with multiple customization methods will make using Pipedrive more contextual, as all information is centralized and easily accessible across different tools.
Custom UI extensions
Custom UI extensions allow an app to extend its functionality by loading any contextual web content in an embedded iframe directly inside different Pipedrive views. It is mandatory to use our SDK for all custom UI extensions.
We have four types of custom UI extensions: custom floating window, custom panels, custom modals and custom UI for app settings.
Custom floating window
A custom floating window is an iframe embedded inside a resizable and draggable window that persists while a user navigates around Pipedrive.
Custom panels
A custom panel is an iframe embedded inside a sidebar panel in the detail view of deals, people, and organizations.
Custom modals
A custom modal is an iframe embedded in a modal that opens when triggered by the user from various menus and links inside Pipedrive.
Custom UI for app settings
Custom UI for app settings is a fully customizable iframe surface within the Pipedrive Settings area. The surface can be found when users click on the Settings icon for your app in Tools and apps > Marketplace apps.
Manifest-based app extensions
Manifest-based app extensions allow an app to create an even tighter data flow with Pipedrive users. These apps can embed themselves into a designated area inside the Pipedrive product and offer alternative sources to complete an action such as messaging and video calling.
We offer two types of manifest-based extensions: video calling app extension and messaging app extension.
Video calling app extension
The video calling app extension is an entry point into Pipedrive’s Activities modal. It enables app users to generate and start a video call when setting up an Activity.
Messaging app extension
The messaging app extension is an entry point into the Messaging inbox inside Pipedrive’s Leads Inbox. This allows apps to integrate a messaging service directly into Pipedrive and create a seamless flow of receiving and sending messages through a third-party tool.
App extensions comparison
JSON extensions | Custom UI extensions | Manifest-based extensions | |
---|---|---|---|
What is it | Enables users to see structured data from your app and complete simpler actions inside Pipedrive through a panel or modal with predefined components
| Freedom to show data in any format and provide custom/complex interactions that are accessible within different embedded iframes across Pipedrive’s UI
| Offering of alternative entry points related to video calling or messaging in Pipedrive
|
Type of extension | JSON schema
| Iframe
| Manifest
|
Locations | Detail views (Deals, Persons, Organizations)
List views (Deals, Persons, Organizations, Activities)
| Detail views (Deals, Persons, Organizations)
List views (Deals, Persons, Organizations, Activities)
App settings (in “Tools and apps -> Marketplace apps” section of Pipedrive’s UI)
| Activities modal in deal and lead detail views
Messaging inbox inside Leads inbox
|
Security (for outgoing requests) | JSON panels
JSON modals | JWT | Authentication header that uses the same client_id and the client_secret as the OAuth token exchange in OAuth authorization. |
SDK | No | Yes | No |
Updated 9 months ago