Wildix Collaboration Mobile application provides access to Wildix Unified Communications from your iPhone, iPod touch and iPad.


<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = 'https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.11';
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>



<span class="page-title-pdf">iOS Collaboration Mobile App Guide - English</span>



<div class="fb-like" data-href="https://confluence.wildix.com/x/ToDt" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>


<div class="lang-box-pdf">
	<div>
		<div class="google-lang">
			<div id="google_translate_element">
			</div>
			<script type="text/javascript">
					function googleTranslateElementInit() {
						new google.translate.TranslateElement({pageLanguage: 'en', includedLanguages: 'de,es,fr,it,nl', autoDisplay: false}, 'google_translate_element');
						}
			</script>
			<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
		</div>
		
		<div class="pdf-button">
			<a href="https://confluence.wildix.com/spaces/flyingpdf/pdfpageexport.action?pageId=15564878" alt="Convert to .pdf" title="Convert to .pdf"><img src="https://confluence.wildix.com/download/attachments/14549012/pdf-button-download-wildix-documentation.png"></a>
		</div>
	</div>
</div>


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 App Version: 8.3.45865 

To check the current version, go to iOS changelog: https://www.wildix.com/new-releases-and-updates/collaboration-ios-app-changelog/

Updated: June 2021

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:

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.

Note: since iOS device disconnects from SIP, it disappears from the list of active devices in Wildix Collaboration interface, once you wake it up or receive a push, it appears again.


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.

Note: you can also receive push notifications to your Apple watch. Go to iPhone Watch -> Notifications -> Collaboration and enable receiving notifications. Show app on Apple watch.


NOTE: The latest Apple requirements for iOS 13 SDK change the behavior of push notifications compatibility. After upgrading the app at least to v. 8.0.45765, a user needs to open it to update a new push subscription. Otherwise, all non-call push notifications (chat message / missed call message) are sent to the app as a call containing own user caller name.

  • The sync between read chat messages in Collaboration and the app is currently disabled. In order to remove push notifications that were received for group chat messages, open the app (this behavior will be improved in the next releases)

  • After re-login to another PBX without correct logout from the previous PBX, a user can still receive push notifications (chat / call / missed call) from the previous PBX as a call containing own caller name, non-call push notifications (chat / call / missed call) are sent to the app as “Unknown” call

    • to disable these notifications, log in to a previous PBX and perform logout again. A warning notification with extension and PBX domain is displayed if this situation occurs 

    • to remove push subscriptions from PBX: access PBX via SSH as root and run the command push_remove EXT where EXT is user extension, for example, 123



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 Dialpad.


  1. Go to iPhone Settings -> Passwords & Accounts
  2. Select Add Account
  3. Select Other 



  4. Select Add CardDAV Account
  5. 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:

Note: you can enter the PBX name, wildixin.com domain is added automatically.

Or 

You can use Google/ Office 365 credentials for single sign-on.


Two-factor authentication (2FA)

It is possible to use 2FA authentication 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

  1. Tap Dialpad
  2. Tap status icon / user picture
  3. Tap on the current status and select the new one: DND / Away / Offline / Online
  4. Enter your status message (optional)
  5. Tap the Tick icon to apply changes


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

  1. Tap Dialpad
  2. 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)


  3. Start entering user’s name or number / extension in the Search field to find a user / a contact 

  4. Tap on a user / a contact you wish to call. Select number/ extension to place a call

Or

  1. Enter the number using Dialpad
  2. Tap the green Handset button


Video: generate a call from iOS via W-AIR Headset

<iframe src="https://www.youtube.com/embed/Xn4-mwPRSCg" width="560" height="315" frameborder="0" allowfullscreen="allowfullscreen"></iframe>


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, Function key section.


  1. Tap Dialpad and select Function keys to switch to Function keys menu
  2. Tap on a function key you wish to call
  3. 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.


  1. Tap the contact you wish to call
  2. 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

  1. Go to History
  2. Tap on a user
  3. A call is placed automatically 

From Voicemail 

  1. Go to Voicemail
  2. Tap on a voicemail message from a user you'd like to call
  3. Select Call from the drop-down list

From Chat

  1. Open a chat session with a user
  2. Tap Handset button
  3. 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

  1. Tap a contact in your iOS contacts
  2. Tap and hold the Call button
  3. 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:

where [phone_number] parameter can also start with “+”


To generate a call from the browser:

  1. Tap on a telephone number containing the supported link
  2. 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.


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 between audio sources: Speaker/ Handset (iPhone)/ Headphones

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 audio sources 

