Sangoma CX Mobile Agent App. User Guide

What is the Sangoma CX Mobile Agent App

The Sangoma CX Mobile Agent App provides a Sangoma CX agent the ability to manage inbound and outbound Sangoma CX calls using an iPhone or Android smartphone.

Prerequisites

  • Works with our Sangoma CX products

  • You need to have:

    • Sangoma CX Tenant URL (See the installation procedures below for more details)

    • Sangoma CX Login and Password

    • Pool of device related extensions (SIP Extensions) that are configured in Sangoma CX

    • Sangoma Talk extension

    • IPhone or Android Smartphone

Considerations

  • The Sangoma CX Mobile Agent App is an extension of the Sangoma Talk app

  • The Sangoma CX Mobile Agent App is limited to the following Agent Panel features:

    • Device related extension (SIP Extensions)

    • Display the list of queues the agent is assigned to, with the following metrics:

      • Calls in queue

      • Calls in progress

    • The selected outbound queue

    • Pause Mode: Get in or out of productive or unproductive pauses

    • View only Sangoma CX contacts with click to dial on the contact phone number

    • Call Controls:

      • Pick up inbound calls

      • Dial outbound calls

      • Phone Keypad

      • Mute Microphone

      • Hold Calls

      • Attended and unattended call transfers

      • Conference Calls

      • Hangup call (on queues enforcing post call survey, calls will be transferred to a survey)

  • A User can only be logged to one application simultaneously: Web Agent Panel in a Chrome / Edge browser or Mobile Agent App in a supported smartphone

  • Unstable or low capacity wireless Internet connection may lead to poor audio quality, call drops or application disconnection.

How to Install the Mobile Agent App

To install the Mobile Agent App:

  • Open Google Play App Store or Apple App Store

  • Search for “Sangoma Talk”. Click on the application with the following logos published by Sangoma Technologies

  • Install the App.

Google Play App Store

Apple App Store

Login in the app

Once the installation is complete the Sangoma Talk app should be available on your Smartphone.

  • Click on the Sangoma Talk icon to get started.

Note: The first time the app is launched you will be required to allow the application to access: your microphone, make and manage phone calls, and read contacts on your phone.

The Sangoma Talk login screen will appear.

  • Click on the label “ContactCenter Login

The Sangoma Connect screen will display

  • Enter the Agent’s Sangoma CX Username and Password

  • Enter the Sangoma CX’s tenant address.

    • The tenant address is the set of characters in your Agent Panel URL between the ’https://’ and the next slash ’/’..

    • Example: With the URL “https://productdemo.starcenter.com/monitor/agent/”, the Sangoma CX Tenant Address would be: productdemo.starcenter.com

  • Click the Login button

Note: The Username and Tenant information will be memorized in the device and will automatically populate these fields on future logins.

The first time an agent logs in or if the extension selected the last time is no longer available, a screen will appear with a list of available extensions.

  • Select an extension

  • Click “Login to Contact Center

Main Sangoma CX Screen

After the user logs in, the main Sangoma CX screen is displayed, making the user available to receive or make calls. In this section we will explain the Main Sangoma CX screen and it’s capabilities. This screen provides information to the agent about the queues they are assigned, the status of these queues, select outbound queues and access to other features and options related to the contact center.

 

Screen Header

A - Selected extension used by the Agent Mobile App

B - Menu that contains these features:

  • Pause: Opens the pause screen to start and stop a pause. The pauses available, type and behavior, are the ones configured in the queues the agent is assigned to.

  • Logout: Logs out the agent from the queues and extension. The application is always open in the background but can be terminated using iOS or Android application management features or gestures.

C - Keypad:

  • Displays a keypad which can be used for making outbound calls, making attended/unattended call transfers or conferencing calls.

D - Contact List:

  • Displays the list of contacts stored in the Sangoma CX tenant. Contacts can be opened to display the contact details: phone numbers or email addresses.

  • From a Contact you can make outbound calls, attended/unattended call transfers or conferencing calls.

  • Calling contacts can be done by clicking the phone icon if the contact is not opened or clicking in a phone number entry if contact is open.

E - Headphone:

  • Displays the Main Sangoma CX Screen

Screen Body

1 - Agent Name and time logged

2 - Outbound queue selected and selector. The outbound queue selected is also highlighted under the List of Queues the Agent is assigned to with an arrow.

3 - List of Queues assigned to the Agent. The information provided includes:

  • Queue Name: If the queue is an outbound queue, it is tagged with an arrow

  • Calls in queue: Column with a clock as a header, displays the number of calls in the queue

  • Calls in progress: Column with a handset as a header, displays the number of calls in progress within the queue

4. Selected Queue

  • The queue you are currently in is highlighted.

5. Menu that contains the options:

  • Refresh: The information presented on this screen is not automatically refreshed. If a user wants to update the queue status information they will have to select this option.

  • Settings: the settings available under this menu entry are:

    • Account Setup:

      • SIP account used (view only)

      • Sangoma support link

      • Sangoma Softphones EULA link

    • Preferences: allows changing multiple settings such as ringtone and volume

    • About: version installed and mobile platform

    • Usage: provides statistics about the softphone talktimes and call counts.

    • Share with friends:

      • Share on Facebook and by email

      • Write a review

    • Reset Application: Clears all data including provisioning, theme, preferences and history.

    • Reprovision: refresh the configuration provided by the back-end servers. Reprovision will force extension re-registration. Use this function if the extension is blinking in red or the App is not registering the extension for a long period of time.

