Versions Compared

Version Old Version 60 New Version 61
Changes made by

Product Knowledge

Product Knowledge

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page

Table of Contents
minLevel1
maxLevel3
outlinefalse
stylenone
typelist
printablefalse

\uD83D\uDCCB What’s about

image-20240619-091053.png

The new XCALLY Mobile App allows Agents to manage Voice channels for inbound/outbound calls and Motion Bull campaigns (except with preview method) directly from the smartphone. With XCALLY Mobile agents are available anytime, anywhere.

The language of the App corresponds to the one set on the smartphone.

The app allows the agent to receive inbound calls even if app is in background → find out how to

(blue star) Requirements

Panel
bgColor#EAE6FF

GENERIC REQUIREMENTS

  • XCALLY App is available on Apple devices with iOS system and on Android devices

  • You need to create Mobile agents (typology available from version 3.33.0) and they must be enabled on queues and contacts lists to manage.
    Consider that Agent’s login expires after 24h and he needs to login again in the app

  • To use the App, you must enable on the license the option“Mobile Client” and have Mobile Agents

  • You need a valid HTTPS certificate

  • You need to install your own push gateway (with push gateway and stack sip on the same server through docker) by following this guide

Panel
bgColor#EAE6FF

REQUIREMENTS TO USE APP FOR iOS

  • You must have iOS minimum from version 13.0

  • For the Voice channel, to allow the voice connection, it is necessary to open RTPports (according to the provider).

Panel
bgColor#EAE6FF

REQUIREMENTS TO USE APP FOR ANDROID

  • Required operating system: minimum Android 9

  • For the Voice channel, to allow the voice connection, it is necessary to open RTPports (according to the provider).

🔒 Data Privacy in mobile app

Calls, logs and call history are stored on XCALLY server, no data is recorded on the app.
The app project is based on Linphone application, for more information you can consult the relative Privacy Policy
XCALLY Mobile app does not share data with third parties and does not collect any kind of information, except for crash data via Crashlytics, a Google library. This is the list of libraries used:

iOS

Android

Alamofire (Networking)

Firebase (Crash)

FittedSheets (Screen presentation)

IQKeyboardManager (Keyboard management)

KeychainSwift (Safe Data Storage)

SDWebImage (Images management)

SocketIO (Socket)

CircleImageView (Images management)

Gson (Utility)

Firebase (Crash)

Glide (Images management)

Retrofit (Networking)

Sandwich (Networking)

SocketIO (Socket)

⚙️ Agent Configuration

Mobile Agent creation

To use Mobile App, it’s necessary to create Mobile agents going on Staff → Agents → +

Info

To create Mobile agents, you need to enable them on your license

image-20240410-152316.png

You need to insert:

  • Full Name of the Agent

  • Username: used to login (only letters, numbers or special characters like ._ are allowed)

  • Alias: an alternative name for the Agent, which can be used to hide the real agent login name (e.g. in canned answer, email template, chat and so on)

  • Typology Mobile

  • Email: the Agent email address. This field is used to receive a link to reset the password anytime the agent forgets it 

  • Password: insert here the password

  • By default, an Internal number (Extension) is automatically generated. You can manually specify the internal number you want to assign to the agent by editing his/her profile.

  • Description (not mandatory)

  • Optionally, you can enable Voicemail to automatically create a voicemail box for the agent.

  • Finally, click on ADD AGENT

Then you can edit the agent account if you need: https://xcally.atlassian.net/wiki/spaces/XM/pages/1940161571/V3+Agents#Edit%2FModify-an-Agent

The created agent must be added to specific queues by clicking on channel button → voice button:

image-20240212-100815.pngimage-20240212-100857.png

You can select one or more queues and if you want you can indicate an agent penalty to specific queues

Moreover, it’s necessary to enable agents to contacts view → See how to add an agent to a specific contact list

(blue star) Download App for iOS

Agent can easily download and install the XCALLY App Mobile on Apple device, at this link https://apps.apple.com/us/app/xcally-mobile/id6502697252 following this procedure:

1. You can search XCALLY on Apple Store and click on View

Screen APP-20240617-135041.png

2. Install the app and then open it

