ACCELERATOR 8.4 IOS CALLKIT GUIDE

Transcription

1 ACCELERATOR 8.4 IOS CALLKIT GUIDE Revision April 2018 Tango Networks, Inc. phone: Network Blvd, Suite 200 fax: Frisco, TX USA

2 Tango Networks, Inc. This software is protected by copyright law and international treaties, and is the confidential and proprietary information of Tango Networks, Inc. Unauthorized reproduction, use, or distribution of this software, or any portion of it, may result in severe civil and criminal penalties, and will be prosecuted to the maximum extent possible under the law. The software described in this document is furnished under license agreement and may only be used in accordance with the terms of the agreement. Tango Networks and Abrazo are trademarks of Tango Networks, Inc. All other trademarks used herein are the property of their respective owners and are used for identification purposes only Tango Networks, Inc. Tango Networks, Abrazo and E=fmc2 are trademarks or registered trademarks of Tango Networks, Inc. All other trademarks or service marks are the property of their respective owners. Specifications and features are subject to change without notice. Revision April 2018 CONFIDENTIAL Page 2 of 21

3 TABLE OF CONTENTS IOS CALLKIT WITH TANGO COMMUNICATOR... 4 ACCELERATOR PROVISIONING... 4 ALLOW ACCESS FOR APP... 4 LOGIN TO COMMUNICATOR APP... 5 MANUALLY ENTER LOGIN CREDENTIALS... 5 WELCOME CALLING FROM CONTACTS... 8 Long Press Call Button... 9 CALLING FROM FAVORITES...10 CALLING FROM RECENTS...11 DIALING DIGITS IN CALLKIT (SIRI)...11 LOCK SCREEN RECEIVE COMMUNICATOR APP CALLS...12 CALL SERVICES & BUSINESS VOIC WIDGETS...13 Active Calls and the CallInfo Widget...15 CALL SERVICES MENU...16 During Active Call...16 INTERACTIONS WITH 2 STAGE DIALING...17 ACCELERATOR SERVER-SIDE INTERACTIONS... 1 CALL DELIVERY NOTIFICATION... 1 DISCONNECT NOTIFICATION... 1 TERMINATIONS... 1 VoIP Client Terminations... 1 Registration Timer... 1 Non-VoIP Client Terminations... 1 REGISTRATION FAILURE... 1 CLIENT ORIGINATIONS... 2 Revision April 2018 CONFIDENTIAL Page 3 of 21

4 ios CallKit with Tango Communicator Apple s website describes the ios 10 CallKit as a new framework that lets your VoIP app integrate tightly with the native Phone UI. You can have your incoming calls displayed fully on the lock screen. People can choose to use [the Tango Communicator] app when making calls from the native Phone s Contacts, Favorites, and Recents. Adopting CallKit lets [the] app coexist seamlessly with other active calls. 1 The CallKit is an iphone feature available in ios 10. The CallKit is an extension to the iphone s telephony framework allowing calls made from the native dialer interface to interact with 3 rd party solutions. Tango uses the ios CallKit to allow business calls to be made from the native user interface. Tango s solution is designed to take advantage of the native iphone user experience that is provided by Apple CallKit and evolve as Apple evolves CallKit. Accelerator Provisioning The way in which the CallKit works with the Communicator app, it is more natural to have the multi-line functionality off (Corporate Liable with Allow Personal Calls unchecked). This setting routes Business calls through the app. Personal calls still route via the Wireless network and do not involve the Accelerator. The Communicator app still works fine with multi-line enabled. For more information, see the Accelerator Provisioning Guide, Subscriber section and search for Mobile Account Type. Allow Access for App The first time you launch the Communicator app you will be asked to allow access for these areas (recommended action is Allow/OK): Figure 1 Allow Access for App 1 Source: Revision April 2018 CONFIDENTIAL Page 4 of 21

