Bria 4 for Windows User Guide Retail Deployments
CounterPath Corporation CounterPath Corporation Suite 300, One Bentall Centre 505 Burrard Street, Box 95 Vancouver, BC V7X 1M3 Tel: 604.320.3344 sales@counterpath.com www.counterpath.com © August 2014 CounterPath Corporation. All rights reserved. This document contains information proprietary to CounterPath Corporation, and shall not be used for engineering, design, procurement, or manufacture, in whole or in part, without the consent of CounterPath Corporation.
Contents Introduction................................................................................................................................ 1 Installation and Setup................................................................................................................. 3 Getting Ready ...................................................................................................................... 3 Starting Bria .........................................................................
CounterPath Corporation ii
1 Introduction Read this manual if you who are deploying Bria without the help of a system administrator. (If, on the other hand, you are working in an enterprise that has a system administrator who is deploying Bria across the enterprise, read the user guide “Using Bria 4 for Windows – for Enterprise Deployments”.) Bria is a softphone from CounterPath that enables you to make VoIP voice and video calls, send and receive instant messages, share online status (presence) information, and exchange files.
CounterPath Corporation • Support for the following audio codecs (not all these codecs are included in the retail brands): Broadvoice-32, G.711aLaw, G.711uLaw, G.722, G.729, iLBC, OPUS, SILK narrowband, SILK wideband, SILK super-wideband, Speex, Speex Wideband. • Support for the following video codecs: H.263, H.263+ 1998, H.264, VP8. • Support for these firewall traversal solutions: STUN, TURN, or ICE.
2 Installation and Setup 2.1 Getting Ready SIP Account Information After choosing a VoIP service provider, you will need the following information: • • • • User name and domain. For example, 1331@domainA.com. Password Authorization Name (if applicable) Firewall traversal and other network information; see page 75. XMPP Accounts If you use an XMPP service for instant messaging or presence, you will need the following information: • • • Jabber ID: user name and domain. For example, jsantos@domainXMPP.com.
CounterPath Corporation Set the profile to “I will manually input my account configuration” and click Continue. The softphone GUI appears. (Login is used only in enterprise deployments in which a system administrator has set up a provisioning server to automatically configure Bria for you.) Subsequent Startups After the first-time startup, the Bria Login dialog will not appear if you selected the “No login” profile.
Bria 4 for Windows User Guide – Retail Deployments 2.3 Configuring Bria Setting up Accounts After obtaining SIP account information from your VoIP service provider, you can set up Bria accounts. Set up the SIP Account 1. When the softphone appears, click the Go to Account Settings link. The SIP Account window appears. 2. In the Account tab, complete the User Details area with the information obtained from your VoIP service provider. 3.
CounterPath Corporation Populating your Contact List Typically, you will want to create contacts in order to easily make phone calls, send IMs and transfer files. You can bring in contacts from other sources: • • From a file such as a vCard or comma-separated-values (CSV) file. See page 51. From your Microsoft® Outlook® address book. See page 84. In addition: • 6 During a call that you place or receive, you can add the other party to your contact list. See “Handling an Established Call” on page 17.
Bria 4 for Windows User Guide – Retail Deployments • You can add addresses to the Contact list one by one. See page 53. For general information on contacts, see page 49. 2.4 Troubleshooting Bria includes these tools for helping you troubleshoot problems: • • • • You can verify that your microphone, speakers and camera are working and can set the volume to a comfortable level without having to actually place a phone call. You can verify that you are successfully connected to the network.
CounterPath Corporation 3. Name a file, and click Save. Bria creates a text file with all the keys listed. 4. Transfer the text file to a new computer. 5. On the new computer, start Bria and choose Help > Enter License Key. 6. Click Import Keys, and choose the text file that contains the license keys. The keys appear in the dialog. 7. Click Done.
3 Making Phone Calls 3.1 Starting and Quitting Bria If Bria is not already running, start it as you would any other program: Use the Windows Start menu or double-click the desktop icon. Bria appears. To quit Bria, choose Softphone > Exit or press Ctrl-Q. 3.2 The Onscreen Softphone Show/hide resources such as contacts, favorites and modules such as chat rooms and workgroup Change layout of contact list and import contacts Close to system tray.
CounterPath Corporation The Bria Menu Softphone. • • • • Accounts. These settings control how Bria interacts with your VoIP service provider and are set individually for each account. See “Configuring Accounts” on page 67. Preferences. These settings control the way that you work with Bria and apply to all accounts. See “Configuring Preferences” on page 86. Log Out. To log off and minimize Bria to the system tray. If you click the Bria icon in the status bar, the Login screen appears.
Bria 4 for Windows User Guide – Retail Deployments 3.3 Placing a Call Place the call as described in the table below. The outgoing call opens in its own call panel, below any other existing call panels. You will hear a ringing tone while Bria attempts to make a connection. Option Keying From the... Dialpad or computer keyboard Description 1. Enter the phone number in the call entry field using the dialpad or the computer keyboard.
CounterPath Corporation Make sure you are on the Phone tab to place a call. Call entry field The Call icon. Clicking the down arrow gives you more call options, such as video call or conference call. Auto complete suggestions. Bria makes a call as soon as you choose the suggestion. You can change this behavior so Bria does not dial until the Call button is pressed (page 86). For information on working with the call, see “Handling an Established Call” on page 17.
Bria 4 for Windows User Guide – Retail Deployments Selecting the Account to Use This information applies only if you have more than one SIP account set up and enabled. When you place a call, you can explicitly specify the account to use for that call. The account selection options appear only if you have two or more SIP accounts that are enabled and being used for phone calls.
CounterPath Corporation Hiding your Identity (Anonymous Calling) You can hide your identity on a call, so that the other person will not see your name or number on their phone. Your ID will be hidden for all outgoing calls until you turn off Hide my Number. Anonymous calling is automatically turned off when you shut down or log off. Turn Hide my Number on or off Placing another Call You can place another call. On Bria, you can make up to five concurrent calls.
Bria 4 for Windows User Guide – Retail Deployments 3.4 Handling Incoming Calls Bria must be running to answer incoming calls. It can be running in the system tray.(If Bria is not running, incoming calls may be directed to voicemail; check with your VoIP service provider.) The new call appears in its own call panel. In addition, the Call Alert box appears. For information on setting call alert preferences, see page 87. Click. If you are on another call, that first call is automatically put on hold.
CounterPath Corporation Auto Answer Turn Auto Answer on or off Auto answer is initially configured to auto-answer after one ring, and to send only your audio when the call is established. To change this configuration choose Softphone > Preferences > Calls. Auto answer is automatically turned off when you shut down. Disabling Call Waiting You can turn on Disable Call Waiting. If on, when you are on a call, any new incoming call will go straight to voicemail or will ring as busy (to the caller).
Bria 4 for Windows User Guide – Retail Deployments 3.5 Handling an Established Call Use speakerphone (when yellow) or headset (when gray) Mute speaker or adjust speaker volume by using slider You can disable call waiting. See the previous page.
CounterPath Corporation Encryption The outgoing call may be encrypted, depending on your security settings. For information on the current security settings, see “SIP Account Properties – Transport” on page 80. • • • If an encrypted call is established, the security lock icon appears on the call display. This icon indicates that the call is guaranteed to be secure between you and your proxy, and may or may not be secure beyond that first hop. See page 80 for more details on how encryption works.
Bria 4 for Windows User Guide – Retail Deployments 3.6 Transfering a Call Basic (Unattended) Transfer – Transfer this Call Click the Transfer button The call is put on hold and a call entry field appears. If the button does not show “Transfer now”, click the down arrow and select Transfer now. You can also permanently change the option that appears on the button; see page 86. Type a name or number, or drag a contact into the field. Then click Transfer Now. The call may end immediately.
CounterPath Corporation Attended Transfer – Call then Transfer You can first speak to the target (the person you are transferring the call to), then click Transfer Now to complete the transfer. Click the Transfer button The call is put on hold and a call entry field appears If the button does not show “Call first”, click the down arrow and select Call First. You can also permanently change the option that appears on the button; see page 86.
Bria 4 for Windows User Guide – Retail Deployments 3.7 Handling Video Calls Placing a Video Call Calls made with Bria will work without a video camera, but a video camera is necessary to allow other parties to see your image. Bria will work with most USB video cameras. From the Dashboard Click the down arrow and choose Video call From the Contact List or History Right-click the contact and Choose Video Call Adding Video If you have a camera, you can add video to a call that started as an audio call.
CounterPath Corporation Pausing and Resuming Video Click Stop Video in the call panel or close the video window to pause sending your video. Click Start Video to resume sending your video; the video window will open. To view in full screen, hover over the video window and click the two-way arrow icon, or press F11 when the focus is on the video window.
Bria 4 for Windows User Guide – Retail Deployments 3.8 Conference Calls Starting a Conference Call You can start a conference call by: • • • making a conference call from the dashboard, adding participants to an existing established call, or having two established calls and merging them to a conference call.
CounterPath Corporation From an Existing Call From One Established Call You can add more participants From Two Established Calls You can merge two established calls. “Invite to Conference Call” will allows you to add a third person to the call with Rita.
Bria 4 for Windows User Guide – Retail Deployments Managing the Conference Click the arrow for Participant menu Adding More Participants You can add more participants to an existing conference in any of these ways: • • • Right-click on a contact or history item and choose Add to Conference Call. In the conference call panel, click Invite to Conference Call, enter a name and click Add.
CounterPath Corporation Video Conference Calls Calls made with Bria will work without a video camera, but a video camera is necessary to allow other parties to see your image. Bria will work with most USB video cameras. This person has video. This person does not have video. To remedy this situation, stop video and start it again. Video will be sent to all the current participants. Closing the video window stops sending video. Mute.
Bria 4 for Windows User Guide – Retail Deployments 3.9 Voicemail If your service includes voicemail and you have set up voicemail options (page 73), you can click the icon to automatically connect to voicemail and listen to any messages. Voicemail icon 3.10 Forwarding Calls Forwarding Calls You can enable or disable forwarding so that calls will be automatically forwarded to another number.
CounterPath Corporation 3.11 Viewing Your Workgroup The workgroup gives you a detailed view of phone-related activity for a team. The workgroup feature must be set up before it can be used; see “SIP Account Properties – Presence” on page 76. Once this is done, choose View > Workgroup to view your workgroup. The Workgroup window supports many of the same features as the contact list. Monitor, Pick up and Join Incoming Call A member is receiving an incoming call Click to pick up this call.
Bria 4 for Windows User Guide – Retail Deployments Established Call and Joining that Call A member is on an established incoming or outgoing call Click to join this established call. An outgoing call will be placed. If the other person accepts the request, you will immediately join the call and be talking to all the parties. Receiving a Request to Join Another member of your workgroup may request to join one of your phone calls. The request appears within the current call panel.
CounterPath Corporation 30
Bria 4 for Windows User Guide – Retail Deployments 4 Other Bria Features 4.1 Instant Messaging Sending an IM 1. You can send an IM to a contact who has a softphone or XMPP address. From the Contacts tab Right-click on the contact and choose Send Instant Message. The contact must have a softphone address. Or click on the IM icon that appears to the right of the contact name. An active phone call If the person is a contact, choose Send Instant Message from the call panel menu.
CounterPath Corporation Receiving an IM When an IM is received, either the Messages window or a Call Alert pops up. (To control which window appears, choose Softphone > Preferences > Alerts & Sounds.
Bria 4 for Windows User Guide – Retail Deployments 4.2 Sending a Broadcast IM You can send an IM to several people at one time. A broadcast IM is not a group chat: • • With a broadcast IM, each recipient can reply to the IM, but only you will see these replies; the other recipients will not see these replies. With a group chat, all parties see everyone’s messages and the messages each party sends are seen by everyone. See “Group Chat (Conference IM)” on page 34. 1.
CounterPath Corporation 4.3 Group Chat (Conference IM) Group chat allows you to exchange instant messages with a group of people in the same session. All people must have XMPP accounts configured in order to participate in group chat. There is no limit to the number of participants in a group chat session. Starting a Group Chat 1. In the Contacts tab, select the desired contacts. Contacts must be online. 2. Right-click the last selected contact and choose Start Group Chat. The invitation dialog appears.
Bria 4 for Windows User Guide – Retail Deployments Managing a Group Chat Leaving a Group Chat Unregistering your XMPPP account or exiting Bria lets you leave all the active group chat sessions. The session continues with the remaining participants. Once you leave a group chat, you will not be able to rejoin the session. The thread in the Messages window becomes inactive (grayed out); you can read chat history, but cannot participate or download unread messages.
CounterPath Corporation 4.4 Chat Rooms Typically, chat rooms are used only in enterprises and are set up by the system administrator.
Bria 4 for Windows User Guide – Retail Deployments 4.5 Viewing Messages To view your recent IM activity for any contact, group chat session, or chat room session, perform one of these actions: • Click the Messages window icon: • • Click Shift + Ctrl +M. On the menu, click View > Messages. Search all messages Clicking the x icon deletes the session. You can copy the messages. Right-click to save or delete a conversation. The session may be grayed out.
CounterPath Corporation 4.6 Sending and Receiving Files Sending Files If you have an XMPP account, you can send files to another contact who has a Jabber address (meaning that they have an XMPP account). Choose one of these actions: • • Right-click a contact and choose Send Files; a standard Open dialog box opens. Select the files to send and click Open. Drag a file from a folder to the IM session of the Messages window. The Send Files dialog appears with a “waiting” message.
Bria 4 for Windows User Guide – Retail Deployments 4.7 Sharing your Screen The Screen Share Add-in lets you share your screen with other people, both other Bria users and people who are not Bria users. You do not need to obtain the Screen Share Add-in in order to view someone else’s screen; you only need it if you want to share your screen. Obtaining the Screen Share Add-in 1.
CounterPath Corporation 4. Restart Bria. 5. On Bria, choose View > Show Screen Share. The Screen Share tab appears.
Bria 4 for Windows User Guide – Retail Deployments Inviting Participants There are several ways to invite participants. Whichever method you use, people who you invited by IM and who are Bria users will receive the invitation as an IM in the Messages window; see page 48. Other users will receive a screen share link that they can click or can paste into a web browser in order to join the session. Inviting by Selecting Contacts You can invite people by selecting contacts from Contacts or Favorites.
CounterPath Corporation Inviting by Sending an Email You can invite any participants by email. The invitees do not need to be Bria users and do not need to be contacts. With this method, the screen share session does not start immediately, which means you can use this method to publish your screen share link for future use. See page 47 for more information. Click Invite Click email The Send Email dialog for your email editor appears. Enter the email addresses of the participants and send the email.
Bria 4 for Windows User Guide – Retail Deployments Inviting by Sending an IM to Contacts You can invite any participants by sending an IM to contacts you specify on the invitation. The invitees do not need to be Bria users. They do not need to be contacts but they must have an address that is IM-able, so either a softphone number or a SIP or XMPP IM address.
CounterPath Corporation Inviting by Copying and Manually Pasting the Screen Share Link You can copy the screen share link to the clipboard and then send the link to invitees using whatever method you want. The invitees do not need to be Bria users. With this method, the screen share session does not start immediately, which means you can use this method to publish your screen share link for future use. See page 47 for more information. Click Invite Click clipboard The Messages dialog appears.
Bria 4 for Windows User Guide – Retail Deployments Starting a Session If you invite people and choose not to start the session immediately, you can start it whenever you are ready by clicking the Start button. Participants will see your screen as soon as they open a browser to the Screen Share link that you provided to them.
CounterPath Corporation Managing a Session Some invitees and all participants appear in the Screen Share tab. A person you invited by selecting from the Contacts or Favorites appears in this list as soon as you invite them. When they accept the invitation, their status changes from Invited to Joined A person you invited in one of the other ways appears only after they accept the invitation. The name that appears is the name they enter in the join dialog.
Bria 4 for Windows User Guide – Retail Deployments Managing the Screen Share Link When you send an invitation, Bria generates a Screen Share link that includes a session ID: http://join.softphone.com/ABCDEFGHIJKLM The session ID portion of the link (ABCDEFGHIJKLM in the above example) is unique to you as a user. Each time you send an invitation, this session ID will be used. A new session ID will not be generated.
CounterPath Corporation Receiving an Invitation If you are a Bria user, you can receive an invitation to join a screen share from another Bria user who has the Screen Share Add-in. You do not need to have the Add-in in order to receive an invitation.
5 The Contacts Tab The Contacts tab displays your contacts. Each contact is shown with presence information and icons for singleclick phoning and IMing. If the Contacts tab is not showing, go to the main menu and choose View > Show Contacts. Search entire contact list Move the list back to main window Add a Contact Contacts are typically organized into groups. Bria includes built-in groups. You can add more groups, as desired. The online status of others.
CounterPath Corporation 5.1 Populating the Contact List At any time, but particularly when you first deploy Bria, you may want to populate the contact list with contacts from an external source such as a file of contacts or contacts in your Outlook address book. Populating From the Microsoft Outlook Address Book You can populate the Bria contact list by pulling in the contacts from your Microsoft® Outlook® contacts. Create an Outlook account: from the main menu choose Softphone > Account Settings.
Bria 4 for Windows User Guide – Retail Deployments Populating by Importing Contacts You can populate the Bria contact list by importing from an external file or files. The new contacts will be added to the existing contacts. You can import a contact list from: • • • CSV. A comma-separated file. Use this method to import from a Microsoft® Excel® file. You will first have to set up the file; see below. vCard. A vCard file (*.vcf file).
CounterPath Corporation • 52 All information in the Bria contact list is exported to Microsoft Outlook. Only information that can be displayed in Outlook actually appears in the Outlook Contacts window. Typically this means that all softphone addresses are exported (and stored in custom fields) but not displayed in Outlook. For other formats, a new file of the specified type is created.
Bria 4 for Windows User Guide – Retail Deployments 5.2 Managing Contacts and Groups Adding a Contact Click , or right-click a group and choose Add Contact to Group. The Contact Profile dialog appears. To enter a phone number, select the type, enter the number, and click Add The new number appears in the list Field Description Contact Summary Display as If several display names are available, choose the one that you want to show in the contact list. Group Click to show the list of groups.
CounterPath Corporation Field Presence Description This field is automatically populated when you enter an address in the Softphone or Instant Message field. It indicates that you are sharing online presence information using this address. The address is also shown in the list in the Primary presence field, above. Example – Contact with a Softphone Number This example shows how to add a contact when your VoIP service supports online availability via your SIP account.
Bria 4 for Windows User Guide – Retail Deployments Example – Contact with an XMPP Address This example shows how to add a contact who has an XMPP address (for example, a Gmail address). Assuming you have created a corresponding XMPP account in Bria (for example, an XMPP account for your Gmail address), then you can send this person IMs and share online status. Enter the XMPP address in the Instant Message field. Include the domain (e.g. @gmail.
CounterPath Corporation Adding a Contact Using an Existing Address You can add a contact by capturing existing information: • • If you are on a phone call with a non-contact, click the Add to Contacts button in the call panel. On the History tab, select an entry that is not a contact. Right-click and choose Add as Contact. The Contact Profile dialog appears. Complete the dialog as desired and press OK. If the contact method is Softphone or Jabber, an online status request is sent to this person.
Bria 4 for Windows User Guide – Retail Deployments 5.3 Using Contacts Double-click to phone or IM (depending on how doubleclicking is configured in Preferences > Application). Hover to reveal icons. Click the phone icon to call using the primary phone number. Or click the IM icon to send an IM using the primary presence address for this contact. Or right-click and choose from the menu.
CounterPath Corporation 5.4 Sharing Online Status You can publish your online status to contacts who have softphone address, and you can set up Bria to view the online status of other contacts. Typical online statuses are available, on the phone, busy, and so on.
Bria 4 for Windows User Guide – Retail Deployments Sharing Online Status Watching Others’ Status To watch a contact’s status, that contact must be tagged for presence: • • • • • If you create a contact via the Contact Profile and you include a SIP address in the Softphone field, Bria will automatically obtain status information for this address.
CounterPath Corporation You must respond to the request: Option Button Comment Result Create a new contact Allow This option is selected for you if you do not currently have a contact with this SIP or XMPP address. Allow the request and create a new contact using this address. Update an Allow existing contact Either option Block This option is selected for you if you already have a contact with this SIP or XMPP address but you were not previously sharing your online status with this person.
Bria 4 for Windows User Guide – Retail Deployments Setting your Online Status Changing your Status Click the down arrow beside the online status indicator on Bria, and select the desired online status. Setting up Status Indicators You can create a custom status indicator: click the down arrow beside the status indicator, and double-click on one of the existing indicators; type your custom status.
CounterPath Corporation Indicator Meaning for your Status Meaning for Others’ Status The contact is either not logged on Appear offline You have set your status to this value. The other person sees you as offline, even though you are actually online. The other person cannot or does not want to share online status. tell the difference between this status and you really being offline. No icon 62 Not applicable You are not watching the other person’s status.
Bria 4 for Windows User Guide – Retail Deployments Adding Contacts to the Alert List (Buddy Pounce) You can add a contact to the Alert List in order to request to be notified when the online status of a contact changes. Right-click the contact or contacts and choose Add to Alert List. The Alert List icon appears beside the contact: Alert List icon When the contact’s status changes, a notification appears.
CounterPath Corporation 5.5 Privacy You can control how contacts and other people can contact you by phone or IM, and you can control whether your contacts can see your presence information (whether you are online, on the phone, and so on). You can set up controls in advance or “on the fly” (as phone calls and presence requests come in). Setting up Controls ahead of Time To set up controls ahead of time, see page 88.
6 Using Other Resources 6.1 History Tab To view the History tab, go to the main menu and choose View > Show History. Attach to main window Filter list Green: Outgoing call, either attempted or established Blue: Incoming call that was answered Red: Incoming missed call Managing the Lists of Calls You can right-click on an entry in a list to: • • • • • Delete the entry. Delete all entries in the list.
CounterPath Corporation 6.2 Favorites Tab You can create favorites from your contact list. They will be displayed in both the Contacts tab and in the Favorites tab. Select the desired contacts, then right-click and choose Add to Favorites. To view the Favorites tab, go to the main menu and choose View > Show Favorites. You can perform nearly all the same actions on the contact in the Favorites tab as you can in the Contacts tab.
7 Configuring Bria 7.1 Configuring Accounts Accounts Settings Window To work with accounts, choose Softphone > Account Settings from the menu. The Account Settings window appears, showing all the accounts set up. From this window you can add (create), enable or disable, edit, or remove a SIP, XMPP or Outlook account. Here is a typical setup Your main SIP account Another SIP account Your own Gmail account An Outlook account. This account is automatically created for you in some situations; see page 84.
CounterPath Corporation • Bria contact list. You can then IM these contacts directly from Bria. To create an XMPP account, see page 69. For information on the Outlook account, see page 84. The account is the “preferred account”. The account can be used for phone calls by selecting it on the dashboard (page 13) if the account is enabled/registered. The account cannot be used for phone calls because it is either a non-SIP account or a SIP account with calling disabled.
Bria 4 for Windows User Guide – Retail Deployments XMPP Account You create an XMPP account if, for example, you already have an XMPP account independent of Bria (for example, a Gmail account). Fields with a red asterisk are required Table 1: XMPP Account Properties – Account Field Account name Protocol Description If desired, change the account name to something that is meaningful to you. For example, the type of XMPP account such as “Gmail account”. Read-only. Always specifies XMPP.
CounterPath Corporation Table 1: XMPP Account Properties – Account Field Resource Priority 70 Description Optional resource, as specified in RFC 3920. For example “/home”. If this setting is blank and the User ID includes a resource, the value from that ID is used. If both are specified, the value from this Resource field is used. If no resource is specified, the XMPP server will assign a temporary resource. The priority, as per RFC 3921. The default is 0.
Bria 4 for Windows User Guide – Retail Deployments SIP Account Properties – Account Fields with a red asterisk are required Table 2: SIP Account Properties – Account Field Account name Protocol Use for Call Use for IM/Presence Description If desired, change the account name to something that is meaningful to you. For example, the name of the VoIP service provider. Read-only. Always specifies SIP. If checked, this account is eligible to be used for phone calls.
CounterPath Corporation Table 2: SIP Account Properties – Account Field Description Domain Proxy Register with domain and receive Check this box if you want to register with your VoIP service provider, so that you can receive calls incoming calls. Typically, this field is checked. Send outbound via This field must be left unchecked if, for example, your level of service does not include the ability to receive incoming calls.
Bria 4 for Windows User Guide – Retail Deployments SIP Account Properties – Voicemail These settings let you set up to interact with your VoIP service provider’s voicemail service. They also let you configure Bria to forward calls in several situations, independent of your VoIP service provider’s voicemail service. Your service provider may provide the ability to set up for voicemail outside of Bria, for example, by phoning a softphone address and following the voice prompts, or by accessing a website.
CounterPath Corporation Table 3: SIP Account Properties – Voicemail Field Number for sending calls to voicemail Description Complete only if your VoIP service includes voicemail. Optional, but you must complete it if you check “Send calls to voicemail if unanswered”. This is the number that incoming calls will be forwarded to if they are unanswered after the specified interval (below). If you leave this field empty, then Bria will never forward calls to your service providers’ voicemail.
Bria 4 for Windows User Guide – Retail Deployments SIP Account Properties – Topology Table 4: SIP Account Properties – Topology Field Firewall traversal mode Description Choose the setting recommended by your VoIP service provider: • Auto detect using ICE: Automatically determine the contact address for signaling traffic. Advertise the local IP, public IP (discovered via STUN, if available) and media relay IP and use these to automatically determine the best route for media traffic during calls.
CounterPath Corporation SIP Account Properties – Presence This tab lets you configure presence and workgroups. Presence Presence allows other softphone users to see your online status and allows you to see the online status of others. This tab lets you configure how online status is handled for contacts who have a softphone number on your SIP account. (Note that you do not have to configure online status for XMPP accounts; it always works the same way with these accounts.
Bria 4 for Windows User Guide – Retail Deployments Setting up Workgroups in Peer-to-Peer Mode In this mode, you add people who you want to share with. Typically, everyone in a group will informally agree to add each other to their group so that everyone’s setup contains the same workgroup members. 1. Set the Mode to Peer-to-peer. 2. Select the monitoring method: • • Allow anyone to monitor my call activity: if you want everyone in the workgroup to monitor you. Normally, you choose this mode.
CounterPath Corporation When you display the Workgroup (View > Workgroup from the main menu), the members will appear. This person is in your group and you are in her group. You are watching each other This person is shaded out.
Bria 4 for Windows User Guide – Retail Deployments SIP Account Properties – Storage Typically, you leave the storage method as Local. However, if your VoIP service provider provides access to an XCap or WebDav server, you can choose to store some contact data on that server. The following contact data gets stored on the server: • • Softphone numbers and display names from contacts created manually or from a corporate directory or by importing from a file.
CounterPath Corporation SIP Account Properties – Transport Table 7: SIP Account Properties – Transport Field Signaling Transport Encryption Enable IPv6 Description Contact your VoIP service provider to identify the types of transport that are supported. Then choose a supported transport: • Automatic: Bria sets up the transport based on the capabilities of the network and the Bria computer. Choose this option if you do not care which transport is used.
Bria 4 for Windows User Guide – Retail Deployments Setting up for Security within Bria The options for media encryption are described in the following table. Table 8: Security Options Option Make and accept only encrypted calls Do not allow encrypted call How Outgoing Calls are Handled How Incoming Calls Are Handled Bria will place all calls with TLS. The call INVITE Bria will only accept INVITEs that are for encrypted calls. will specify SRTP media encryption.
CounterPath Corporation SIP Account Properties – Advanced Table 9: SIP Account Properties – Advanced Field Description Register Settings Reregister every Minimum time Maximum time The time interval between Bria’s attempts to reregister in order to refresh the account registration with the VoIP service provider for this account. A value of zero means not to reregister after the initial registration. This value is placed in the “Expires” header field of the REGISTER message.
Bria 4 for Windows User Guide – Retail Deployments Table 9: SIP Account Properties – Advanced Field Session timer preference Description This field specifies your preference for which party should send the refresh. The preference is not a guarantee that the refresh will be performed by the specified party. The choices are: • • • • Hold Method Send SIP keep-alives Use rport Send outgoing request directly to target None: No preference. Local refreshes: Your computer sends.
CounterPath Corporation Outlook Account Bria automatically creates an Outlook account if it detects Outlook on your computer. If you are using 32-bit Outlook, you can enable the Outlook account to provide Bria with access to the contacts in your Outlook address book. When the account is enabled, your Outlook contacts will be automatically pulled into your Bria contact list so that you can easily phone and IM them. L The Outlook account is supported only with 32-bit Outlook.
Bria 4 for Windows User Guide – Retail Deployments Table 10: Outlook Account Properties – Account Field Field to use for Softphone address Description Bria can be set up to treat one of the contact fields as a SIP address that can be subscribed to, assuming that you are using your SIP account for presence.
CounterPath Corporation 7.2 Configuring Preferences Choose Softphone > Preferences. The Preferences window appears. The Preferences panels let you control the way that you work with Bria. Preferences – Application This panel lets you set your preferences for general GUI behavior and lets you set up for login. Login Options Login is typically used only in enterprises. You should not enable login.
Bria 4 for Windows User Guide – Retail Deployments Preferences – Alerts & Sounds The tabs on this panel let you control the Call Alerts box and lets you assign sounds. Alerts You can control whether the Call Alert box is displayed in different situations. You can also control how you are alerted to an incoming IM: either with a small IM Alert box or with the Messages window itself. Windows 7 and Earlier Windows 8 Sounds You can assign specific sounds to a variety of actions or “events”. 1.
CounterPath Corporation Preferences – Privacy You can control how contacts and other people can contact you by phone or IM, and you can control whether your contacts can see your online status. General Tab In “Global Contact Settings”, choose one option. If you choose “Everybody except...”, then all contacts will be able to contact you unless they or their domain are in the Blocked list (below). The “Blocked” section is optional.
Bria 4 for Windows User Guide – Retail Deployments Preferences – Devices Bria automatically detects devices at each startup, and selects the most appropriate device for each purpose. If you do not like this selection, you can override it on this panel. If you override a selection, it will apply the next time you start Bria, unless the device is no longer available, in which case Bria will again select the device to use.
CounterPath Corporation Table 11: Preferences – Devices Field Description Speakerphone Mode Speaker Same as headset mode, but for the device to use when speakerphone is one (on the toolbar). Microphone Select None if you do not have a speaker phone. The Speaker Phone button on the dialpad will be disabled. You can set different devices for the speaker and microphone: for example, you can set the speaker to the speakerphone and set the microphone to your headset. HID Device Same as headset mode.
Bria 4 for Windows User Guide – Retail Deployments Preferences – Shortcut Keys You can enable shortcut keys to several functions. Click to enable shortcut keys. Then make sure the individual actions are enabled Customizing the Shortcut Key Combinations You can change the default key combinations. 1. Make sure Enable shortcut keys is checked and the action you want to change is enabled. 2. Select an Action and click Edit. The Edit Shortcut Key dialog appears. 3.
CounterPath Corporation Preferences – Audio Codecs This panel shows all the codecs that are included in the retail version of Bria. You can enable or disable codecs as desired. With only one codec enabled, all calls made will use that codec. With more than one codec enabled, Bria offers the enabled codecs and negotiates a common codec with the other party. You cannot change the properties of any codecs.
Bria 4 for Windows User Guide – Retail Deployments Preferences – Video Codecs Video codecs describe the format by which video streams are compressed for transmission over networks. Some codecs require less bandwidth than others, but may result in lower video quality. You can enable or disable codecs as desired. You may decide to disable a codec even though your VoIP service provider supports it. With only one codec enabled, all calls made will use that particular compression format.
CounterPath Corporation Preferences – Directory Typically, directories are used only in enterprises and are set up by the system administrator.
Bria 4 for Windows User Guide – Retail Deployments Preferences – Calls Table 12: Preferences – Calls Field Description Calls These settings let you configure how you want auto answer to handle incoming calls, when Auto Answer is enabled. (To enable Auto Answer, see page 16) DTMF You may need to change the DTMF configuration if you cannot interact with interactive voice response systems (auto attendants, voice-activated menus, and so on). Contact your VoIP service provider for the correct setting.
CounterPath Corporation Preferences – Files & Web Tabs Table 13: Preferences – Files & Web Tabs Field Description Recording folder The folder where files for recording of phone calls will be saved. File transfer folder The folder where received files will be saved. Web Page Tabs You can set up a web page as a new tab in the Resources panel; it will appear alongside Contacts, History and so on. Enter the web address and a name (this name will be appear in the tab).
A Troubleshooting Choose Help > Troubleshooting to display the Troubleshooting window. Testing Audio Devices You can verify that your microphone and speakers are working and can set the volume to a comfortable level without having to actually place a phone call.
CounterPath Corporation Testing Audio Quality While you are on a phone call, you can test the quality of the audio. Note that to perform a valid test, you should be on an established call (not a call attempt).
Diagnostics If you have contacted CounterPath Customer Support in order to troubleshoot a problem, you may be asked to generate a diagnostic log and send it to CounterPath. Click Select the problem you are experiencing Click to start logging Click to close. Perform the actions you want to capture When done, click Advanced Logging again. Click to stop logging Then click to send a log file.
CounterPath Corporation B Application Hot Keys Category Making or answering a call Function Keyboard Shortcut Answer an incoming call Ctrl + N Decline an incoming call Ctrl + D Redial the last dialed number Ctrl + R or Ctrl + R then Enter End the call Ctrl + E End the conference call (hang up on all participants) During a call Mute your voice during a call Ctrl + M Hold or resume the call when the focus is on Ctrl + H this call panel Transfer an established call when the focus is Ctrl + T on
Bria 4 for Windows User Guide – Retail Deployments C Dial Plan When a call attempt is made, the call input (what you type or select or drag onto the call entry field) is processed to select the SIP account to use and to modify the input if that is required to ensure that the call gets placed successfully. This ability to select an account and modify the input relies on the existence of a “dial plan” for each account.
Pattern Valid Content The content for a pattern follows the digit map rules of RFC 2705, supplemented by the rules for regular expressions. Where there is an overlap between the digit map and regular expression rules, the digit map rules apply. For this reason, there are some special cases, included in the table below. The following table describes the most common elements. As mentioned, all regular expression elements are supported. Some elements use the back slash \ character.
Transformation Keywords Keyword Description prestrip Strip the first n characters from the input before placing the call. poststrip Remove n number of characters from the end of the input before placing the call. pre Add the specified account prefix to the input before placing the call. post Attach the specified postfix to the input before placing the call. replace Replaces the input with the specified string before placing the call.
C.1 How the Input Is Processed Comparing Input to the Dial Plan Patterns The input is compared to each dial plan in turn, starting with the first listed account. The process is slightly different depending on how the call is placed: • • If the input was dragged or selected, then the entire input is compared to each dial plan. If a complete match is found, then that account is selected and the associated transformation is performed.
C.2 Examples Example 1 \a\a.T|xxxxxxx.T;match=2;pre="9" This simple example shows how to differentiate between a PSTN number and a softphone address, and how to add a “9” dialing prefix only to the PSTN number. Example 2 3xxT|1xxxxxxxxxx|[2-9]xxxxxxxxx|+x.T;match=2;pre="9"; match=3;pre="91";match=4;prestrip=1;pre="9011" 3xxT The first pattern is any three-digit number beginning with 3. No transformation. The assumption is that this is an internal extension.
• Handling of the account prefix (#1), if you are upgrading from Bria 1.1 and are accustomed to entering the account number. Use of # to identify the account is now deprecated. The dial plan should be capable of determining the account to use for this number. However, since users may still be in the habit of entering the account prefix, you may want to include this pattern to handle such a scenario.
Bria 4 for Windows User Guide – Retail Deployments D Contact List Headings Following is a list of all the headings that are used in the Bria contact list. This list can be useful when formatting a contact list in order to import it into Bria. For details, see “Populating by Importing Contacts” on page 51. The same headings are used for both Bria for Mac and Bria for Windows.
CounterPath Corporation E Other Ways to Run Bria E.1 From a Hyperlink You can attach a hyperlink to a phone number or softphone address that, when clicked, starts Bria and dials the number. Attach a hyperlink with this format: dial address_or_number For example: dial kperera@domainA.com Bria supports three protocols: sip, tel, and callto.
Bria 4 for Windows User Guide – Retail Deployments E.2 From the Command Line You can start Bria from a DOS prompt. You may need to add the install directory (typically c:\program files\counterpath\bria 3) to the PATH. Then type: bria4.exe You can also run these action commands: bria 4 >bria4.exe -action== where action and input are: call?to the remote URI im?to the remote URI add?contact the contact URI quit For example: C:\>bria4.exe -action=call?to=1331 or C:\>bria4.
CounterPath Corporation F Glossary Broadband Codec Dial plan DTMF Firewall HID IM MWI Narrowband Presence PSTN SIP account softphone address USB device vCard VoIP VoIP service provider XMPP account 110 Broad or wide bandwidth. In data transmission, the wider the band, the more data it is possible to transmit in a given time span. A cable, DSL and ADSL connection to the network provide broadband for data transmission.
