Universal Telephony Connector

The Universal Telephony Connector (UTC) lets you integrate your cloud telephony service provider with LeadSquared. It is similar to the Generic Telephony Connector but has the following advantages –

  1. Integrate multiple instances/accounts of your telephony provider –
    If you have multiple contact centers in different regions (E.g., northern region, southern region, etc.), you can now configure each of them as separate tabs.
  2. Integrate multiple telephony providers –
    If you’re using more than one telephony service provider, you can now integrate all of them in one place.
  3. Assign to teams –
    Assign different instances of one telephony provider or even different providers to teams in your account. So you can now assign a northern region telephony instance to your northern region team. For more information on teams, see LeadSquared Teams.

Note: Your developer will need to understand the standard format of data to be posted into LeadSquared. Currently the following connectors can be configured inside the Universal Telephony Connector –

  • LeadSquared Generic Telephony Connector
  • Super Receptionist V2



Navigate to Apps>Apps Marketplace, search for the Universal Telephony Connector and click Install.

Installing the connector



  1. Next, hover the cursor over the settingsSettings iconicon and click Configure.
  2. Click the Add New Connector button.
  3. Enter a name for the new connector, then click Add.

configure UTC

Note: You can add a new connector, clone an existing connector or delete a connector using the options highlighted below.

Adding a new connector


Virtual Numbers

Use this section to add one or more virtual numbers for the connector you’re configuring. You can also tag them if you like. Click the Saveicon to save a virtual number and click Add to add another number.

configure virtual numbers


Call Route API

This feature enables automatic routing of calls from an existing lead to the respective Lead owner in LeadSquared automatically.

  1. Copy the Call Route API URL from Call Route API tab on the popup and deploy it in your cloud telephony account.
  2. Use HTTP GET to send the data. Please refer the ‘Usage’ section to understand how to send the data.

Call Route API section


Agent Popup API

You can enable real-time call notifications to users in the form of an Incoming Call Popup in the event of an inbound call from a lead (made to your virtual number). The pop-up displays the lead’s details if the lead exists in your account, or displays an empty form that agents can use to capture the new lead.


    • Incoming calls matching a lead’s secondary phone number will be tracked without creating a duplicate lead.
    • If you have multiple leads with the same phone number, you can pass the LeadId in the Agent Popup API. This will ensure that the correct lead details appear in the agent popup. For e.g., "LeadId": "4c70ce73-0732-4977-85a2-fb49a978b85c".

Agent Pop-Up API Details

  1. Copy the Agent Popup API URL from Agent popup tab and deploy it in your cloud telephony account.
  2. Use HTTP POST method to send the data to LeadSquared in JSON format.
  3. Enable Agent Popup by selecting the checkbox.

Refer to the ‘Usage’ section to understand how to send the data.

LeadSquared Telephony

Custom Mapping
Telephony providers send us varying data using the Agent pop-up API. Enable custom mapping to map the variables received in the JSON file to the corresponding LeadSquared parameters.

Note: SourceNumber denotes the phone number of the caller, DestinationNumber denotes the phone number of the receiver, DisplayNumber represents the DID or virtual number, ivr denotes the IVR path entered by the caller.

LeadSquared Telephony

Agent Panel Settings
The agent panel enables you to embed a softphone and manage your call center actions directly from your LeadSquared account. Add a custom URL and append mail merge parameters (click the help help icon) to configure the agent panel.

LeadSquared Telephony

Show on TopDisplays the agent panel over any overlapping window (including the agent pop-up).
Hide Scale ButtonHides the maximize/minimize buttons on the panel.
Panel URLThe source iFrame URL for the panel. Click the help help icon to learn how to append mail merge parameters.
Panel PermissionsConfigure iFrame permissions like microphone, camera, geolocation, etc.
Panel TitleCustomize the display text on the panel title bar.
Panel HeightAdjust the default height of the panel (in pixels).
Panel WidthAdjust the default width of the panel (in pixels).


Call Log API

All inbound and outbound calls made through your Telephony account can be logged in LeadSquared by setting up Call Logs.These logs will be posted to LeadSquared after both incoming and outgoing calls. This ensures that each phone interaction gets logged.

Note: When your Telephony provider calls the LeadSquared API, data can be pushed into LeadSquared using POST method in JSON format.

Logging Calls

Once you’ve finished the configurations, you can check your telephony logs by navigating to My Account>Settings>API and Webhooks>Telephony Logs.

Here are the parameters you can post –





"StartTime":"2015-08-20 18:26:38",

"EndTime":"2015-08-20 18:26:38",



"CallNotes":"Enquired about product",









 PropertySample ValueDescriptionMandatory
 SourceNumber+919611795983For Inbound Call-  Lead’s contact  number
