Prerequisites
Before starting the setup, make sure the following conditions are met:
- CallHippo and LeadSquared integration is active.
- You have admin-level access in both CallHippo and LeadSquared.
- The user who is configuring must have leadsquared and callhippo account with the same email Id.
- Required API access is enabled in the LeadSquared account.
- CallHippo agent numbers are properly assigned to users.
Configure Agent Profile in LeadSquared
First, go to Settings → My Profile in LeadSquared and click on the Edit button.
Add your CallHippo agent number in the Agent Phones field. The number must be entered in the following format: +<CountryCode>-<PhoneNumber>
Enable the “Show phone call popup” option and click Save.
This step ensures that LeadSquared can correctly identify the agent during incoming and outgoing calls.
Install Universal Telephony Connector
Navigate to Apps → Apps Marketplace in LeadSquared and install the Universal Telephony Connector.
Open Universal Telephony Connector Configuration
After installation, go to Settings → Configure under the Universal Telephony Connector. Clicking on Configure will open the connector setup popup.
Add CallHippo as a Telephony Connector
Click on Add Connector and select "LeadSquared Generic Telephony Connector from the connector" type in dropdown. And Set the connector name as CallHippo and save the configuration.
Add CallHippo Virtual Numbers
In the connector configuration, add all CallHippo virtual numbers in the Virtual Numbers section. Ensure the numbers are added in the following format: +<CountryCode>-<PhoneNumber>
These numbers are required for proper call routing and logging.
Configure Click-to-Call with CallHippo
Click-to-Call allows agents to make outgoing calls directly from LeadSquared. When an agent initiates a call from LeadSquared, CallHippo first places a call to the agent. Once the agent answers, the call is then connected to the lead.
Click-to-Call Setup
Go to CallHippo → Integrations and open the LeadSquared integration settings. Navigate to the Telephony tab and copy the Click-to-Call URL.
Now, return to LeadSquared and open Universal Telephony Connector → Configure. Paste the copied URL into the URL field and configure the following:
- HTTP Method: POST
- Request Type: JSON
- Response Keyword: test
- Response Type: JSON
Enter you email ID in Provider support email field and enable the configuration and click Save. Click-to-Call is now successfully enabled.
Passing Custom Parameters in Click-to-Call
CallHippo supports passing custom parameters through the Click-to-Call URL.
You can append custom parameters to the Click-to-Call URL in CallHippo before pasting it into LeadSquared. These parameters are passed along with the call request and will be available in:
- Call log activity created in LeadSquared
- Agent Popup shown to the agent during the call
This is useful for sending additional context such as campaign name, source, workflow identifier, or any custom reference required by your business process.
To know which custom parameters are supported click here.
Configure Calllog API
To log call activities from CallHippo into LeadSquared, copy the Call Log API from the Universal Telephony Connector and paste it into the LeadSquared integration settings in CallHippo.
Go to Universal Telephony Connector → Call Log API. Copy the call log API URL and paste it in Callhippo integration settings call log api field.
The Leadsquared generated Call log API will look something like this:
In the apikey parameter you need to enter your actual API key generated by leadsquared. To get this go this link.
After saving, return to LeadSquared and click the generated Call Log API link. Enable the Async API, copy the Async API key, and replace xxxxx in the Call Log API URL with this key in CallHippo. Save the configuration again.
Configure Agent Popup
Agent Popup allows agents to view and update lead details during incoming and outgoing calls.
LeadSquared Configuration
Go to Universal Telephony Connector → Agent Popup API. Copy the Agent Popup API URL, enable it, and click Save.
CallHippo Configuration
Go back to CallHippo → Integrations and open the LeadSquared integration settings. In Agent Pop-up section click Edit, paste the copied Agent Popup API URL, and click Save.
Agent Popup is now enabled.
Direction-Specific and Event-Based Agent Popup Triggers
CallHippo allows you to customize Agent Popup behavior based on call direction and call events.
This configuration is available under: CallHippo → Integrations → LeadSquared → Telephony Tab
From here, you can control when the Agent Popup appears based on:
- Call direction: Incoming calls, outgoing calls, or both
- Call event: Ringing, answered, or hangup
This flexibility allows you to fine-tune popup behavior according to your operational needs. For example, you can show the popup only when an incoming call is answered or suppress popups for outgoing calls until the call connects.
Enable CallHippo Dialer Inside LeadSquared
To use the CallHippo dialer directly within LeadSquared, first enable Softphone from LeadSquared Profile Settings.
Next, go to Universal Telephony Connector → Agent Popup API → Agent Panel Settings and configure the agent panel as follows:
- Panel URL: Get this link from callhippo Leadsquared integration settings.
- Panel Permissions: allow=geolocation;microphone;camera
- Panel Title: CallHippo
- Panel Height: 670
- Panel Width: 400
- Enable Agent Panel
- Enable Show on Top
Save the configuration. Once enabled, the CallHippo dialer will appear inside LeadSquared and can be expanded for making or receiving calls.
Note: Initially if the softphone fails to populate then just refresh the external window once then the dialer will get populated properly.
Enhanced Telephony Behavior Inside LeadSquared
With the embedded CallHippo dialer enabled, the following enhancements are available:
- The dialer automatically pops up on incoming calls without requiring manual interaction.
- Active calls remain connected even if the LeadSquared page is refreshed.
- Agents can continue calls seamlessly without call drops.
Click-to-Call and Agent Popup Usage
Agents can initiate calls from Dashboard → Leads → Manage Leads by clicking on the lead’s phone number.
The call first rings the agent in CallHippo, and once answered, it connects to the lead.
For incoming and outgoing calls, Agent Popup displays lead details and allows agents to update or save information directly during the call.
Note: To use Click-to-Call and Agent Popup functionality, the CallHippo browser extension must be disabled, as it can interfere with the embedded telephony setup.