Note: If you have paired Bluetooth headphones to your iPhone, they are automatically selected as an audio source during incoming/ outgoing calls.

If you have any headphones connected to your iPhone, you can switch to them during an active call:



Transfer

Blind transfer:

(transfer without notification)

  1. Tap Transfer button during a call
  2. Tap Contact to select a number from the phonebook or Number to manually enter the number
  3. Select a contact and tap the number / enter the number and tap the green Handset button

Attended transfer:

(transfer with notification)

  1. Tap New call button during a call
  2. Make a new call (select a contact from Contacts or dial the number manually)
  3. Wait till the other party answers (the previous call is now on hold)
  4. Tap Transfer button and select the call on hold to complete the transfer


Video tutorial:

https://www.youtube.com/watch?v=HfxIDPLKu2U


<div class="container"> <div class="video"><iframe width="560" height="315" src="https://www.youtube.com/embed/HfxIDPLKu2U?rel=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe></div></div>

Transfer via Function keys

Transfer option via Function keys "Colleague", "Park Orbit" and "Speed dial" is available:

  1. Tap Dialpad and select Function keys to switch to Function keys menu
  2. Select the function key to transfer a call
  3. 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:

To pass an active call to a specific 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.

  1. Tap Chat
  2. Use the search field to find a user
  3. Tap a user and enter your message
  4. 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

  1. Start entering user’s name or number / extension in the Search field to find a user 

  2. 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.

  1. Go to History
  2. Select a user you would like to chat with and tap the double Arrowhead icon to view user contact details
  3. 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:

  1. Start a chat with a user
  2. Tap +
  3. Select the source:
  4. Select files/ images or take a photo using the camera to be sent (you can send up to 10 files/ images)
  5. Tap Send button
  6. Confirm by tapping Send

Note: The maximum file size to be sent is 100Mb.



Send a Post-It

  1. Start a chat with a user
  2. Write your message
  3. Tap +
  4. Select the option Send as Post-It

Send Call me back

  1. Start a chat with a user
  2. Tap +
  3. Select the option Call me back

Send a voice recording

  1. Start a chat with a user

  2. Press and hold Microphone icon to record a message
  3. After you finish, release to send


Note: To cancel voice recording without sending, slide left.

Participate in Wizyconf videoconference

Important: for access to video conferencing service on iOS devices, use Safari/ Google Chrome browser or install Wizyconf iOS App.




Current limitations:

  • DND status "in conference" is removed after the conference is finished, but is not removed automatically after closing tab with conference 
  • 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)
  • It is impossible to join a conference with a different user using iOS Safari browser after re-login in the app (user anyway joins the conference as the previous user)

Multiuser group chat

Available starting from iOS app version 7.8.35572 and WMS version 4.03.44817.02.

Multiuser cloud-stored group chats with possibility to add up to 500 participants and send pictures/ files.

Limitations:

  • not available for PBXs with LifeTime licenses
  • no more than 100 group chats can be received from the server
  • if user opens a push notification from a group chat after being removed by an owner, one-to-one chat with user who sent message is opened

Create a group chat 

  1. Tap + 
  2. Edit the group title (optional)

  3. Add participants 

  4. Tap Done to finish



Add / remove participants

Note: you cannot remove yourself and a group chat manager.

Open the group chat management section by tapping on its title.

  1. To add a participant: start typing a participant's name/ extension number in the search field, tick to add

  2. To remove a participant: untick a participant or tap on a participant with indicated x icon

  3. Tap Done to save changes



Leave/ close the group chat:

Only the group chat manager can close the chat. Other participants can leave it and can join back only after the manager adds them again.

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.

Multi-edit of Voicemails:

  1. Select one or multiple Voicemails
  2. Click Mark as read or Delete icon 


Call recordings

Call recordings are displayed and can be played back from History.

In case there are several recordings of one call, they are displayed as a list.


Settings

Change user picture



Log out

  1. Tap Settings -> Account
  2. 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.

Upon the first launch, open the iOS app to sync it with Apple watch.


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


Apple Watch extension allows you:


<div class="fb-like" data-href="https://confluence.wildix.com/x/ToDt" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>



<div class="ask-question"> <div class="text-before-buttons"> <span style="font-size: 24px; text-align: center;">Not finding the help you need?</span><br> Join the Facebook group to ask a question! </div> <div class="fb-buttons"> <span style="align: center;"><a href="https://www.facebook.com/groups/wildixtechwizards" target="_blank"><img src="https://manuals.wildix.com/wp-content/uploads/2017/03/facebook_tech-wizards.png" alt="facebook_tech-wizards" width="282" height="80" align="center"/></a></span></div> </div> </div>