For Outbound Call-  Caller’s Number or  Agent’s number
DestinationNumber+919611795980For Inbound Call-  Caller’s Number or  Agent’s number
For outbound Call-  Lead’s contact  number
DisplayNumber+919020897874Virtual(DID) Number provided by the providerYes
StartTime2015-08-20 18:26:38Start time of the callYes
EndTime2015-08-20 18:26:50End time of the callYes
CallDuration12Duration of call in secondsYes
StatusAnsweredStatus of the call, can be Answered, Missed, VoicemailYes
CallNotesEnquired about a productAdditional notes about the callNo
ResourceURLServer/filename.extensionURL of the file with a recording of the conversationNo
DirectionInboundInbound or OutboundYes
CallSessionId080673309211440075398Call Unique IdentifierNo
CallerNameRamCaller’s NameNo
CallerCityBangaloreCaller’s CityNo
CallerStateKarnatakaCaller’s StateNo
CallerCountryIndiaCaller’s CountryNo
CallerZipCode5600102Caller’s zip codeNo


Click 2 Call API

The Click2Call feature enables your sales reps/agents to place an outbound phone call just by clicking the lead’s phone number (on the Manage Leads or Lead Details pages). If you use the Opportunities feature, click 2 call can be used to call leads from the Opportunity Management and Opportunity Details pages as well.

Depending on the capabilities of your telephony provider, it can be configured using either a server-side API or a client-side script.

Server-side API

This is the default configuration option.

Your telephony provider’s Click2Call API is configured here, and you can append mail-merge parameters (like agent phone number, lead phone number, etc.) to the API URL to facilitate the calling functionality.

  1. Pass the Click2Call API in the URL textbox.
  2. You may optionally pass custom headers to the API for authentication.
  3. Select the HTTP method needed by the telephony operators Click2Call API.
  4. Map a keyword from the response of the Click2Call API. Typically we use a keyword like “success”. This lets our system know that the API request fired correctly and a response was received.
  5. Click the Enable Checkbox checkbox.

LeadSquared Telephony Integration

Client-side Script

For telephony providers with JavaScript SDKs, the Click2Call functionality can be configured using a client-side script. The outbound phone call functionality will be handled by the script and the call will be initiated via the browser to the telephony provider.

  1. Enter the URL of the Javascript file, which must be hosted on the LeadSquared domain (external domains are not supported). The JS file will be published only after an internal review process.
  2. You can pass data to the script using mail-merge parameters (like agent phone number, lead phone number, etc.).

LeadSquared Telephony Integration


  • For a sample JS file template, please reach out to your account manager
  • Additionally, a flag called Is Softphone Enabled must be checked for each agent, in the user settings UI. This also disables the “Agent Panel” for the agents.

LeadSquared User Settings


Call Disposition

Call disposition lets users enter certain information related to a phone call once it ends.

Note: To use this feature, you must first create a Custom dropdown lead field in LeadSquared (say ‘Disposition’) with Call disposition options/values (for example, ‘Issue Resolved’, ‘Forward to Billing’, ‘Forward to Tech. Support’, etc.). Ensure that the values you create are the same as those in your telephony account.
For more information, see How to Create Custom Lead Fields.

When a call has ended the agent can select an appropriate disposition value on the Call/Agent-Notification Popup, dispose the call and get ready to receive the next upcoming call.

  1. Deploy the URL provided by your telephony service in URL field with necessary parameters.
  2. Select the HTTP method in which your telephony service accepts the data.
  3. Select the ‘Disposition’ field created earlier to capture ‘Disposition’ value.
  4. You can initiate the following actions (and make them mandatory if required) once a call is disposed –
    • Create a task
    • Create a custom activity
    • Update a lead field

LeadSquared Telephony Integrations


Single Sign-on API

This API will help you embed LeadSquared within your telephony application. Use the API and the HTTP POST method to send data to LeadSquared in JSON format. To get the leads details, use the Lead Details API.

Please refer to the ‘Usage’ section to understand how to send the data.

Single Sign on


Team Assignment

You can assign a connector to one or more teams. While making an outbound phone call (using click2 call), the users in those teams will see the connector(s) assigned to them and can choose to place the calls from any of the virtual numbers created for a connector.

So for example, if you have one 2 connector tabs, say ‘Bangalore’ and ‘Chennai’, you can assign the tabs to your Bangalore and Chennai teams respectively. Your Bangalore team will then only see the virtual numbers associated with your Banglaore connector tab.

utc assignment

Note: If you haven’t assigned any of the connector tabs to any teams, while making outbound phone calls your users will see the virtual numbers that are configured in the default connector tab (the one marked with the tick). You set a tab as default by navigating to that tab and clicking Default under the Settings Settings icon icon –

Set as default


Integrate with Opportunities

You can integrate the Universal Telephony Connector (UTC) connector with LeadSquared Opportunities. To know how to do this, please refer to Opportunity Integrations in Telephony.

This will enable you to track phone call interactions with your leads, for each opportunity or potential deal. Completed calls will get posted as activities, against the respective opportunities, on the Opportunity Details 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!

Was this Helpful?

Notify of
Inline Feedbacks
View all comments