Installation URLSalesforce install package link

https://login.salesforce.com/packaging/installPackage.apexp?p0=04tDn000000iUFo

Log in

The provided URL will ask you to log in to the desired sandbox/production environment.

...

Select the profiles that will be able to use the package.“Install for admins only option“

In order to install the package, “I acknowledge that I’m installing a Non-Salesforce Application that is not authorized for distribution as part of Salesforce’s AppExchange Partner Program.” must be checked due to this being a beta installation.Image Removed

...

After clicking the “Install” button When the installation is finished, you should see a screen similar to the image below

...

Verify installation

After installation, we can verify if it was successfully installed:

In the quick find box type ‘Installed’ and select ‘Installed Packages’ item

...

If the package is installed, you will see something similar to the image below

...

Post-installation steps

Add the phone to the utility bar of the desired App

In the quick find box input, type “App manager” and select “App manager” menu item

...

Click the arrow menu on the desired app to add the phone and click “edit”, app type must be Lightning.

In the App setting menu, select “Utility items”

...

Click “Add utility item” and then select “ucontactPhone”

...

Populate the utility item information, recommended width 400 and height 830

...

You will be able to see the phone in the selected app.

Add uContact instance on settings

Click on the App Launcher at the upper left corner and type “uContact Settings” and select the item from the menu

...

In the uContact Settings tab, there are 2 main functionalities divided into 2 tabs, the first one called settings will be used to configure the instance, there is a field in which the URL of the service will be stored. Every time the page it’s loaded, if there is already a setting created, the field will show the current URL, otherwise, it will be empty. From it, you can also edit to change the URL, and save it by clicking the button ‘Save’

...

Then, there is the second functionality called ‘Field Mapping’ where there are two picklists, one for Contact and one for Lead. On each of them, a list of their respective fields will be displayed, available for selection. Those fields will be used to match clients with records in Salesforce. For example: If ‘Phone’ is selected, under ‘Contact’, when a client calls, the number will be matched to the record that has the same number in the ‘Phone’ field in the Contacts.

...

When a field is selected, it will be displayed on the right column under ‘Selected’. Below each picklist, there is its respective save button, which will be used to store all the fields to match.

...

If you already have selected fields, they will be shown in their respective columns (available, selected) in the picklist when the page loads.

Add the “Call” button to Contact/Lead

In order to be able to start a call from a Contact or Lead page, the quick action “Call” must be added

1. From Setup click Object manager

2. Select Contact object

3. Select “Page Layouts” and select the desired layout

4. Select the “Mobile & Lightning Actions” item, and select the action with Name Contact.ucontact__Call (to display this information hover over the action name).

...

*To add the action, drag and drop on Salesforce Mobile and Lightning Experience Actions section.

...

Save

...

Configure uContact URL

Now we have to tell salesforce the address of our uContact instance. Search for the Net2phone settings on the apps menu.

...

Add users to the call center

After installation, we have to add the desired users to the salesforce call center.

Search on the setup, the option “Call Center”. Choose the uContact call center and add the users you want to use the plugin.

...

Allow access to non-system admin users

As we installed this plugin as an admin only, we have to grant non-admin users privileges to access the required components.

Go to the setup page, search “VisualForce Pages” > “uContact” and add the profile you want to grant access to.

...

After that, search on the setup page “Apex Classes” > “uContactPhone“ > “Security” and add the profile you want to grant access to.

...

Image Added

Now, the plugin is ready to be used. You only need to login with uContact account

...

Installation Troubleshooting

Lighting web security

Salesforce released a beta configuration that causes in some cases errors with the OpenAPI module in Salesforce. The image below shows how to disable the feature.

...

404 error

If you get a 404 error entering on the uphone ucontact URL, you must add manually the following rule on the nginx configuration file, located on /etc/nginx/sites-enabled/default

location /uphone {
  add_header Access-Control-Allow-Origin "*";
  add_header Access-Control-Allow-Headers "*";
  add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
  alias /etc/IntegraServer/web/uphone/;
  try_files $uri $uri/ /uphone/;
}

In case the phone does not connect (Not registered), check that the following location is in the default, if not add it:

location /IntegraWebsockets {
  add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
  proxy_pass http://localhost:8085;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_read_timeout 86400s;
  proxy_send_timeout 86400s;
}