Screens Icons:

 

Phone Keypad:

Displays a keypad that allows making outbound calls. This keypad will also be used when making attended/unattended transfers and conferencing calls.

  • Outbound calls can be done by pressing the numbers in the keypad and clicking the green button with a handset icon to initiate the dialing.

 

Contact List:

Displays the list of contacts stored in the Sangoma CX tenant. Contacts can be opened to check the contact details: phone numbers or email addresses.

  •  Outbound calls using contacts can be done by clicking the phone icon, if the contact is not opened or clicking the phone number if contact is open.

  • This screen can also be invoked to use contacts for attended/unattended transfers and conferencing calls.

 

Headphone:

Displays the Main Sangoma CX Screen

Handling Calls

Making Outbound Calls

Outbound calls can be done using either the Keypad or Contact List as explained above.

Receiving Calls

When a queued call is assigned to the agent, a screen accompanied with an audio ring will be presented, The screen will provide information about the caller (phone number and the contact name if stored in the contact list) and the Answer, Ignore and Reject buttons.

Call Controls and Options

Once a call is established the following screen is presented. The following options are available.

Home

  • Displays the Main Sangoma CX Screen with a green ribbon to indicate a call is in progress.

  • To return to the call, click on the green ribbon representing the current in process call.

Mute Microphone:

  • Mute or unmute the microphone

Speaker Volume:

  • Controls the speaker volume.

Keypad:

  • Opens keypad to just send DTMF

Hold:

  • Places the call on hold. Caller will hear either the holding announcement or music

Transfer:

  • Transfer the call to an extension that doesn’t belong to a Sangoma CX Agent. See below for more details.

Add Call:

  • Creates a Conference Call

Att. Transfer:

  • Transfers the call to a different Agent

End Call:

  • Ends the call (if the call was from within a queue will be transferred to a survey)

Transfer Calls

Transferring a call to an extension that doesn’t belong to a Sangoma CX Agent.

Click on the Transfer icon

Note: The application will display the previous screen you were prior to joining the current call. From that screen you can click the Keypad or Contact List icon.

As Stated above the application will display the screen just before joining the call.

  • Click on the Phone Keypad.

  • Dial the number you want to transfer the call to. Please note, unattended transfers can only be done to Sangoma CX queues or agents. If you need to transfer the call to a UCaaS extension or external number use the Attended Transfer.

  • Click the green button with the handset icon to complete the transfer.

Note: If you want to transfer a call to an existing contact, click on the Contact List icon and select the contact you want to transfer the call to.

To return to the call, click on the green ribbon representing the current call in progress.

Once the transfer is complete a message will be displayed indicating the call was transferred and it is no longer in this application.

Add Call

Creating a Conference Call.

Click on the Add Call icon

Note: The application will display the previous screen you were in prior to joining the current call. From that screen you can click the Keypad or Contact List icon.

From the Keypad screen dial the number you want to conference in and click the green button with a handset icon.

Note: If you want to conference in a contact, click on the Contact List icon and select the contact.

 

To return to the call, click on the green ribbon representing the current call in progress.

The following screen will be displayed

Click the Join icon to continue with the conference call.

Click the Switch button to return to the call without conferencing in the 3rd Party.

You will continue in the call and the following screen will be presented. Click on End Call to terminate the call (terminates the call to all parties)

Att. Transfer

Transferring the call to a different Agent

Click on the Att. Transfer icon

The application will show the screen displayed just before getting the call. Click on the Phone Keypad if you are not on that screen. Dial the number you want to transfer the call to and click the green button with a handset icon to complete the attended transfer. Note: If you want to transfer a call to a contact, click on the Contact List icon and select the contact you want to transfer the call to.

 

To return to the call, click on the green ribbon representing the current inprocess call.

The following screen will be displayed. At this time only the destination number is connected while the original call is on hold waiting for the transfer to be completed. To finalize the transfer click on the green Transfer button.

A message will be displayed indicating the call was transferred and it is no longer in this application.

 

 

Working with Pause

 

Starting a pause:

  • Click menu in the header (B)

The menu is displayed

  • Select Pause

The pause screen will be displayed:

  • Select a reason for the pause

  • Click the Start button

The pause timer will start, indicating how long the agent has been in this pause.

Ending the Pause:

  • Click the stop button.

Changing Pause Reason:

To change to a different pause without making the agent available:

  • In the pause screen select another pause reason.

    • The timer will reset indicating a new pause started.

 

 

To change screen while in Pause:

  • Click on the Back arrow next to the pause label to display the Main Sangoma CX Screen

The Main Sangoma CX Screen is displayed with a gray box with the pause icon and pause reason label in purple indicating the agent is on pause

To return to the pause screen click on the gray box indicating the agent is on pause.

 

Return to Documentation Home I Return to Sangoma Support