5 Login to Communicator App Two methods to login to the Communicator app are provided here: Manually enter login credentials. Use Welcome to download app and login. Manually Enter Login Credentials You will need to know your Username, Password, and Config Server to login manually. Username You can use your mobile number or your full desk number: o mobile number such as: o full desk number such as: Password Obtain your password from the Accelerator administrator. Config Server This can be an IP address (not recommended) or the DNS resolvable hostname to your Accelerator. Figure 2 Splash Screen and Manual Login Screen Revision April 2018 CONFIDENTIAL Page 5 of 21

6 Welcome Sending a Welcome is the easiest method for downloading and logging in with the Communicator app. The Accelerator provisioning admin will initiate the Welcome from the provisioning interface. 1. Open the Welcome from your iphone program. Select and copy the Verification Code. Click the here link. Figure 3 Welcome 2. Supply login credentials using your Verification Code from the Welcome and create a new password. Click Submit. Figure 4 Welcome Login Credentials Revision April 2018 CONFIDENTIAL Page 6 of 21

7 3. Click Open when asked to redirect to the App Store. Figure 5 Open the App Store 4. Once in the App Store, download and open the Tango Communicator app. Figure 6 Download/Open Communicator App 5. Registration with the Accelerator is automatic. If your registration fails for some reason, you should receive a pop message indicating failure. Figure 7 App Registration Failure Revision April 2018 CONFIDENTIAL Page 7 of 21

8 6. Otherwise, you should be registered and ready to use the app. Figure 8 App Registration Success Calling From Contacts Pressing here is considered a Personal Call. Mobile number displayed and call does not go through the PBX. Pressing here is considered a Business Call. Desk number displayed and call goes through the PBX. Figure 9 Calling from Contacts Tango s solution is known to the CallKit as Communicator. Selecting buttons with the Communicator label makes the call a Business Call. Revision April 2018 CONFIDENTIAL Page 8 of 21

9 Long Press Call Button Long press the Call button brings up the Communicator option. Figure 10 Long Press Call Button Revision April 2018 CONFIDENTIAL Page 9 of 21

10 Calling From Favorites Add to Favorites and make business calls Figure 11 Calling from Favorites Revision April 2018 CONFIDENTIAL Page 10 of 21

11 Calling From Recents Pressing here is considered a Personal Call. Mobile number displayed and call does not go through the PBX. Pressing here is considered a Business Call. Desk number displayed and call goes through the PBX. Figure 12 Calling from Recents Dialing Digits in CallKit (Siri) Voice dialing with Siri. Simply say: Siri, call xxx-xxx-xxxx using Communicator. For a Personal Call, leave off the using Communicator part. Figure 13 Dialing with Siri Revision April 2018 CONFIDENTIAL Page 11 of 21

12 Lock Screen Receive Communicator App Calls When the iphone is locked, calls can still be received via the Tango Communicator App. Figure 14 Receive Communicator Calls when Locked Revision April 2018 CONFIDENTIAL Page 12 of 21

13 Call Services & Business Voic Widgets The iphone allows the Tango Communicator App to configure a Widget for easy access to Call Services and Business Voic . Call Services includes Call Move, Blind Transfer, and Consultative Transfer. iphone widgets can be accessed from the Home screen by swiping right see Figure 15. Figure 15 Swipe Right for Widget Screen Once in the widget screen, scroll all the way down to the bottom and find the Edit button. Figure 16 Scroll to Bottom for Edit Button Revision April 2018 CONFIDENTIAL Page 13 of 21

14 Now find the widget named CallInfo and click the Plus Sign to add this widget. After clicking the Plus Sign, grab the handles on the right to place this widget near the top of your screen. Figure 17 Swipe Right for Widget Screen The CallInfo widget contains: Move Call From Desk While in an active call, you can move the call from your desk phone to your mobile by clicking this link. Business Voic Quick access to your enterprise voic system. Revision April 2018 CONFIDENTIAL Page 14 of 21

15 Active Calls and the CallInfo Widget Once a call is established, you can access additional Call Services from the CallInfo widget. Figure 18 shows an active call and the options available when you navigate to the CallInfo widget. Figure 18 Additional Services Active Call Move Options to move the call: o o Move Call to Desk Move call from Cellular Transfer Two options for transferring a call: o o Immediate Dial the number to which you want the call transferred. Consult Dial the number to which you want the call transferred and wait for the party to answer the phone. A pop-up Transfer Progress screen is presented with the following prompts: Dismiss Cancel Transfer Complete Transfer Revision April 2018 CONFIDENTIAL Page 15 of 21