Screen APP (2)-20240617-135202.png

  1. On your smartphone, you can click on App icon to launch it

Screen APP-20240216-113823.png

  1. When a new version is available, by entering in Apple Store you can update the XCALLY App

(blue star) Download App for Android

Agent can easily download and install the XCALLY App Mobile on Android device, following this procedure:

image-20240801-095103.png

  1. Open Google Play and search XCALLY Mobile

  2. Install the application

  3. On your smartphone, you can click on App icon to launch it

  4. When a new version is available, by entering in Play Store you can update the XCALLY App

💡 How does it work?

Login

By clicking on (blue star) the agent can login

1-20240208-151646.png

In the text field Domain/IP insert the name of XCALLY server. If the name of the Domain is not available, it is possible to insert the IP address

Screen APP (2)-20240304-092902.png

Then, agent has to insert username, not the email, and password. If you have lost, or you cannot remember your password, just click on Forgot Password to recover it

25-20240304-080504.png

Insert your email in the specific text field and complete the password restoring process

Info

  • If you try to access as user, there will be a redirect for filling out a specific form

  • If you try to login without license permission, an error message will be displayed (after inserting server domain)

  • If the white label is enabled, a custom logo will be shown after entering the server domain (the logo has to be uploaded in png or jpg)

User Profile

By clicking on this icon (blue star) the agent can enter the section relative to personal profile

2-20240208-151646.png

From this interface it is possible to view Assigned Services, Privacy Policy and Logout.
If the agent wants to set a pause status can click on:

  • This button (blue star) to start a default pause

  • This button (blue star) to choose a custom pause (see screen below)

3-20240208-151646.png

On Assigned services interface, Agent can see the list of queues to which he/she is assigned

7-20240208-151646.png

By clicking the button (blue star) you can customize your pause,
for example, selecting VIDEO TERMINAL, TEAM MEETING and so on.

Internal messaging

10-20240208-151646.png

Clicking on (blue star) the agent can open the internal messaging section to chat with other agents/users connected to XCALLY

9-20240208-151646.png

Selecting a contact, agent can manage the conversation

Interactions

20-20240208-151646.png

By clicking on Interactions section, the agent can select on top of the page the different types of calls:

  • Internal, calls handled by internal routes, so calls received from the agent on internal route (not calling directly the internal number)

  • Inbound

  • Outbound

  • Dialer (at the moment preview campaign are not supported)

Below there is the list of managed calls with the relative info, such as Contact Name/Number, Start date, End date and time.

Screen APP (4)-20240321-095101.png

By clicking on a specific interaction it is possible to see details about it

Contacts

By clicking on Contacts section, it is possible to view the different contacts, belonging to the relative List, for which agent is enabled.

It’s also possible to filter by list, clicking on (blue star) and select a specific list to view the relative contacts:

18-20240208-151646.png

17-20240208-151646.png

By choosing a contact, the agent can see the details.
By clicking on EDIT CONTACT, it is possible to modify them

Screen APP.png

In this way agent can edit first and last name, landline, mobile and E-mail and click on Save

25-20240308-083710.png

While in Costumer Journey tab, it’s possible to see all touchpoints had on the different channels (calls, chat, emails and so on of interactions closed with a disposition)

Activities

By selecting Activities icon, agent can manage the phone calls

13-20240221-104706.png

When there is a new incoming call, the agent can:

  1. Mute the call

  2. Put the speakerphone

  3. Open the internal messenger

  4. Transfer the call (see below how to)

  5. Pause the call

  6. Start a call recording

14-20240221-104706.png

To transfer a call, the agent can click the highlighted button

11-20240221-104706.png

And select Start new conversation (to begin an attended transfer, so to notify the other agent), or Direct transfer (to begin a blind transfer, as you can see in the screen on the right)

12-20240221-104706.png

When selecting Direct transfer, the other agent directly receives the incoming call

26-20240308-083710.png

It is possible to digit the number also from the keyboard, by clicking on the number space and keyboard appears

27-20240308-083710.png

And you can also use copy and paste functions in that field

(blue star) Troubleshooting

The error message "invalid domain or IP" may also refer to a certificate issue. Please verify that the certificate in use is valid.

If you need assistance using the Mobile App, you can open a ticket at this link