Kalliope CTI Mobile
Introduction
For those who need to always be on call, Kalliope has designed the KalliopeCTI mobile app for Android and iOS.
The KalliopeCTI mobile app is an optional product that lets you access telephone and UC services even outside your office through your extension number, using the company lines.
To guarantee stability and improve conversation quality, KalliopeCTI mobile lets you choose how to handle your calls: based on data traffic availability, you can choose whether to use the GSM network or use the app in softphone mode.
KalliopeCTI mobile lets you call using three different modes:
- Click-to-call: the call will be handled through the desk phone associated with your extension;
- Call-back: call from your smartphone using Kalliope lines;
- Softphone: using an integrated SIP telephone engine, your smartphone will register to KalliopePBX like any other IP client.
KalliopeCTI mobile is available on Google Play and the App Store.
View the policy on Processing of personal data of users
N.B.: Each extension can only be linked to one KCTI account.
Initial configuration:
In order to use the KalliopeCTI mobile app you must first:
- Enable "KCTI Mobile App" in the account settings (N.B.: only one account per extension may be enabled to use the mobile app)
- Assign one of the following KalliopeCTI licenses to the user:
- KalliopeCTI Pro license -> enables the use of the KalliopeCTI mobile app only in callback mode (GSM™)
- KalliopeCTI Phone license -> enables the use of the KalliopeCTI mobile app in both softphone and callback mode
- If you wish to externally access the company network with the mobile app, you will need to publish the following KalliopePBX ports (PLEASE NOTE: It is recommended to not expose the central unit's SIP service on the public in a direct way that can be reached from arbitrary IPs, but to use a Session Border Controller that can properly protect the central unit from intrusion attempts from outside):
- TCP 5039 port for CTI services
- TCP 5222 port for XMPP chat services
- UDP for SIP service port as configured in the "SIP settings" page (only for softphone mode, default value is '5060')
- UDP 10000-20000 ports interval for RTP streams (only for softphone mode)
Also, it is necessary that the KalliopePBX can send messages to the push notification servers of Apple and Google, so the reachability by the KalliopePBX of the following addresses must be guaranteed:
- iOS: api.push.apple.com (HTTPS, port TCP/443)
- Android: fcm.googleapis.com (HTTPS, port TCP/443)
Since these hosts may resolve different IPs over time, it is recommended that no filters be applied to HTTPS traffic exiting KalliopePBX.
In addition, in order for mobile devices running the KalliopeCTI Mobile APP to receive notifications, they must be connected and reachable by the sending services. For more information about the flows that must be ensured, please refer to the official documentation of:
- Google: https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall
- Apple: https://support.apple.com/en-ph/HT203609
NOTE: In order to avoid abnormal behavior in sending incoming/ending call notifications to clients, it is necessary that each user is logged in on a single device, because each SIP account (and therefore associated user) can be associated with a unique Firebase token (used to identify the recipient of the notifications).
NOTE: In case the central unit SIP service is exposed on a different IP than the CTI connection IP, or on a different port than the standard one (5060), it is necessary to set on the KalliopePBX one or both of the following custom placeholders within the Provisioning panel: %%_KPHONE_SIP_REGISTRAR_IP%% and %%_KPHONE_SIP_REGISTRAR_PORT%%%. This configuration is normally necessary when the SIP service is exposed to the public through a Session Border Controller that uses a different IP from the one on which the PBX is reachable, while it is not necessary if the PBX and the SBC are natted on the same public IP, each one for the ports of its competence (TCP/5039 and TCP/5222 for the CTI and Chat components, towards Kalliope, and SIP + RTP for voice, towards the SBC).
More and specific informations regarding the configuration and use of the KalliopeCTI Mobile app in the two operating systems Android and IOS can be found on the following dedicated pages: