Skip to content

Installation Instructions

Prerequisites

General Installation Steps

1. Install the Package

For on-premise or isolated app in cloud: 1. Add the package limepkg-softphone-connector as a dependency in your solution. 2. Build and deploy your solution.

2. Configure Lime CRM

Configure which limetypes to search for matches in Lime CRM.

3. Configure Your Softphone System

The integration works by configuring your softphone system to call a Lime CRM endpoint when an incoming call is answered:

Endpoint URL: 

https://<server_base_url>/<Lime_CRM_application_name>/limepkg-softphone-connector/open/{phone_number}

Replace: - <server_base_url> with your Lime CRM server URL - <Lime_CRM_application_name> with your application name - {phone_number} should remain as a placeholder that your softphone system will replace

Tip: You can find your complete URL in Lime Admin: 1. Go to Lime Admin 2. Navigate to Settings → Softphone Connector 3. Copy the URL shown there and use it in your softphone configuration

Softphone-Specific Configuration

Telavox

For detailed information, refer to the official Telavox Call Widget documentation: English | Swedish

Note: For this integration to work properly, you need to use the Telavox Desktop App so that Lime CRM can open in a new tab when answering a call.

  1. Log in to the Telavox Flow admin portal
  2. Create a New Call Widget according to the Telavox documentation above
  3. Configure the widget with the following settings:

General Settings: - Name: Lime CRM Integration (or your preferred name)

Advanced Settings: - Leave the default variable to check (no changes needed)

Header Settings (Important): - Action URL: Paste the URL you copied from Lime Admin → Settings → Softphone Connector - Replace the phone number part in the URL with {number} - this is Telavox's specific variable that will be replaced with the caller's phone number - Example: https://your-server.com/your-app/limepkg-softphone-connector/open/{number} - Auto-run URL: Set to OnAnswer - This ensures Lime CRM opens automatically in a new window when you answer a call, searches for the caller, and opens their card

  1. Save the widget
  2. Assign the widget to users or groups who need the integration

Other Softphone Systems

Configuration steps will vary by provider. The key requirement is that your softphone must be able to make an HTTP GET request to the Lime CRM endpoint when a call is answered, replacing the phone number placeholder in the URL.

This is a common feature among softphone providers, though it may have different names such as "Call Widget", "Screen Pop", "CRM Integration", or "Webhook". Each provider will have their own specific variable syntax for the phone number (e.g., {number}, {phoneNumber}, %NUMBER%, etc.).

If you need help configuring a specific softphone system, please contact your softphone provider's support. They will be able to guide you on how to set up URL triggers or webhooks in their system.