16 Call Services Menu The Call Services menu offers similar functionality as the CallInfo Widget inside the Communicator app. Figure 19 Call Services Menu Move From Desk You must have an active desk call in progress to initiate a Move From Desk. Access the Call Services menu and select Move From Desk and the call will transfer to your Communicator app. Move From Cellular Allows you to move a call from the cellular network to VoIP using the Communicator app. During Active Call During an active app call you can move the call or transfer it to another number. Figure 20 Additional Call Services Active Call Move Move call to cellular. This option allows you to move the call from the cellular network to VoIP using the app. Revision April 2018 CONFIDENTIAL Page 16 of 21

17 Transfer Two options for transferring a call: o o Immediate Dial the number to which you want the call transferred. Consult Dial the number to which you want the call transferred and wait for the party to answer the phone. A pop-up Transfer Progress screen is presented with the following prompts: Dismiss Cancel Transfer Complete Transfer Interactions with 2 Stage Dialing When your Mobile Communicator app is set to 2 Stage Dialing, you will see a message on your iphone that shows the number you originally dialed preceded by the 2 Stage access number. Figure 21 shows if your iphone is configured for 2 Stage dialing. You may have other options selected but we re interested in the 2 Stage dialing option for now. Figure 21 Stage Dialing Settings Option Look at Figure 22. The original dialed number is Dallas Time & Temperature phone number The pop up message on the iphone shows a slightly different number than the one you dialed. Notice that the call is preceded with another number that you may not recognize. When configured as 2 Stage dialing, the app makes a call to the Accelerator first and then out pulses the original dialed digits. As the end user, you will hear the call ring, then answer, and then you will hear a of DTMF tones representing the number you dialed. Revision April 2018 CONFIDENTIAL Page 17 of 21

18 Figure 22 Stage Dialing After the call is finished, you will notice a Temporary Pilot entry in your call History. This entry is not meant to be dialed or redialed. Finding the Temporary Pilot in your listing indicates that your call had to first contact the Accelerator before calling the number you dialed 2 Stage Dialing. Figure 23 Stage Dialing Temporary Pilot Revision April 2018 CONFIDENTIAL Page 18 of 21

19 Accelerator Server-Side Interactions Call Delivery Notification Prior to the 8.0 release, the Accelerator would send a SIP NOTIFY request for call delivery information. If there was no response, the Accelerator would fall back to sending a PUSH notification containing the same information. This feature bypasses the SIP NOTIFY message and sends only the PUSH message for call delivery notifications. Disconnect Notification In general, the call delivery notification should have a corresponding disconnect notification. Prior to 8.0, these were sent as a SIP NOTIFY and the client would remain registered throughout the call. This feature converts the disconnect notifications to use PUSH messages. Terminations VoIP Client Terminations VoIP terminations begin with the receipt of the Incoming Call Notification PUSH message. When the Communicator app has VoIP enabled, the Incoming Call Notification will drive the app to re-register so that it can receive the SIP INVITE for the incoming VoIP call. When the Communicator app is in the background not an active app the client is not registered. The app wakes up and registers the client. Registration Timer After sending the call delivery notification, call processing will suspend until the client registers or the reregistration timer expires. The default value for ios devices is every 700 seconds. Non-iOS devices have a 600 second timer. Non-VoIP Client Terminations For non-voip terminations, the only change will be sending a PUSH notification instead of a SIP NOTIFY. The rest of the call is unaffected by this feature. There is no registration timer and call processing continues immediately. Registration Failure The client could attempt to register but fail authentication, or it could never send a register at all. In these cases, calls are routed to the PSTN.

20 Client Originations The client must be registered in order to originate a call in the first place. It may or may not reregister after the call delivery notification, but for originations, this does not affect the call flow. Revision April 2018 CONFIDENTIAL Page 2 of 21

21 Tango Networks, Inc Network Blvd, Suite 200 Frisco, TX USA phone: fax: