Custom Opportunity Actions Connector

1. Feature Overview

The Custom Opportunities Actions connector allows you to create and add custom actions (actions apart from the default ones provided by LeadSquared) on a single opportunity or on multiple opportunities. It allows you to extend LeadSquared’s featured actions to support a variety of use-cases, such as –

• Add an action to call on a number stored in a custom field (For e.g., “Call Parent” where parent’s number is stored in a custom field)
• Add an action to send all the phone numbers of the opportunities in a list to a call center application for automated calling.
• Add an action to trigger a data post on a custom Webhook.
• Add an action to send a custom notification to opportunity owner.
• Show all support tickets stored in external systems (like Zendesk, FreshDesk and so on) associated with the opportunity and display it as a separate window or pop-up.

2. Prerequisites

• You must be the administrator of your LeadSquared account.
• The opportunities feature must be enabled on your account. To enable it, please write to support@leadsquared.com.

3. How it Works

The connector enables you to create a custom action using a callback URL with mailmerge parameters (such as @{Opportunity:Status, }, @{Opportunity:Owner, }, etc.). You can also configure Iframe attributes to define how your action will be displayed on the Manage Opportunity and Opportunity Details page. You can use this to create single as well as bulk actions. To use the Custom Opportunity Actions connector on your account –

• Install the connector
• Configure the connector
• Use the new custom action

4. Install the Connector

To install the Custom Opportunities Action Connector on your account –

1. From the main menu, navigate to Apps>Apps Marketplace.
2. In the search box, type “Custom Opportunity Actions”, and click the icon.
   • Alternatively, from the left panel, click UI Customization. The Custom Opportunity Actions connector is listed on this page as well.
3. On the Custom Opportunity Actions connector, click Install.

5. Configure the Connector

You must configure the connector to add custom actions. To do this –

1. Once the Custom Opportunity Actions connector is installed, hover your cursor over the icon, and click Configure.
2. On the Configure Custom Opportunity Actions pop-up, select the area you want the action to appear from the left panel – Opportunity Grid Row Action or Opportunity Grid Bulk Action.
3. Click Add Action.

Enter the details of the custom action.

Attribute	Description
Action Label	The display name of the action. This attribute is mandatory.
Opportunity Type	The opportunity type for which you want this action to appear.
Action Type	Three action types are available – Show as Popup Call an API Open in New Window
Show Tab In	To make the tab visible on your Web App and/or Mobile App, click the  checkbox.
Callback URL	Enter the HTTPs URL which will be rendered as a custom action. The URL should be of an action that accepts LeadSquared mail merge fields as parameters and passes them to an external application (e.g., a support system, another CRM or marketing system, another LeadSquared account, etc.) to get the data. Click the question markicon to view the available mail merge fields. This attribute is mandatory.
Iframe Attributes	Pass Iframe attributes you want to render on the pop-up. Applicable only for the Show as Popup action type.
HTTP Method	GET and POST methods are supported.
Content-Type	application/json is the only supported content type.
Data	You can pass any data here in the JSON format.

Once you’re done, scroll to the bottom and click Save.

Notes:

• To delete an existing custom action, click the icon against the action’s name.
• To edit an existing custom action, on the Configure Custom Opportunity Actions pop-up, click the icon and makes changes, and click then Save.

6. Use the Custom Row Action

To view the custom row action –

1. From the LeadSquared main menu, navigate to Leads>Manage Opportunities>Opportunity Type.
2. Against an existing opportunity, hover your cursor over the icon, and select the custom action from the dropdown list.

7. Use the Custom Bulk Action

To view the custom bulk action –

1. From the LeadSquared main menu, navigate to Leads>Manage Opportunities>Opportunity Type.
2. Select the opportunities you want to view the bulk action for, by clicking the checkbox.
3. Hover your cursor over the button, and select the custom action from the dropdown list.

Note: It will take up to 30 minutes for the custom action to appear on the Manage Opportunities page.

Any Questions?

Did you find this article helpful? Please let us know any feedback you may have in the comments section below. We’d love to hear from you and help you out!