Sangoma CX Salesforce Connector User Guide
- Alfredo Gonzalez (Deactivated)
- Bob Young
What is the Sangoma CX Salesforce Connector
A new small form factor Agent Panel integrated with Salesforce that enables the following features and automation:
Agent Panel and Salesforce are displayed simultaneously in the same Chrome tab.
Searches and populates Salesforce stored contacts based on Caller ID in inbound and outbound calls.
Call activity created in the contact is populated when handling inbound and outbound calls. The data stored is the Agent that managed the call, From, To, Call Duration, Call Direction ( inbound or outbound), Call Recording URL (if call recordings is enabled in the queue)
Click to Dial on any Salesforce field tagged as a phone number.
Prerequisites
Works with all Sangoma CX offerings.
Agents must use a Google Chrome or Microsoft Edge web browser.
Considerations
This connector only works with Salesforce lightning applications.
It only works with extensions associated with the embedded Web phone app (WebRTC). SIP phones or Bridge PSTN extensions are not supported.
It can only dial and search USA and Canadian phone numbers.
Ensure no other Click to Dial or Click to Call Chrome extensions are enabled on the browser used. These extensions may conflict with each other, resulting in unexpected behavior.
Login Process
If the Sangoma CX Salesforce Connector is enabled by the Salesforce Administrator:
Log into Salesforce. You will see a CCaaS button with a handset icon in the bottom left corner. Please note that the Salesforce Administrator can change the icon, name and position of this button.
Click on the button. This will display the Sangoma CX embedded Agent Panel. Log in using your Sangoma CX credentials.
If this is your first time logging into the platform, you did not request to remember the extension on future logins, or the remembered extension is no longer available for this agent, you will be requested to select an available extension. Select an extension. If you want the interface to automatically use the selected extension in future logins, select the option “Remember the extension on future logins”.
The Chrome or Edge browser may ask to grant the web application to use the microphone and speakers. Accept this request and memorize the setting to avoid getting this message every time the extension is selected or connected. Once logged in, you will see the embedded Agent Panel home screen. You can minimize or detach this Agent Panel using the two buttons available in the upper right corner of the modal window.
For a detailed explanation of the Agent Panel, go to the “The Embedded Agent Panel” section.
Receiving Calls
When receiving a call, the embedded Agent Panel will open, showing the call with the options to answer or reject the call, as shown below:
If the phone number is registered with Salesforce, it will automatically open the contacts screen in Salesforce.
The embedded Agent Panel will also record an activity with the call details in the contact. These records are available in the Salesforce Activity tab on the screen's right side.
If you want to see the call details within Salesforce, click on the registered call under Past Activities. The following Salesforce page will open.
Outbound Calls
On the Salesforce toolbar, you can click on the Contacts option to see the registered contacts. To call any of them, click on the registered number.
The embedded Agent Panel will initiate the call. At the same time, the contact information will be presented in Salesforce. When the call is completed, a call activity will be created in the contact.
If you want to call a phone number that is not stored in Salesforce, open the embedded Agent Panel, click the Dialpad icon, type the number, and click on the green handset button.
When you end the call, you can redial, report a technical problem with the call, and select a call reason.
The Embedded Agent Panel
This is a small form factor Agent Panel UI designed to be integrated into multiple applications. It has most of the features available on the full-size agent panel. The features not supported by the embedded Agent Panel are:
Only works with extensions associated with the embedded Web phone app (WebRTC). SIP phones or Bridge PSTN extensions are not supported.
Add or modify contacts stored in the Sangoma CX platform.
Report agent mood.
If using IVR Builder to attach data to the call on inbound calls, this data won’t be presented in this application.
The User Interface
On the Embedded Agent Panel main screen, you have an overview of all features and information in the queue:
# | Description | Screen |
|---|---|---|
1 | Menu : In the menu, you will find the following options:
|  |
2 | Home Icon: Click the Home Icon to return to the Agent Panel home screen. |  |
3 | Contacts Icon: The Contact icon provides the ability to search and dial contacts stored in the Sangoma CX platform. |  |
4 | Pause Icon: Click the Pause Icon to go into pause mode, choosing the pause reason. If on pause this option will unpause making you available to handle calls. |  |
5 | Queue Statistics: A - Call with the longest waiting time in the queue. B - Number of calls in the queue. C - Number of calls in progress in the queue. D - Number of free agents in the queue. E - Number of agents in non-productive Pause in queue. F - Number of agents on productive Pause in the queue. G - Displays the list of queues assigned to the agent. From the list an agent can select a queue to be viewed. |  |
6 | Dialpad: Display the Agent Panel Dialpad to make outbound calls. |  |
7 | Timeline: The Timeline displays the events that occurred during the day for the Agent. Type of events include:
The Timeline also allows to
|  |
8 | Pause: Puts the agent in Pause mode.
The amount of time the agent is on pause will be counted on the screen timer and will be reset when the pause ends or the pause reason is changed. |  |
9 | Logout: Click to log out of the Sangoma CX platform. This action will also log the agent out from queues. |  |
Embedded Agent Panel Settings
Embedded Agent Panel configuration options are available under Menu > Settings. The available settings are:
1 - Agent Name 2 - Extension currently being used. Clicking on the lock will remember or forget the extension on future logins. 3 - Hyperlink to change the password. When clicked the password change page will open in a new browser tab. 4 - Just informative, indicating is an active agent. 5 - Queue alarm is used to better control the number of simultaneous calls in the queue. When the number of calls reaches the set value, an alarm will sound. 6 - Sets screen notifications for calls, which toggles on and off. When notifications are on, a message displays to inform the Agent. 7 - The auto-hold option when turned on will place the current call on hold when entering a second call. |  |
8 - Auto-answer: if enabled the application will pick up the call automatically. Increases agent performance and speed of answer. 9 - Changes microphone selection. 10 -Changes headset selection. 11 - Allows the ability to select the outbound queue. 12 - Select screen as favorite / home (only Dashboard available at this time). |  |
How to Pause
To request a pause:
Click on the Pause icon to open the Pause Screen.
Click on the pause button.
Select the Pause reason.
The button will toggle to unpause and the pause timer will start.
To change to another pause reason without unpause:
Click on the Pause reason on top of the timer.
Select a new Pause reason.
The timer will reset.
To unpause:
Click on the unpause button.
Pauses with a Time Limit:
Pauses can be configured with a time limit. When the timer reaches 90% it changes color to orange and when it goes over the time limit it changes to red indicating that the pause has exceeded the time limit.
 |  |  |
Selecting Call Reasons
Call reason selection can be done in two different screens base on when the selection is taking place.
During the call
The screen populated when a call is picked up, includes a section that allows agents to select a call reason before the call is terminated.
When the call finishes
The Timeline screen is populated with the call details. On this screen the agent will be able to: redial, report a technical problem with the call and select a call reason.
