Starting from iOS app version 7.6.35419, the access to Mobile Collaboration is allowed only for users with Essential License and higher. PBX admin needs to assign a corresponding license in WMS -> Users (consult the Guide for instructions).
Wildix Collaboration Mobile application provides access to Wildix Unified Communications from your iPhone, iPod touch and iPad.
iOS Version: 7.6.35419
To check the current version, go to iOS changelog: https://www.wildix.com/new-releases-and-updates/collaboration-ios-app-changelog/
Updated: October 2019
Permalink: https://confluence.wildix.com/x/ToDt
Before using the app
Requirements
To use this application, you must be a user of a Wildix system and have fast internet connection that doesn’t block VoIP traffic.
Ports to open: Ports used by Wildix services
Use of App outside the office network: the first time you make a login from the local network, the PBX sends the settings of the public network to the application (the same for connection from the public IP). The app tries to connect using the first IP and if it fails, it moves to the second one, thus ensuring the connection both when you are in or outside the office network.
Requirements iOS
- WMS version 3.84.35087 or higher
- iOS version 9.0 or higher (iOS 12)
- Minimum iPhone 4S
Push notifications
Thanks to push notification, the app no longer needs to run all the time. Once you receive a call / a text, the app “wakes up” in the background, even in case the app was closed.
To deactivate access to Presence and SIP server and to stop receiving notifications, you can set the status to Offline or log out from the app. Read the chapters Status and Log out for more info.
Read about push notification: https://blog.wildix.com/what-is-push-notification-for-mobile-apps/.
Sync of enterprise phonebooks
Sync of enterprise phonebooks is not necessary: live search in PBX phonebooks is supported directly from Dialplad.
- Go to iPhone Settings -> Passwords & Accounts
- Select Add Account
Select Other
- Select Add CardDAV Account
Enter the Server name (PBX domain name or IP), User name, Password and Description
Now all your PBX contacts appear in your iPhone phonebook. Go to iPhone Phone -> Contacts and select the groups that you wish to be displayed in the phonebook of your iPhone.
Note: It is possible to save contacts directly from History:
- Go to History
- Tap the double Arrowhead icon to view user contact details
- Select one of the options: Create New Contact / Add to Existing Contact
Login
Launch the app:
- Domain: PBX IP or domain name
Note: you can enter the PBX name, wildixin.com domain is added automatically.
User name: Extension / User name / Email address
- Password: WEB password of a user for access to Collaboration
Or
You can use Google/ Office 365 credentials for single sign-on.
Two-factor authentication (2FA)
It is possible to use 2FA authentification for login. The option can be enabled in Collaboration -> Settings -> Personal.
Detailed information can be found in Collaboration User Guide.
Menu description
1 - Contacts
2 - Call history
3 - Dialpad/ Function Keys/ Active call
4 - Chat
5 - Settings
User status
- Tap Dialpad
- Tap status icon / user picture
- Tap on the current status and select the new one: DND / Away / Offline / Online
- Enter your status message (optional)
Note: for DND / Away it is possible to set up expiry time via Until option (optional), after which your status passes to online.
Note: offline status is available only for mobile apps and it allows you to disconnect from Presence and VoIP servers; you will not receive push notifications at all.
Call
Live search
You can use real-time search in PBX phonebooks to place calls.
Note: You can also sync your enterprise phonebooks if you want them to appear in Contacts menu of Wildix Mobile Collaboration App. Refer to this Chapter for detailed information.
Place a call from Dialpad
- Tap Dialpad
Select the mode to place a call:
Note: It is possible to generate a call via another device registered to your account (WP phone, Vision/ SuperVision, W-AIR handset/ headset etc)
- VoIP: place a call via the PBX (recommended in case you have fast and reliable Internet connection)
- Callback: you receive a callback from the PBX via Mobile network (make sure your mobile number is indicated in Settings -> Personal)
Direct Call: place a call via Mobile network
Wildix devices registered to your account: select a device from the list - a call will be generated using the selected device
Start entering user’s name or number / extension in the Search field to find a user / a contact
Tap on a user / a contact you wish to call. Select number/ extension to place a call
Or
- Enter the number using Dialpad
- Tap the green Handset button
Video: generate a call from iOS via W-AIR Headset
From Function keys
Note: Before using the feature, configure function keys (FK) in Collaboration -> Settings -> Function keys. You can configure up to 20 FK. For more information, read Collaboration Guide, /wiki/spaces/DOC/pages/30285992.
- Tap Dialpad and select Function keys to switch to Function keys menu
- Tap on a function key you wish to call
- Select Call from the drop-down list
From Enterprise Contacts
Note: by default the local contacts from your device’s phonebook appear in this menu; to access the enterprise phonebooks, set up the sync of contacts, as described in the chapter Sync of enterprise phonebooks.
- Tap the contact you wish to call
- Tap the number you wish to call
Note: a call is made using the mode selected in Dialpad menu (VoIP / Callback / Direct Call).
From History
- Go to History
- Tap on a user
- A call is placed automatically
From Voicemail
- Go to Voicemail
- Tap on a voicemail message from a user you'd like to call
- Select Call from the drop-down list
From Chat
- Open a chat session with a user
- Tap Handset button
- The call is placed automatically
Note: In case you received a Call me back request from another user, it is displayed in chat and you can place a callback to this user by tapping Call me back.
From your device’s contacts
- Tap a contact in your iOS contacts
- Tap and hold the Call button
- Select Collaboration
From Browser (Support of URI for call generation)
Thanks to URI support, it is possible to generate a call from the browser by clicking on a link containing a phone number. It allows you to start calls from various web pages.
Supported link:
<a href=”sip:[phone_number]”>
<a href=”wildix:[phone_number]”>
where [phone_number] parameter can also start with “+”
To generate a call from the browser:
- Tap on a telephone number containing the supported link
- Select Collaboration from the drop-down list
Answer a call
Note: on iOS mobile calls and VoIP calls have the same priority, you VoIP call is not interrupted in case you receive an incoming mobile call.
- Tap the blue Tick button to answer
- Tap the red Crossmark button to decline
Call management
During a call you can navigate your device, open the App and tap Dialpad to come back to the active call.
1 - Video
2 - Hold
3 - Transfer. Select the needed option for the list: Contact (choose a contact from Contacts)/ Number (dial a number you wish to call from Dialpad)/ Device (select a device where you wish to pass the call)/ Function key (select FK to transfer the call)
4 - Record a call
5 - Mute
6 - Speakerphone. Tap to switch to Speaker mode and vice versa. If you use AirPods, please consult the next chapter for details
7 - Conference (in case there is more than one active call)
8 - Hang up
9 - DTMF
10 - Switch back to Dialpad/ Function keys tabs to make a new call
Switch between speaker/ handset modes/ AirPods
If you have AirPods connected to your iPhone, you can switch to them during an active call:
- Hold Speakerphone button for 2 seconds to display the list of available audio modes
- Select the needed mode from the list:
- IPhone (Handset)
- Speaker
- AirPods
Transfer
Blind transfer:
(transfer without notification)
- Tap Transfer button during a call
- Tap Contact to select a number from the phonebook or Number to manually enter the number
- Select a contact and tap the number / enter the number and tap the green Handset button
Attended transfer:
(transfer with notification)
- Tap New call button during a call
- Make a new call (select a contact from Contacts or dial the number manually)
- Wait till the other party answers (the previous call is now on hold)
- Tap Transfer button and select the call on hold to complete the transfer
Video tutorial:
Transfer via Function keys
Transfer option via Function keys "Colleague", "Park Orbit" and "Speed dial" is available:
- Tap Dialpad and select Function keys to switch to Function keys menu
- Select the function key to transfer a call
- Tap Transfer for blind transfer, otherwise tap Call to start a call first (attended transfer)
Control of active calls on other devices and Call continuity
Control of active calls on other devices
The feature allows you to view and control own active calls on other devices registered to your account. You can hold/ resume, record, hang up a call as well as send DTMF.
Call continuity
With the help of the feature it is possible to pass your active calls from other devices to iOS or another specific device.
To pass an active call to iOS Collaboration app:
- Tap Call continuity button
- A call is automatically picked up on iOS
To pass an active call to a specific device:
- Tap and hold Call continuity button
- Select a device from the list
- A call is automatically picked up on the selected device
Note: To use mobile continuity, make sure that Dialplan rule "pbxfeatures (Features codes dialplan)" is added to "Included procedures" of the Dialplan used for managing calls.
Note: in case there is no need to monitor active calls or use Call continuity, you can switch back to Dialpad/ Function keys tabs.
Chat
All the colleagues added to your roster appear in Chat menu.
- Tap Chat
- Use the search field to find a user
- Tap a user and enter your message
- Tap Paper plane icon to send the message
Note: To delete a chat session with a user, swipe it left.
Start a chat session from live search results
Start entering user’s name or number / extension in the Search field to find a user
Tap on a user you wish to chat. Select Chat from the list
Start a chat session from History
You can also start a chat session with a user from History tab.
- Go to History
- Select a user you would like to chat with and tap the double Arrowhead icon to view user contact details
- Tap Chat
Note: If you delete a chat session with a user, you can restore it from History via Chat option.
Send a File / an Image / a Post-It/ Call me back
Send a file / an image:
- Start a chat with a user
- Tap +
- Select the source:
- Camera
Photo & Video Library
Downloads
- Select files/ images or take a photo using the camera to be sent (you can send up to 10 files/ images)
- Tap Send button
- Confirm by tapping Send
Note: The maximum file size to be sent is 100Mb.
Send a Post-It
- Start a chat with a user
- Write your message
- Tap +
- Select the option Send as Post-It
Send Call me back
- Start a chat with a user
- Tap +
- Select the option Call me back
Send a voice recording
Start a chat with a user
- Press and hold Microphone icon to record a message
- After you finish, release to send
Note: To cancel voice recording without sending, slide left.
Participate in Ubiconf videoconference
- Open a chat session with a user who sent an invitation
- Tap on the invitation
- Select Join to enter the conference room via Safari browser (opens automatically) or Call to access the conference in audio-only mode. Follow Ubiconf Videoconference User Guide for details
Current limitations:
- DND status "in conference" is removed after the conference is finished, but is not removed automatically after closing tab with conference
- impossible to join a conference with a different user by new token using iOS Safari browser after re-login in the app (user anyway joins the conference as the previous user)
- It is impossible to create a conference from iOS app; it is possible to participate in the conference if you were invited (you receive an invitation via chat)
History
Note: Call history and missed calls notifications are synced over the PBX among all the devices registered to your account (except for W-AIR handsets).
Tap History to access the log of calls. Incoming, outgoing and missed calls (highlighted in red) are displayed in All tab. To view only missed calls, tap Missed tab.
Tap and hold a call to be able to delete, archive or copy a phone number to clipboard.
Tap the double Arrowhead icon to view user contact details and a call log.
Note: in case the call log is empty, make sure that:
backend for CDR is enabled in WMS Settings -> PBX -> CDR
ACL group of your user does not have restriction “Cannot use” -> “History”
Note: calls via Collaboration application are also displayed in the device’s call history (Phone -> Recents).
Voicemails
Tap Voicemail tab to access your Voicemails.
- To download a voicemail message, tap Arrow icon
- To play it back, tap Play button
- To pause a playback, tap Pause button
- Other options: tap on a voicemail message to display the drop-down list: Call a user who left a message, Mark as read or Delete it
Multi-edit of Voicemails:
- Select one or multiple Voicemails
- Click Mark as read or Delete icon
Call recordings
Call recordings are displayed and can be played back from History.
- To download a call recording, tap Arrow icon
- To play back a dowloaded recording, tap Play button
- To pause a playback, tap Pause button
In case there are several recordings of one call, they are displayed as a list.
Settings
- Account: login window
- Personal: contact details
E-mail
mobile number
- Features by call class (Internal, External, Blacklist, Whitelist)
Activate class: available for External / Blacklist / Whitelist (activates the class)
Call reject: if enabled, you do not receive incoming calls
Busy call forward: check the box and enter the number or VOICEMAIL, to enable call forwarding when busy on the phone
Unavailable call forward: check the box and enter the number or VOICEMAIL, to enable call forwarding in case of no answer
Force call forward: check the box and enter the number or VOICEMAIL, to enable the forwarding of all the incoming calls
Call waiting: enable to be able to receive more than one call at a time
Mobility with timeout: if enabled, you receive incoming calls to your mobile number after the specified timeout; mobile number must be configured in Collaboration Mobile app Settings -> Personal
- Advanced:
Debug: if enabled, you can collect logs in case of crashes/ issues with the application. Detailed information can be found in Collecting logs from iOS apps chapter of Debugging of Mobile Apps Guide
Send (appears only after enabling Debug option): allows sending an email report with the collected logs to Wildix support
Use PBX LAN Address (enabled by default): the application connects to one of IP candidates: IP/domain and port 443 if a user did not specify a port on login page or IP/domain:port if user specifies a port on login page
Disable SIP mode: the feature is disabled by default. If enabled, call via Direct call is set as default mode for call generation. In this mode application de-registers from the PBX; missed call counter, new voicemail counter and status of Trunk, Timetable, Switch, 3 state switch, Call group Feature Keys stop working; chat and call control/ call generation via remote device continue to work
Limitation: If the option remains active for more than 30 days, PUSH subscription is removed for this extension. As a result, user is be able to receive chats. To reactive PUSH subscription, switch off and then switch on again Disable SIP mode.
Firewall bypass (beta): the feature is disabled by default. The app uses TURN server located on turn.wildix.com (used TCP port 443). If enabled in On mode, the app switches audio stream to PBX via external TURN server right away after call was started. If enabled in Auto mode, the app switches audio stream in case it is missing for 5 seconds after call was started
Limitations:
firewall bypass works only on Сloud PBXs and on PBXs with 1-to-1 NAT
application supports only 1 call in case feature is enabled
switching to external TURN server during conversation in case audio stream was lost (in Auto mode)
- Ring on Apple Watch: if enabled, you receive incoming call notification on Apple Watch (Apple watch extension)
Chat image quality: select one of the image resolutions (High/ Standard/ Low) to compress or improve quality of pictures/ photos before sending
Save chat images to gallery (enabled by default): allows saving images from chat sessions on the phone by tapping on it
Convert heic to jpeg (enabled by default): allows converting of .heic images into jpeg
- About: Info about App version and developer
Log out
- Tap Settings -> Account
- Tap the Log out icon:
Note: after you log out, you will no longer receive calls and messages.
Appendix 1. Apple watch extension
Apple Watch extension is available starting from iOS app version 7.2.35312.
Apple Watch extension allows you:
To see/ set status from watch (see full status, e.g. "away XXX until yy.zz.mmmm"/ set only away, dnd, online, offline)
To display active call (only active call on iOS application and only 1 call):
To decline/ hangup call from watch (no possibility to answer):
Notes:
- To display incoming call notification on Apple Watch, enable "Ring on Apple Watch" in Advanced settings
- To sync user status and active call information, it's necessary to open both Apple watch and iOS apps
- Sync delay between Apple watch and iPhone may reach up to five seconds
- In some cases Apple watch app may stop receiving data (status, user pic) from iOS app; to fix this issue, it is necessary to reboot Apple watch