.. _mobile_app_user_guide: ********** User Guide ********** .. _mobile_app_environment_and_use_cases: Environment and use cases ========================== The XiVO mobile application is designed to **complement the UC Assistant**, extending access to your XiVO environment to your smartphone. You will need a Wifi or 4/5G connection. .. important:: The mobile application is a **companion tool**, not a replacement for the UC Assistant or a dedicated telephony device. It is not intended to be the user's primary telephony equipment. .. note:: The mobile application can be used in WebRTC and Unique Account mode only. .. warning:: **Mobile VoIP is not suitable for critical or emergency calls.** Mobile operating systems, public network instability, and reliance on third-party notification services prevent the level of guaranteed reliability and Quality of Service (QoS) required for mission-critical communications. Dedicated telephony/softphony should be used for these purposes. The use of the application can be: • **Shared** (recommended): a hybrid approach alongside your UC Assistant. Several combinations of call processing are possible. • **Standalone**: used without the UC Assistant. This mode is technically possible but not recommended, as it does not provide the reliability and features of a dedicated telephony setup. See :ref:`mobile_app_requirements` for the application's compatibility and known limitations. You can do the following actions: • Call • Receive a call • Transfer a call • Search in multiple directories (XiVO, local phone book, company directory, favorites) • Access to the history • Access to voice messaging • Visibility on the presence of your colleagues The following services are not currently available : • Video conferencing • Chat These features are in our roadmap. .. _mobile_app_download: Download ========= .. list-table:: :widths: 50 50 :align: center * - .. image:: https://play.google.com/intl/en_us/badges/static/images/badges/fr_badge_web_generic.png :target: https://play.google.com/store/apps/details?id=io.wisper :width: 180px - .. image:: https://developer.apple.com/app-store/marketing/guidelines/images/badge-example-preferred.png :target: https://apps.apple.com/fr/app/xivo/id1605117068 :alt: Télécharger sur l'App Store :width: 180px First launch ============ When you open the application for the first time, it will ask for different authorizations : * Stop battery optimization * View in the foreground of the application * Microphone * Phone account to make calls * Local phone book contacts (Optional) .. figure:: images/first-use1.png :scale: 80% .. figure:: images/first-use2.png :scale: 80% .. figure:: images/first-use3.png :scale: 80% .. figure:: images/first-use4.png :scale: 80% .. figure:: images/first-use5.png :scale: 80% .. _mobile_app_first_connection: First connection ================= When you first connect to the application, a connection page will be displayed with the following fields : * the address of the telephony server, * your login, * your password .. figure:: images/first-connection2.png :scale: 80% The server address is either the url you use in your browser or the information found in the parameters, on the upper right corner of your desktop assistant. When you first login, a notification will be displayed in your UC Assistant. It shows you that you can choose, via the call management, on which devices you want to receive calls. QR-code login ------------- Instead of typing the server address, login and password manually, you can scan a QR code provided by your IT administrator (for example in a provisioning email or portal). Scanning the code automatically fills in and submits the three fields. If you receive the same code as a link (deep link) directly on your phone, simply tapping it has the same effect. Home page ========= Once you are logged in, you will be taken to the home page which is a dial pad. From this page you can access : * A dial pad to initiate a call via a number * Your Favorites * Your History * Your voice mail when you have one * A search bar * Access to the configuration .. figure:: images/home-mobileapp.png :scale: 80% You can launch a call by typing a number on the keyboard. For example, if I type \*55 to launch a call to the echo test. .. _mobile_app_favorites: Favorites ========= You can access your favorites through the button located at the bottom left of the mobile application. Once in your favorites, you can launch a call by pressing directly on the handset on the right of the chosen contact. You will also have a view on the status of your colleagues. You can also long-press an entry to copy its phone number to your clipboard. .. _mobile_app_history: History ======= You can access your call history through the button on the bottom right of the mobile application. In the history you will have the possibility to launch a call by pressing directly on the handset. You'll also be able to see the status of the other users. You can long-press an entry to copy its phone number to your clipboard. Calls you have missed since your last visit to the History screen are also flagged with a small orange dot next to the entry, in addition to the missed-call notification (see :ref:`mobile_app_notifications`). .. _mobile_app_search: Mobile search ============= You can find the search bar on the top right of the mobile application on all of the following menus: Phone, History, Favorites. You will be able to search your personal XiVO directory, the company directory and also the local directory of your phone. You can long-press a result to copy its phone number to your clipboard. .. _mobile_app_incoming_call: Incoming call ============= .. figure:: images/incoming-call-mobileapp.png :scale: 80% The reception of a call is done via push notification - (this notification wakes up the app to be able to retrieve the waiting call on XiVO). After picking up the phone you can pause a call, mute the microphone, activate speakers. The "+" button allows to call another number for a transfer or a consultation. .. _mobile_app_outgoing_call: Outgoing call ============= In some cases, you might get "Your call is in transit" before getting the screen "your call is ringing" the time to synchronize with the server. Once the person you are calling has picked up the phone you will be taken to the call management page. Calling from your phone's native contacts ------------------------------------------ Tapping a contact directly in your phone's native Contacts or Phone application routes the call through your XiVO SIP line instead of your cellular line, as long as the mobile application is registered. .. _mobile_app_managing_a_call: Managing a call ================ When you are on a call, whether it's an incoming or outgoing call, you get basic call management options (hold, mute, etc.). Call transfer ------------- You can transfer a call while being on a call. There are two ways to do it: * Pressing the "+" button allows you to go directly to the Favorites and select the person you want to reach for your transfer. Once you have selected your favorite, the call will be launched and the person you were talking to will be put on hold. * You can access the pages : * Favorites * History * Search From one of these pages, you can launch a second call and put on hold the person with whom you were in a conversation. .. figure:: images/mobileapp-transfer2.png :scale: 20% Put on hold ----------- When you receive a call while being already on a call, you can put your current call on hold. In this context, the person you put on hold will hear a music on hold. You can then resume the call via the play button. .. _mobile_app_notifications: Notifications ============= Notifications are integrated in the mobile application. You will receive these notifications on your mobile application when you have a missed call. .. _mobile_app_call_management: Call management ================ Device management ------------------- During the installation and the first connection to the mobile application, you must have noticed a change in the call management of your UC assistant. You can, on your UCAssistant select the ringing device: .. figure:: images/device-management-mobileapp.png :scale: 80% This allows you to select either your UC Assistant or the mobile application or both. See `Using web and mobile applications together `_ in the XiVO web/desktop assistant user guide. This management capabilities is also available within the app. Do not disturb --------------- When activating the "do not disturb" mode, you will see a "do not disturb" sign in the top right corner of the call management. Forward all calls ------------------- When activating the "forward all calls" you will see an arrow next to your internal number with the forward number where call will be forwarded. Forward calls on no answer ---------------------------- When activating the mode "forward calls on no answer", you will see an arrow next to your internal number with the forward number where call will be forwarded. .. _mobile_app_configuration: Configuration ============= .. figure:: images/configuration-mobileapp.png :scale: 80% You can access the configuration by pressing the button on the top right corner of the call management. In this menu you have access to the following actions: - Remove my phone contacts access (or limit access on iOS) - XiVO server information - Send logs to support .. _mobile_app_disabling_application: Disconnecting / disabling application ====================================== You can disconnect and disable the app by pressing the button at the bottom center of the page. When you log out, you wont be able to receive calls on your smartphone anymore. In this case, only the UC Assistant will ring if you are connected to it.