CounterPath Bria 4 User Manual

Bria 4 for Mac 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

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.

The content of this publication is intended to demonstrate typical uses and capabilities of the CounterPath Bria 4 for Mac softphone application from CounterPath Corporation. Users of this material must determine for themselves whether the information contained herein applies to a particular IP-based networking system. CounterPath makes no warranty regarding the content of this docu ment, including—but not limit ed to—implied warranties of fitness for any particular purpose. In no case will CounterPath or persons involved in the production of this documented material be liab le for any inciden tal, indire ct or otherwise co nsequential damage or loss that may result after the use of this publication.

CounterPath and the logo are trademarks of CounterPath Corporation. Mac and Mac OS are registered trademarks of Apple Inc., registered in the U.S. and other countries

This manual corresponds to version 4.0 of Bria 4 for Mac.

Rev 1

Contents

Introduction................................................................................................................................ 1

Installation and Setup................................................................................................................. 3

Getting Ready ...................................................................................................................... 3

Configuring Bria.................................................................................................................. 4

Troubleshooting................................................................................................................... 7

Checking for Bria Updates .................................................................................................. 7

Making Phone Calls................................................................................................................... 9

The Onscreen Softphone...................................................................................................... 9

Placing a Call....................................................................................................................... 11

Handling Incoming Calls..................................................................................................... 15

Handling an Established Call............................................................................................... 16

Transfering a Call ................................................................................................................ 17

Handling Video Calls.......................................................................................................... 19

Conference Calls.................................................................................................................. 20

Voicemail............................................................................................................................. 24

Forwarding Calls.................................................................................................................. 24

Other Bria Features.................................................................................................................... 25

Instant Messaging ................................................................................................................ 25

Sending a Broadcast IM....................................................................................................... 26

Group Chat (Conference IM)............................................................................................... 27

Chat Rooms.......................................................................................................................... 29

Viewing Messages............................................................................................................... 29

Sending and Receiving Files................................................................................................ 30

The Contacts Tab....................................................................................................................... 31

Populating the Contact List.................................................................................................. 32

Managing Contacts and Groups........................................................................................... 34

Using Contacts..................................................................................................................... 38

Sharing Online Status .......................................................................................................... 39

Privacy ................................................................................................................................. 43

Using Other Resources .............................................................................................................. 45

The History Tab................................................................................................................... 45

The Favorites Tab................................................................................................................ 47

Configuring Bria........................................................................................................................ 49

Configuring Accounts: the Accounts Tab ........................................................................... 49

General Preferences.............................................................................................................64

A Troubleshooting..................................................................................................................... 73

B Dial Plan................................................................................................................................. 77

C Contact List Headings............................................................................................................ 83

D Other Ways to Run Bria......................................................................................................... 84

E Glossary.................................................................................................................................. 85

iii

CounterPath Corporation

1 Introduction

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. Bria implements SIP-based standards for phone calls, IM and presence, allowing you to work with different VoIP service providers. Bria also uses XMPP-based standards for IM and presence.

Standard Telephone Features

The CounterPath Bria 4 for Mac softphone has all standard telephone features, including:

• Call display and Message Waiting Indicator (MWI).

• Speakerphone and Mute.

• Redial, Hold, Do Not Disturb.

• Call history – list of received, missed, and dialed calls.

• Call forward.

• Call transfer.

• Call record.

• Auto answer.

• Five-party audio conferencing.

• Three-party video conferencing.

Enhanced Features and Functions

Bria also supports the following features and functions:

•Video

• IM and presence using the SIP SIMPLE protocol or the XMPP protocol.

• IM conferencing (group chat) via an XMPP account.

• Corporate chat rooms.

• Contact list containing the individual user’s contacts

• Directory containing names from a shared LDAP directory.

• File transfer via an XMPP account.

• Automatic detection and configuration of audio and vid eo dev ices.

• Acoustic echo cancellation, automatic gain control, voice activity detection.

• Support for DTMF (RFC 2833 or inband DTMF).

• Support for the following audio codecs:

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.

CounterPath Corporation

• Support for these firewall traversal solutions: STUN, TURN, or ICE.

2 Installation and Setup

2.1 Getting Ready

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 “Configuring Bria” on page 49.

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.

• Password

• Connection information; see “XMPP Account” on page 51.

CounterPath Corporation

2.2 Configuring Bria

First-time Startup

If Bria is not already running, start it as you would any other program. The Bria Login dialog appears with the Profile set to “Manually configure login server”.

Set the profile to “No login required” 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 required profile. (If you started up the first time with “No login required” but i n fact you do need to log in, go to the menu and

choose Preferences. Click the Application tab and enable login. See page 64.)

Setting up Notifications

Bria uses OS notifications. Make sure that the notifications are set up for Bria in system preferences. From the menu, click Apple logo > System Preferences > Notifications. In the notification center, choose Bria

4. Choose Banner or Alerts for the alert style. For details on incoming call notifications, see page 15.

Setting up Accounts

After obtaining SIP account information from your VoIP service provider, you can set up Bria accounts.

1. From the menu bar, choose Bria 4 > Preferences > Accoun ts. The Account list appears with one account

(the Mac Address Book account) configured; see below.

Set up the SIP Account

2. Click the + button and choose New SIP Account. The SIP Account window opens.

Bria 4 for Mac User Guide – Retail Deployments

3. In the General tab, complete the User Details area with the information obtained from your VoIP service

provider.

4. Complete the remaining tabs as specified by your service provider or to suit your setup. Settings that you

may need to change immediately include:

• General tab, Domain Proxy area.

• Topology tab, if your computer is on a network and/or behind a firewall.

For more information, see page 53.

5. Click OK; the account is enabled and registered; check the account list to make sure the account registers

successfully.

Set up the XMPP Account

If you already have an XMPP account independent of Bria (for example, a Gmail™ webmail service account), you can create an account in Bria and pull your contacts into the Bria contact list. You can then IM these contacts directly from Bria.

6. Click the + symbol at the bottom of the window and choose New XMPP Account. The XMPP Account

window opens.

7. Complete the window with the information obtained from the XMPP service provider. Typically you only

have to complete the User Details. For more information, see page 51.

8. Click OK. In a few seconds you will see all the existing contacts from your XMPP account appear in the

Bria contact list, in a new group.

9. Make sure the Status is green for all accounts.

Enable your Mac Address Book Account

If you want to pull in the contacts from your Mac Address Book, enable the Mac Address Book account. See page 49 for more information.

CounterPath Corporation

Setting up for Voicemail

Your VoIP service provider may offer voicemail. If it does, then you can set up some voi cemail features in Bria. See page 55.

Populating your Contact List

Typically, you wi ll 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 33.

• From your Mac Address book, by enabling the Mac Address Book account. See page 49. In addition:

• 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 16.

• You can add addresses to the Contact list one by one. See page 34. For general information on contacts, see page 31.

Bria 4 for Mac User Guide – Retail Deployments

2.3 Troubleshooting

Bria includes tools for helping you troubleshoot problems. From the menu, choose Help > Troubleshooting.

• Audio tab: 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).

• Video tab: You can verify that your camera is working.

• Devices tab: You can verify that you r microphone and speakers are working and can set the volume to a

comfortable level without having to actually place a phone call.

• Diagnostics tab: If none of the other tabs help you solve your problem.

2.4 Checking for Bria Updates

To check for updates to Bria, from the menu bar, choose Help > Check for updates. The Auto Update window appears.

• If a new version of the software is available, you can download it from this window.

• If no newer version is available, this window informs you that your version is up to date.

CounterPath Corporation

3 Making Phone Calls

Call entry field. See page 11.

Resources. See page 45

Close window

Minimize to dock

Resize softphone

Voicemail indicator. See page 24

Bria Toolbar. See page 16

Missed calls indicator. Opens the History tab.

3.1 The Onscreen Softphone

CounterPath Corporation

The Bria Menu

The menu contains the following items that are specific to Bria:

• Bria 4 > Preferences. See page 64.

• View. Changes how Bria looks. Also lets you view the messages and chat rooms (if you are a member of

one; see page 29).

• Contacts. Lets you work with contacts.

• Help. Provides access to various service-related features.

Receiving an Online Status Request

When you start Bria, one of the first things you may see (if presence is enabled) is an Online Stat us Requ est dialog. See “Sharing Online Status” on page 39.

Bria 4 for Mac User Guide – Retail Deployments

3.2 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 From the... Description

Keying Dialpad or computer

keyboard

Control-click a contact or previous call

Double-click a contact Contacts tab Contacts have a “double-click” action (page 64) that either makes an

Single-click a contact Contacts tab Hover ove r th e right side of the contact to reveal the click-to-call

Redial Redial button • When the call entry field is empty, click the Call button.

Dialing Dial pad 1. If the dialpad is not visible, click the Phone tab at the bottom

From an instant message Messages window Click the menu at the top of the IM window and choose Call.

Contacts or History tab Control-click an entry from the Contacts or History tab and choose Call

1. Enter the number or address in the call entry field using the dialpad or the computer keyboard. To turn letters to numbers, see page 13.

If entering a softphone address, you can enter the entire address (6045551212@domainA.com) or just the number (6045551212).

As you type, a suggestion for completing the entry may appear. Choose the suggestion or keep typing.

2. Click the Call button or press Enter.

or Video Call. (If the tab contains lots of entries, first search or filter the list.)

audio phone call or starts an IM.

button. Click to place a call using the primary phone number for this contact.

• Or click the arrow in the call entry field and select a recent call.

An audio call is placed.

2. Click the numbers on the dialpad to enter the phone number.

3. Click the Call button or press Enter.

See the next page for an example.

CounterPath Corporation

Call entry field

Click to place the call

Auto complete suggestions

For information on working with the call, see “Handling an Established Call” on page 16.

Dealing with an Auto Attendant

If you know that your call will be answered by an auto attendant and you know what menu items you will choose, you can include those menu items (DTMF) in the pho ne number when you dial it:

• Before the first DTMF number, include at least one capital P.

• You can include other Ps. Each P causes Bria to wait one second before sending the next character.

• At the end of the input, you must include a ; character. Example: To dial a number, add a 3-second delay and then press 44, enter this in the call entry field:

604551212PPP44;

Example: To dial a number, add a 6-second delay, then press 1 then 3 then 2, each with a two second delay:

604551212PPPPPP1PP3PP2;

A capital X or , (comma) can be used instead of P; the foll owing will work in the same way as t he first exa mple above.

6045551212XXX44;

Bria 4 for Mac User Guide – Retail Deployments

Choose the account to use. If you choose Auto Select, then the

account to use depends on your dial plan rules (page 53). If there are no dial plan rules, then the “preferred” account (page 49) is used.

Turn letters-to-numbers on or off

Type the phone number using numbers and letters, as desired

When you click Call, the call panel will open and the call will be placed. The call panel will show the phone number all in digits.

Turn Hide my number on or off

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 option s appear only if y ou have two or mo re SIP accounts that a re enabled and be ing used

for phone calls. To make an account “useable” for phone calls, from the menu bar, choose Bria > Preferences > Accounts, open the desired account and change the Use For fields on the General tab (page 49).

Letters to Numbers

You can type letters and Bria will convert the letters to numbers when placing the call:

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 mode

Anonymous Calling is automatically turned off when you shut down.

CounterPath Corporation

Existing call is automatically put on hold

Place the call in the usual way

New outgoing call

Switch between the different calls by clicking Resume on the desired call panel. That call becomes the active call and all other calls are on hold.

Placing another Call

You can place another call. There is no limit to the number of calls you can make, although eventually the quality of audio and video will degrade because of lim it ations on the computer.

Bria 4 for Mac User Guide – Retail Deployments

Click. If you are on another call, that first call is automatically put on hold. You are now talking to the new

Or click. There will be a busy signal. The call may be directed to voicemail (if you have this service).

Or click Forward; a call entry field appears. Enter the name or number to forward to and click Forward Now.

Clicking the banner answers the call.

The Banners style goes away automatically.

The Alert style shows buttons: Answer and Decline.

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 Preferences > Calls.

Auto answer is automatically turned off when you shut down.

3.3 Handling Incoming Calls

Bria must be running to answer incoming calls. (If Bria is not running, incoming calls may be directed to voicemail; check with your VoIP service provider.)

When Bria is in the foreground, the ne w call ap pears in its own call panel. When Bria is in the background (the focus is on other application), the incoming call notification appears in the upper-right corner. To receive notifications, make sure that you configured both system preferences on Mac OS (page 4) as well as Bria’s alerts preferences (page 66).

When Bria is in Foreground

When Bria is in Background

The notifications do not indicate whether the incoming call is an audio or video call. If the incoming call is a video call, Bria will answer with video.

Auto Answer

You can set Bria to automatically answer all incoming calls.

CounterPath Corporation

Missed calls See page 45

Speakerphone

Place another call

The current call is automatically put on hold). See page 14

Conference Calls See page 20

Add video. See page 19

Hold and resume

Instant Message See page 25

Record the call

Add as Contact

If a plus symbol appears here, you can add the current caller as a contact. See “Adding a Contact using an Existing Address” on page 37.

Voicemail See page 24

Speaker and microphone control

Transfer. See page 17

Mute your voice

3.4 Handling an Established Call

Ending a Call

Click the End call button on the Call panel (the call can be active or on hold). The call panel closes after a few seconds.

3.5 Transfering a Call

Type a name or number

Then click Transfer Now.

Click the Transfer button

The call is put on hold and a call entry field appears.

The call may end immediately.

Or it may show “calling”, In this case, do not hang up immediately: if the other person does not answer, the call will come back to you.

Basic (Unattended) Transfer – Transfer this Call

Bria 4 for Mac User Guide – Retail Deployments

CounterPath Corporation

When the other person answers, the Transfer Now button is enabled

Click the Transfer button

Type a name or number

Then click the down arrow and choose Call

The call is put on hold and a call entry field appears

When you are ready, click Transfer Now. The call panel closes

Bria phones the new person

You can hang up the second call and return to the first call

Or you can click the X to cancel the transfer request and return to the first call

Or if the other person does not want to take the call, click X and return to the first call

Attended Transfer – Call then Transfer

You can first speak to the target (the person you are transferring th e call to), then click Transfer to complete the transfer.

Bria 4 for Mac User Guide – Retail Deployments

Click the down arrow and choose Video call. If you mostly make video calls, you can Option-click this down arrow to reveal the “Set Video Call as default action” menu item.

Show/hide video window

Start or stop video

3.6 Handling Video Calls

Placing a Video Call

Adding Video

If you have a camera, you can click Start Video to add video to an established call. When you add video, the other party may (or may not) start sending their video to you.

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

From the Dashboard

From an Existing Call

From One Established Call

From Two Established Call

Bria 4 for Mac User Guide – Retail Deployments

CounterPath Corporation

Conference call menu

Participant menu

Mute. When you mute during a video call, you may also want to click Stop Video to stop the video feed.

Managing the Conference

Adding More Participants

You can add more participants to an existing conference in any of these ways:

• Control-click on a contact and choose Add to Conference Call.

• In the conference call panel, click Invite to Conference Call, enter a name and then click Add.

• Add in a separate call that is not part of the conference call: In the call panel for the individu al call, click the down arrow and choose Merge Calls. This call is added to the conference call.

Send an Instant Message

Click the down arrow beside a participant name and choose Send Instant Message.

Removing a Participant

To remove one call from the conference, click the down arrow beside a participant name and choose Separate. The call becomes a separate call.

Ending the Conference

To hang up on everyone, click the End button.

Suspending the Conference

To suspend the conference, click the Hold button. All participants are put on hold. If you need to speak to one participant separat ely, put the conference on hold, separate the on e p artic ip ant from

the conference, take that person off hold. When done, merge the participant back into the call.

Video Conference Calls

“Video” appears beside each person

Start and stop sending your video to all participants

Closing the video window stops sending video.

Bria 4 for Mac User Guide – Retail Deployments

Starting a Conference with Video

When you start a conference from established calls, video is included if at least one of the calls already includes video. Video is sent to all the participants.

When you start a conference from scratch, video is not included. You can open your video window and choose to add video at any time. Video is sent to all the participants.

How Video Is Shared

The conference host (the person who starts the conference) serves as the host for other video. Whatever the conference host is receiving will automatically be sent to the other parties.

If the conference host pauses or stops video, other participants will no longer receive video.

CounterPath Corporation

Voicemail icon

3.8 Voicemail

If your service includes voicemail and you have set up voicemail options (page 55), then when you have voicemail messages, the voicemail icon appears at the top of the phone (the icon may include a number). You can click the icon to automatically connect to voicemail and listen to your messages.

3.9 Forwarding Calls

You can enable or disable forwarding so that calls will be forwarded to another number. You can set up forwarding so that calls are always forwarded or so that calls are forwarded only when you are on another call.

To enable forwarding, from the menu bar, choose Bria 4 > Preferences > Accounts. Open an account and click the Voicemail tab. For complete details, see page 55.

You can also forward a call “on the fly”. See page 15.

4 Other Bria Features

Click to select more actions

4.1 Instant Messaging

Sending an IM

1. There are several ways to select the person to send an IM to.

From the Contacts tab Control-click on the contact and choose Send IM. 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. An active conference call If the participant is a contact, choose Send Instant Message from the participant menu. From the Messages window Click the New Conversation icon beside the Search field, and type a number or name.

2. Type the message. Include emoticons and formatting (Ctrl+B, Ctrl+I, Ctrl+U), as desired. To insert a return in the message, press Ctrl+Enter. (You can control the behavior of Enter and of

Ctrl+Enter; see page 64.)

3. Click the Send icon or press Enter.

Receiving an IM

When an IM is received, either the IM window or a notification pops up. (To control which window appears, from the menu choose Bria > Preferences > Alerts & Sounds)

CounterPath Corporation

Type a contact name to add more contacts, if desired. Auto suggestions come up.

In the Contacts tab, select the desired contacts. Contacts must be online

Control-click the last selected contact and choose Broadcast Instant Message

The New Conversation thread opens

A recipient may send you a response, which will be displayed to you in a regular Instant Message window; you will then be in a regular IM with that one party

Type your message. Include emoticons and formatting (Ctrl+B, Ctrl+I, Ctrl+U) as desired.

Click Send or press Enter.

4.2 Sending a Broadcast IM

You can send an IM to several people at one time. A broadcast IM is not a conference IM.

• 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 conference IM, all parties see everyone’s messages and the messages each party sends are seen by everyone. See “Group Chat (Conference IM)” on page 27.

Bria 4 for Mac User Guide – Retail Deployments

In the Contacts tab, select the desired contacts. Contacts must have XMPP accounts, and must be online.

Control-click the last selected contact and choose Start Group Chat. The New Group Chat thread opens.

Type an invitation message and click Send. Once a chat is started (first message has been sent), you cannot add or remove participants.

4.3 Group Chat (Conference IM)

Group chat allows you to exchange instant messages with a group of people in the same session. Group chat differs from a broadcast IM in that all parties see everyone’ s messages, and the messages each party

sends are seen by everyone else. In a broadcast IM, each recipient can reply to the IM, but only the person who sent the broadcast IM will see these replies; the other recipients will not see these replies.

There is no limit to the number of participants in a group chat.

Starting a Group Chat

CounterPath Corporation

Managing a Group Chat

Leaving a Group Chat

Unregistering your XMPPP account or exiting Bria lets you lea ve 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.

Deleting a group chat session on the Messages window also lets you leave the session, but you will lose chat history.

Bria 4 for Mac User Guide – Retail Deployments

Search all messages.

Click for more actions such as exporting conversation.

Clicking the x icon deletes the session.

The session may be greyed out. Typically it means that the account used for the session is not registered, or the group chat has ended.

4.4 Chat Rooms

Typically, chat rooms are used only in enterprises and are set up by the system administrator.

4.5 Viewing Messages

On the menu bar and choose View > Show Messages to view your recent IM activity for any cont act, group chat session, or chat room session.

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

1. Control-click a contact and choose Send Files; a standard Open dialog box opens.

2. Select the files to send and click Open. The Send Files dialog appears with a “waiting” message. If you want, you can cancel the send before the other person retrieves the file.

To cancel the file transfer before the other person retrieves the files, click Cancel.

Receiving Files

If you have an XMPP account, anothe r perso n with an XMPP address may se nd you fi les. The fol lowing dialog appears, to allow you to save the file.

5 The Contacts Tab

Add a Contact

The online status of contacts. See page 39.

Search field

Contacts are typically organized into groups. Bria includes built-in groups. You can add more groups, as desired.

If the Contacts tab is not showing, go to the menu bar and choose View > Show Contacts.

The Contacts tab displays your contacts. Each contact is shown with presence information and icons for singleclick phoning and IMing.

You can change the detail and layout of the contact list: from the menu bar choose Contacts and set the desired options.

CounterPath Corporation

Address label “softphone”

Address type “Phone”

5.1 Populating the Contact List

At any time, but particularly when you first deploy Bria, you may want to populate t he contact list wi th contacts from an external source.

Populating from the Mac Address Book

You can populate the Bria contact list by pulling in the contacts from your Mac Address book.

Enabling the Mac Address Book

Enable the Mac Address book account that is has automatically set up in Bria. See “Configuring Accounts: the Accounts Tab” on page 49 for more information.

Setting up for Availability

If your Mac Address book contains phone numbers that you know you can use to obtain online availability information about the person via your SIP account, you can perform this optional setup:

• In the Mac Address book, modify the con tact’s entry so that the type is “Phone” and the label is “soft phone” (all lower case):

When you enable the Mac Address Book account in Bria, the contact will be pulled in with the specified phone number already set up as a softphone address.

• Open the contact and choose the specified phone number in the Presence field. When you click OK, Bria will obtain availability information for this contact.

Bria 4 for Mac 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.

Importing

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). A vCard is an electronic business card that is often attached to an e-mail.

1. From the menu bar, choose Contacts > Import Contacts. The Import Contacts wizard starts.

2. Select the file type and file location, and specify whether you want to replace or append to the existing contact list.

Setting up an Excel File for Import

1. Remove any introductory text or headings from the top of the file. (You can keep text at the end of the file; it will be ignored during the import.)

2. Insert a blank row as the first row, then insert the headings that Bria will use to interpret the meaning of each column. The columns can be in any order. Key headings are:

• sip-address. Bria recognizes a value in this column as a softphone address and considers the address as

one that can be phoned and as an address that can be used for IM/presence (if SIP is being used for IM/ presence).

• xmpp-address. Bria recognizes a value in this field as a Ja bber (XMPP) address and will map this field

to the Instant Message contact method for the contact. Bria considers a Jabber address as one that can be used for IM/presence (if XMPP is being used for IM/presence).

• display-name, given_name, surname

• business number

• presence_subscription. Complete this column in one of these ways:

• If you only want to share presence information with some of your contacts, fill in this column in the file. Enter “true” for contacts whose online presence you want to see, leave blank or enter “false” for others. During the import, you will be able to choose to sh are presence with only these contacts. Bria will subscribe to the presence of these “true” contacts, assuming that the user has a SIP (if using SIP for presence).

• If you want to share presence with all your contac ts (or with none), ignore th is heading. D uring the import you will be able to choose to share with all (or none) of your contacts.

For a complete list of headings, see “Contact List Headings” on page 83.

3. Save the file as *.csv.

Exporting Contacts

You can export a contact list to a comma-separated file.

1. From the menu bar, choose Contacts > Export Contacts. The Export Contacts wizard starts.

2. Select the file type and file location for the created file. A file of the specified type is created.

CounterPath Corporation

The new number appears in the list

To enter a phone number, select the type, enter the number, and click +

5.2 Managing Contacts and Groups

Adding a Contact

Click , or control-click a group and choose Add Contact to Group. The Contact dialog appears.

Contact Summary

Group Click to show the list of groups. Check each group this contact should belong to. Primary Call If the contact has more than one number, select the primary number. This number will be used with

Primary Presence This field appears only the contact has more than one Softphone number or Instant Message address.

Other Sections

Display Name (required) The display name for this source of information. For example, the display name from the XMPP

First Name, Last Name Optional. Contact Methods Enter as many contact methods as you want.

Presence This field is automatically populated when you enter an address in the Softphone or Instant Message

Field Description

single-click calling.

The primary presence is used as follows:

• The presence icon on the contact list shows the online status for this address.

• The single-click action for instant messaging uses this address. You can still send IMs to this person at their other addresses, but you must right-click and choose

from the context menu.

contact list.

Enter a person’s IM address as follows:

• If you use the SIP account for IM and presence, choose Softphone.

• If you use a XMPP account for IM and presence, choose Instant Message. If you have more than one account of a given type, include the domain (for example,

1440@domainA.com) to ensure that the number or address gets associated with the correct account.

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.

Bria 4 for Mac User Guide – Retail Deployments

Enter the person’s softphone number in the Softphone field

As soon as you add a Softphone entry, this field automatically appears. Bria will share online presence information with this person using this phone number.

The Primary Presence field appears if the contact has more than one Softphone number or Instant Message address. See the table for details.

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.

CounterPath Corporation

Enter the XMPP address in the Instant Message field. Include the domain (e.g. @gmail.com)

Enter the person’s phone number and any other information

Select the Instant Message entry; the Enable XMPP Presence button appears

All the XMPP information moves to a separate section. This XMPP information is automatically added to your list of contacts on the XMPP server (for example, to your Gmail list)

Click the button

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.

Bria 4 for Mac User Guide – Retail Deployments

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 person who is not a contact, click the Add to Contacts icon in the call panel.

• On the History tab, select an entry that is not a contact. Control-click and choose Add Contact.

The Contact Profile dialog appears. Complete the dialog as desired and press OK. If the contact method is Softphone or Instant Message, an online status request is sent to this person. See

“Sharing Online Status” on page 39.

Modifying the Contact List

Changing Contact Information

To change the information for a contact, control-click the contact and choose Edit Profile. The Contact dialog appears (see page 34).

Deleting a Contact

• T o de lete one or more contacts, sel ect them, control -cli ck, and choose Delet e or Delete Sele cted Items. The contacts are removed from this group. If a contact belongs to several groups, it is removed from all groups.

Adding, Deleting or Renaming Groups

Select any group, control-click, and choose the appropriate menu item.

CounterPath Corporation

See page 25

You can watch the contact’s online status, if the contact has a softphone address. See page 41 for the meaning of the online status icons. See “Sharing Online Status” on page 39 for information on obtaining online status information.

See page 27

See page 42

See page 65

See page 47

Hover to reveal icons.

See page 30

Click to call using the primary phone number.

Click to send an IM using the primary presence address for this contact.

5.3 Using Contacts

Bria 4 for Mac User Guide – Retail Deployments

Your online status

Online status of other people

This person is either logged out or is not publishing their online status

This person has no icon because you are not subscribing to their online status

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.

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.

• If you create a contact via the Contact Profile and you include an XMPP address, you can click the Enable XMPP Presence button to obtain status information for this address.

• If you created contacts by importing a contact list, you can specify during the import whether you want to share presence information. See page 33.

• If you created an XMPP account in order to pull in your Gmail contacts, these contacts will already be set up to share status information.

• If you enabled the Mac Address Book account in order to pull your Mac contacts into Bria, then these contacts will be set up for presence if you set up the mapping correctly. See page 32.

When you choose to share presence information, Bria sends the contact a noti fi cat ion reque s t. The request asks that you be able to see that person’s status. If the person allows this reques t, then the icon beside their name (in your Contacts) becomes color coded to specify their status.

CounterPath Corporation

Allowing Other Parties to See your Status (Publishing your Status)

Continuing from above, when the other person allows the notification request, your name is added to their contact list. As soon as you are added to their list, a request is sent back to you requesting that they be able to see you. Bria accepts this request automatically, and the other person can now see your status.

Receiving an Online Status Request

Someone who is not one of your contacts may add you as a contact on their end, and may include your SIP address or XMPP address. In this case, Bria receives an online status request. The request is handled in one of two ways:

• If you set up a privacy rule before this person has a chance to contact you, then you will never see this request. Bria will automatically reply to the request according to the rule. See page 65.

• If you do not yet have a privacy rule set up for this person or for th eir domain, this request a ppears to you as an Online Status Request. You must respond to the request:

Option Button Comment Result

Create a new contact

Update an existing contact

Either option Block Block the request.

Either option Ignore Ignore the request.

Allow This option is selected for you if

you do not currently have a contact with this SIP or XMPP address.

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

Allow the request and create a new contact using this address. Because you allow the request, you will no longer be bothered by

requests from this person. In addition, this same request will automatically be sent from your Bria to the other person, so that you can see their online status.

Allow the request and add this address to an existing contact (if Bria has found an appropriate match).

Because you allow the request, you will no longer be bothered by requests from this person. In addition, this same request will automatically be sent from your Bria to the other person, so that you can see their online status.

This person will not be able to contact you from this address.

The other person will not be able to see your online status. The other person will not be added to your privacy settings.

The Online Status Request may appear again in this session or a future session.

Bria 4 for Mac 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 value.

Setting up Online Status Indicators

Indicator Meaning for your St a tus Meaning for Others’ Status

Available Either:

• You have set your status to this value.

• Bria has determined that you are logged on but not on the phone or idle.

When you have this status, Bria will automatically detect when you are idle or on the phone, and change the status to match.

Busy You have set your status to this value. Bria will never automatically

switch you out of this status; you must switch yourself.

Away You have set your status to this value. Bria will never automatically

switch you out of this status; you must switch yourself.

On the phone Either:

• You have set your status to this value. In this case, Bria will never automatically switch you out of this status; you must switch yourself.

• You started a phone call when your status was “Available”. When your call finishes, your status reverts to “Available”.

Not available for calls

Do not disturb

Idle You have not moved or clicked the mouse or pressed a keyboard key

Y ou have set y our status to this value. of this status; you must switch yourself.

for the Idle period. To set the Idle period see page 64. As soon as you click the mouse or keyboard, your status changes to

“Available”.

Bria will never switch you out

You can contact this person.

You cannot contact this person.

You can contact this person.

Offline You have set your status to this value. The other person sees you as

offline, even though you are not actually offline. The other person cannot tell the difference between this status and you really being offline.

No icon Not applicable You are not watching the other

The contact is either not logged on or does not want to share online status.

person’s online status.

CounterPath Corporation

In the contact list, control-click the selected contact or contacts and choose Add to Alert List.

The Alert List icon appears beside the contact.

When the contact’s status changes, an alert appears

Adding Contacts to the Alert List (Buddy Pounce)

You can add a contact to the Alert List in order to request to be notifi ed when the online status of a contact changes.

Bria 4 for Mac User Guide – Retail Deployments

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 availability information (whether you are online, one 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 in Advance

To set up controls in advance, see “Preferences – Privacy” on page 65.

Setting up Controls “on the Fly”

Via the Online Status Request

Another party can send you a presence request, to request that they be able to see your presence, as described on page 10.

Your response has the following effect on privacy:

• If you add the person as a contact, then the ability of that person to phone or IM you is controlled by your privacy settings.

• If you allow the person without adding them as a contact, then the ability of that person to phone or IM you is controlled by your privacy settings.

• If you block the person, then that person is added to your Blocked List (Bria > Preferences > Privacy). The person will not be able to phone or IM you, and will not see your availability information. You can change this blocking by removing the person from the Blocke d List, in which case they will then be controlled by your privacy settings.

For information on privacy settings and the Blocked List, see page 65.

From the Contact List or History List

Control-click on the name and choose Block this Person. The person will be added to your Blocked List (page 65). The person will not be able to phone or IM you, and will not see your availability information.

To later unblock this person, control-click on the name and choose Unblock this Person.

CounterPath Corporation

6 Using Other Resources

Green: Outgoing call, either attempted or established

Red: Incoming missed call

Blue: Incoming call that was answered

6.1 The History Tab

From the menu bar, choose View > Show History.

Managing the List of Calls

You can control-click on an entry in a list to:

• Delete the call.

• Delete all entries in this list.

• Block this person to control whether they can send you phone calls or instant messages, or see your online availability. You can change these privacy settings at any time; see page 65.

• Edit the profile if the entry is a contact.

• Add as contact. The Contact d ialog ap pears. See “ Adding a Cont act using an Exi sting Address” o n page 37.

CounterPath Corporation

Phoning from History

You can control-click on an entry to place a call to this person, using the contact method that was used for this call. You ca n:

• Control-click on an entry and select Call or Video Call to place a call to this person, using the contact method that was used for this call.

• Place a call to this person and add them to a conference call that is in progress. For more information on conference calls, see page 20.

Bria 4 for Mac User Guide – Retail Deployments

You can perform nearly all the same actions on the contact in Favorites as you can in the contact list.

Removes from Favorites but does not remove from the contact list

Removes from Favorites and the contact list

Quick links to IM or phone this person

Menu for other actions

6.2 The Favorites Tab

To view the Favorites tab go to the menu bar and choose View > Show Favorites. You can create favorites from your contact list. They will be displayed in both the contact list and in the

Favorites tab. Select the desired contacts, then control-click and choose Add to Favorites.

CounterPath Corporation

7 Configuring Bria

This account will be used for calls if Auto Select is used (page 13) and there are no dial plan rules for selecting the account

Your own Gmail account

Your main SIP account

Another SIP account

Here is a typical setup

Double-click an account to view or edit

The Mac Address Book account, which is automatically created but initially disabled

From the menu bar, choose Bria > Preferences. The Preferences window appears.

• When configuring Bria the first time, click the Accounts tab and set up the account. Then complete other tabs as desired.

• After the initial setup, display whichever tab you want.

7.1 Configuring Accounts: the Accounts Tab

Choose Bria > Account Settings from the menu bar. The Account Settings window appears, showing all the accounts set up. From this window you can add (c reate), en able or disable, edit, or remove a SIP, XMPP or Mac Address Book account.

You can:

• Create a SIP account. Follow the instructions you obtained from your VoIP service provider. See page 53 and following.

CounterPath Corporation

• Create an XMPP account, if appropriate. For example, if you already have an XMPP account independent of Bria (for example, a Gmail account), you can create an account in Bria and pull your contacts into the Bria contact list. You can then IM these contacts directly from Bria. To create an XMPP account, see page 51.

• Enable the Mac Address Book account, if desired. Your Mac Address Book contacts will be automatically pulled into your Bria contact list so that you can easily phone and IM them.

Status

• Green indicates the account is registered and ready for use.

• Yellow indicates the account is being registered/enabled. It will eventua lly change to green or red.

• Red indicates the account registration has failed.

• Grey indicates the account is disabled.

Call

The account is the “preferred account” for the action specified in the column heading.

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 Mac User Guide – Retail Deployments

Fields with a red asterisk are required

XMPP Account

You create an XMPP account if, for example, you already have an XMPP account independent of Bria (for example, a Gmail account).

Table 1: XMPP Account Properties – Account

Field Description

Account name If desired, change the account name to something that is meaningful to you. For example, the

Protocol Read-only. Always specifies XMPP.

User Details

User ID The XMPP (Jabber) user ID. For example, jsantos. Provided by the XMPP service provider. Domain For example, domainXMPP.com. Provided by the XMPP service provider. Password Provided by the XMPP service provider. Display name This name is displayed in the Bria display. Other parties may see this name when they are

Advanced

Port selection Configures the port to use. If you choose “User selected”, complete the Connect port field. Connect port Complete only if Port selection is set to “User selected” Outbound proxy The value in User ID and in this setting may be used by Bria to compose a valid jid:

Resource Optional resource, as specified in RFC 3920. For example “/home”. If this setting is blank and

type of XMPP account such as “Gmail account”.

connected to you.

• If User ID=bob@ABC.com and Outbound proxy is empty, jid=User ID: bob@ABC.com

• If User ID=bob@ABC.com/home and Outbound proxy is empty, jid=User ID: bob@ABC.com

• If User ID=bob@ABC.com and Outbound proxy=XYZ.com, ignore the Outbound proxy; User ID=bob@ABC.com

• If User ID=bob@ABC.com and Outbound proxy=IP address or host address, jid=User ID. (IP address is used as the outbound proxy).

• If User ID=bob and Outbound proxy=ABC.com, jid=bob@ABC.com.

the User ID includes a resource, the value from tha t I D is used . I f both are sp ecif ied , the val ue from this Resource field is used. If no resource is specified, the XMPP server will assign a temporary resource.

CounterPath Corporation

Table 1: XMPP Account Properties – Account

Field Description

Priority The priority, as per RFC 3921. The default is 0.

SIP Accounts – General

Fields with an asterisk are required

Bria 4 for Mac User Guide – Retail Deployments

Table 2: Accounts – General

Field Description

Account name If desired, change the account name to something that is meaningful to you. For example, the

name of the VoIP service provider. Protocol Read-only. Always specifies SIP. Use for Call If checked, this account is eligible to be used for phone calls. If unchecked, this account will

never be used for placing phone calls. Use for IM/Presence If checked, this account is eligible to be used for IM and online status (presence). If

User Details

User ID Typically the account number for the softphone account. For example, 6045551212 or 2766.

Domain For example, domainA.com. Provided by your VoIP service provider. Password Provided by your VoIP service provider. Display name This name is displayed in the Bria title bar.

Authorization name May not be required. If it is required, it will be provided by your VoIP service provider.

Domain Proxy

unchecked, this account will never be used for IM and online status.

Provided by your VoIP service provider.

Other people will see you as this name.

Check this box if you want to register with your VoIP service provider, so that you can receive

incoming calls.

Typically, this field is checked.

This field must be left unchecked when, for example, your level of service does not include

the ability to receive incoming calls. In that case, turning this field on may cause registration

to fail (when you close the Account Properties window).

CounterPath Corporation

Table 2: Accounts – General

Field Description

Send outbound via Choose the setting specified by your VoIP service provider:

• Domain: If your VoIP service provider requires that traffic be directed to proxies that are discovered via the domain.

• Proxy Address: If your VoIP service provider has an outbound proxy address and requires that you provide the address to Bria. For the address enter a domain name (for example, domain.com) or an IP address (for example, 123.456.789.012).

If you are using Bria in a test lab, it is possible that neither of these settings is suita ble; see page 63 for a third way to direct traffic.

Dial Plan Information about the syntax of the numbers used by this VoIP service provider.

Provided by the service provider. The default plan is: #1\a\a.T;match=1;prestrip=2; For information on determining whether you need to modify the default dial plan, see

page 77.

SIP Accounts – Voicemail

Bria 4 for Mac User Guide – Retail Deployments

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 voicem ail outside of Bria, fo r exampl e, by pho ning a softphone address and following the voice prompts, or by accessing a website.

Check with your service provider to determine if another setup mechanism is available. If so, check what the settings are in that setup, and make sure you enter compatible information in Bria.

In particular, if your service provider has a mechanism for call forwarding, find out if you should leave the Forwarding settings on this Voicemail tab blank.

Field Description

Check for voicemail Set the checkbox in one of these ways:

Number to dial for checking voicemail Optional, but complete this field only if your VoIP service includes voicemail.

Table 3: Accounts – Voicemail

• Check the box if Bria must subscribe to be notified when there is a voicemail for you. In other words, to configure for “subscribe for message waiting”.

• Clear the checkbox if the service provider’ s voicemail server sends notifications without Bria subscribing. In other words, to configure for “implicit subscription”.

• Clear the checkbox if the service provider does not support voicemail.

Check with your VoIP service provider for the correct configuration. Voicemail is offered by your VoIP

service provider for information on using voicemail.

• Completing this field activates the voice mail icon in the tool bar . When you click this icon, Bria will dial this number. You will be connected to your service provider’s voicemail and can listen to your messages.

• If you leave this field empty, then this icon will not work; you will have to manually dial this number in order to connect to voicemail.

Enter the number or SIP address provided by your VoIP service provider.

service provider; it is not part of Bria. Contact your

CounterPath Corporation

Table 3: Accounts – Voicemail

Field Description

Number for sending calls to voicemail 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. However, most VoIP service providers have their own mechanism for sending unanswered phone calls to voicemail. So leaving this field blank does not mean that forward-to-voicemail does not work.

Enter the number provided by your VoIP service provider.

Send calls to voicemail if unanswered Complete only if your VoIP service includes voicemail.

To send to voicemail after the specified number of seconds. Your service provider may also provide a similar feature that is set up outside of Bria. If

so, make sure you do not enter competing information in Bria and in the service provider’s user interface. For example, if you turn off this field, make sure the same feature at your service provider is also turned off. Otherwise, all your calls will continue to be forwarded.

Always forward to this address You can use this feature even if your VoIP service does not include voicemail.

To always forward phone calls, click th e box and enter the address to forward to. Phone calls received on other accounts (if you have them) are not affected by enabling this field.

Always forward works only when Bria is running and only if your VoIP service provider supports redirect.

When on the phone, forward to You can use this feature even if your VoIP service does not include voicemail.

To fo rward only when you are on another phone call, click the box and enter th e address to forward to. Phone calls received on other accounts (if you have them) are not affected by enabling this field.

Always forward works only when Bria is running and only if your VoIP service provider supports redirect.

Your service provider may provide a similar feature that is set up outside of Bria. If so, make sure you do not enter competing information in Bria and in the service provider’s user interface. For example, if you turn off this field, make sure the same feature at your service provider is also turned off.

SIP Accounts – Topology

Bria 4 for Mac User Guide – Retail Deployments

Table 4: Accounts – Topology

Field Description

Firewall traversal method

Server address • Empty: Discover the address of the fire wall traversal server (the STUN or TURN server), if available,

Range of ports You can set a range of ports used for SIP signaling, RTP audio and video. The appropriate setting depends

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.

• Discover public IP address: Advertise the public IP address (discovered via STUN) for the contact

address for signaling traffic, and for the connection address for media traffic.

• Use media relay (TURN): Advertise the public IP address (discovered via STUN) for the contact address

for signaling traffic.

Advertise the address of a media relay server (discovered via TURN) for the connection address for media traffic.

• None: Advertise the local IP address only for both signaling and media traffic.

using DNS SRV.

• Specified: Use the firewall traversal server specified as e ither an IP address or a fully qualif ied hostname. If you use the “Auto detect using ICE” option, then you can only enter a STUN server here. Don’t enter

a TURN server because when ICE is used, TURN is not supported.

on your computer setup:

• Checked: If your computer is behind a restrictive firewall that only allows specific port ranges to be

used. Enter the range of ports to use for your SIP account. (You must also open those ports on your firewall; refer to applicable firewall documentation for information.)

• Unchecked: If your computer is not behind a restrictive firewall.

CounterPath Corporation

SIP Accounts – Presence

Presence allows other softphone users to see your online status, and also allows you to see the online status of others.

This tab lets you set up to share presence information with contacts. (Note that you do not have to set up to share presence information on an XMPP account.)

Once you have configured presence on this page, you can set up rules; see “Sharing Online Status” on page 39 and “Preferences – Privacy” on page 65.

Table 5: Accounts – Presence

Field Description

Mode Choose the setting specified by your VoIP service provider:

• Disabled: Presence is not supported.

• Presence Agent.

•Peer-to-Peer.

Poll time Refresh interval

Enter the value specified by your VoIP Enter the value specified by your VoIP

service provider. service provider.

SIP Accounts – Storage

Bria 4 for Mac User Guide – Retail Deployments

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.

Contact data gets stored on the server as follows:

• Softphone numbers and display names from contacts created manually or from a corporate directory or by importing from a file.

• Other data from these contacts does not get stored on this server.

• XMPP contact data does not get stored on this server.

Table 6: SIP Accounts – Storage

Field Description

Storage method The storage method to be used for the buddy list and presence rules. The file can be stored

Server Settings (not used for “Local”)

Use SIP credentials Check this box to use the username and password from your SIP account in order to log into

Use alternative server credentials Check this box to use specific credentials. Enter data for connecting to the server.

locally (choose Local) or both locally and on a remote computer (choose one of the other options).

the storage server. Otherwise, uncheck this box and complete the Username and Password fields.

CounterPath Corporation

SIP Accounts – Transport

Table 7: SIP Accounts – Transport

Field Description

Signaling Transport 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.

• TCP: This transport provides no signaling security.

• UDP: This transport provides no signaling security.

• TLS: Choose this option to request signaling encryption or both signaling and media encryption.

Encryption See the description below for more information. Allow IPv6

Enable to allow to do so by your system administrator.Generally, leave this enabled. Disable it only if advised to do so by your VoIP service provider.

Bria to make phone calls and send IMs over IPv6. Disable only if advised

You can set up Bria for the type of security (encryption) you want for incoming and outgoing calls. Bria supports:

• Signaling encryption using TLS

• Media encryption using SRTP.

Setting up for Security outside of Bria

When using TLS, you must have the root certificate that signs the proxy's chain of certificates. In most cases, the root certification will already be installed. Procedures for the exchange of certificates are outside the scope of this documentation. The certificates must be stored on the Bria computer, in the root certificate store.

Setting up the root certificate on your computer en sures th at the connection to the proxy is TLS secure (the first hop). Any proxy in the chain (between you and the caller) that does not support TLS may cause an insecure link in the chain. Therefore, if the other party is outside your domain, you cannot be completely sure that the call is secured at the signaling level, which means that you cannot be sure that it is secured at the media level.

Setting up for Security within Bria

The options for media encryption are described in the following table.

Table 8: Security Options

Option How Outgoing Calls are Handled How Incoming Calls Are Handled

Make and accept only encrypted calls

Do not allow encrypted call

Bria will place all calls with TLS. The call

INVITE

will specify SRTP media encryption. If the correct certificates are not in place or if the

other party does not accept encrypted calls, the call will fail.

Bria will place only unencrypted calls. If the other party does not accept unencrypted

calls, the call will fail.

Bria will only accept INVITEs that are for encrypted calls.

If Bria receives a call INVITE that is not encrypted, the call will be rejected.

Bria will only accept unencrypted calls.

If Bria receives a call call will be rejected.

Bria 4 for Mac User Guide – Retail Deployments

INVITEs that are for

INVITE that is encrypted, the

CounterPath Corporation

SIP Accounts – Advanced

Table 9: SIP Accounts – Advanced

Field Description

Reregister every 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

Minimum time If the reregistration fails, Bria will wait this amount of time, then attempt to reregister. If the

second attempt fails, Bria will wait twice this time and try again, then four times this time, and so on, until reregistration succeeds.

Maximum time This is the maximum wait time between attempts to reregister. Once this maximum is reached,

Bria will wait this time for all subsequent attempts. For example, the min. time is 20 secs, the maximum time is 120 secs. Bria will attempt to

reregister as follows:

• Wait 20 secs.

• Attempt to connect.

• If fail, wait 40 secs.

• Attempt to connect.

• If fail, wait 80 secs.

• Attempt to connect.

• If fail, wait 120 secs (the maximum)

• Attempt to connect.

• If fail, wait 120 secs, and so on.

Bria 4 for Mac User Guide – Retail Deployments

Table 9: SIP Accounts – Advanced

Field Description

Timers

Enable session timers Default session time

A session timer is a mechanism to detect whether a call session is still active from the signaling point of view. When the timer expires, a refresh is sent from one party to the other. The timer is then reset.

• Turn on to enable session timer. Enter a value in Default session time.

• Turn off to disable session timer; refreshes will never be sent.

Session timer preference 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:

• None: No preference.

• Local refreshes: Your computer sends.

• Remote refreshes: The other party sends.

• UAC refreshes: The user agent client (the party that initiated establishment of the communications) sends.

• UAS refreshes: The user agent server (the other party) sends.

Send SIP keep-alives Typically on, to instruct Bria to send SIP keep-alive messages in order to maintain a “pinhole”

through your firewall for SIP messaging. Use rport Typically on. Send outgoing request

directly to target

When checked, requests with a complete URI (user@ABC.com) go to ABC.com and the “Send

outbound via” field on the General tab (page 53) is ignored.

If you check this field, make sure you also set “Send outbound via” (on the General tab) to

“Domain”.

Typically off. This field is intended for test labs and may cause problems in a NAT environment. Use old style hold Check this box only if your VoIP service provider advises you to do so.

CounterPath Corporation

7.2 General Preferences

From the menu bar, choose Bria > Preferences. The Preferences window appears. All the tabs on this window except for “Accounts” are preferences tabs. These tabs let you control the way that you work with Bria.

The icons (other than Accounts) let you set up general features of Bria.

Preferences – Application

This panel lets you set your preferences for general GUI behavior and lets you set up for login.

Preferences – Privacy

Bria 4 for Mac User Guide – Retail Deployments

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

General Tab

In “Global Contact Settings”, choose one option. If you choose “Only people in my contact list”, then all contacts will be able to contact you unless their name or their domain is in the Blocked list (below).

The “Blocked” section is optional. It lets you enter addresses and domains that will be prevented from contacting you.

You can add and remove entries from the blocked lists. In addition, entries are automatically added to this list when you block someone “on the fly” (page 43).

Corporate Tab

If you enter a domain in this list, people in that domain will automatically be allowed to see your online status. You will no longer see Presence Request dialogs from these people in this domain.

CounterPath Corporation

Notification pop-up - Alert style

Preferences – Alerts & Sounds

This panel lets you control the alert box and lets you assign sounds.

Enable Alert Displays

• You can control whether notifications are displayed in different situations. To receive notifications, notifications must also be set up to use either Banners or Alerts under OS’s system preferences (page 4). When “Enable alert displays” is on, Bria shows either a banner or an alert for selected situations.

• There are two choices on ho w you are alerted to an incoming IM: either with a small notification pop-up or with the Messages window itself. To be alerted with the Messages window instead of notifications, “For an Incoming Message” must be turned off.

Assigning Sounds

You can assign specific sounds to a variety of actions or “events”.

1. Select the Enable sounds check box and select the check boxes for each desired event, or clear the Enable sounds check box to disable all sounds.

2. If enabling sounds, you can change the sound for each event: select the individual event. The value in Sound preference will change. Select the desired sound.

You can import sounds; these will be added to the list of sounds you can choose from when assigning a sound to an event.

Bria 4 for Mac 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 ap pl y t he next time you start Bria, unless the device is no lo ng er av ai lab le, in which case Bria will again select the device to use.

CounterPath Corporation

Field Description

Zero touch device configuration

Typically, leave on. When device configuration is on, if you change your audio or video device,

Bria will automatically detect the new device and start using it. Automatic gain control This feature is typically on. Reduce background noise Automatically attempts to remove background noise.

Typically on for the speakerphone. Test Devices For information on the Test Devices button, see “Troubleshooting” on page 73.

Headset Mode

Microphone, Speaker

Change these fields only if you want to override the devices that Bria automatically selected.

In both these fields, select the headset you are using.

The headset is the device that is usually used for the speaker (the soun d you hear) and microphone

(recording your voice). The only situation in which the headset is not used is when the Speaker

Phone button on the dialpad is pressed.

Therefore, unless you will always be using Bria in speakerphone mode, you must make a selection

here.

Select the headset in both the Speaker device field and Microphone device field.

Speakerphone Mode

Microphone Speaker

Same as headset mode, but for the device to use when speakerphone is one (on the toolbar).

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. Reduce echo Turning this feature on improves sound quality. This feature is typically on.

Other Devices

Ring on The device where you want to hear the phone ringing.

Change this field only if you want to override the devices that Bria automatically selected. Camera This field appears only on versions of Bria that include video functionality.

Change this field only if you want to override the devices that Bria automatically selected.

Select the camera model. Resolution Leave at standard, or change the size as follows:

• Set it to high if you have a good camera and a computer with a fast CPU. You will know that you have set the size too large if:

Your computer slows down (the video is using too much CPU) The video shows black areas or is slow or jerky.

• T ypic all y set it to low only in spec ia l situat ions, for example, when using wi-fi in a hotel. You will know that you have set the size too small if the video is fuzzy.

Deskphone Setup Typically, deskphones are used only in enterprises.

Preferences – Codecs

Audio Codecs

Bria 4 for Mac User Guide – Retail Deployments

This panel shows all the codecs that are included in the retail version of Bri a. You can enable or disable codecs as desired. With only one codec enabl ed, al l c all s 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.

About Codecs

Audio codecs describe the format by which audio streams are compressed for transmission over networks. Codecs can be categorized as either narrowband or wideband:

• Narrowband codecs work with low bandwidth such as a dialup internet connection. These codecs have a sampling rate of 8 kHz.

• Wideband co decs work with hi gh bandw idths and result in bette r audio qu ality. However, they do no t work with PSTN. These codecs have a sampling rate of 16 kHz.

CounterPath Corporation

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 parti cular compression format. 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 Mac User Guide – Retail Deployments

Preferences – 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 15).

Field Description

Auto answer These settings let you configure how you want auto answer to handle incoming calls, when Auto

DTMF You may need to change the DTMF configuration if you cannot interact with interactive voice

RTP Timer This timer controls how calls are disconnected when Bria determines that there is a problem with

Preserve bandwidth When this feature is on, Bria stops sending audio when you are not talking.

Answer is enabled. (To enable Auto Answer, see page 15)

response systems (auto attendants, voice-activated menus, and so on). Contact your VoIP service provider for the correct setting.

the call and the other party has probably disappeared (assuming that you have not yourself detected the problem and hung up manually).

Typically, the timer is enabled. It is recommended that you not disable it. You can change the length of the timer, but do not set it to less than 30 seconds.

When this feature is off, Bria always sends audio, which uses more bandwidth but may result in better call quality.

Typically off. However, if you are using a slow (dial-up or ISDN) connection, you may want to turn it on.

CounterPath Corporation

Preferences – Directory

Ty pically, directories are used only in enterprises and are set up by the system administrator.

Preferences – Advanced

Field Description

Recording folder The folder where files for recording of phone calls will be saved. Transfer folder The folder where received files will be saved. W e b 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). Enter a checkbox to

create the tab. At any time, you can clear the checkbox to remove the tab from the Resources panel.

A Troubleshooting

From the menu bar, choose Help > Troubleshooting. The Troubleshooting window appears.

Testing Audio Quality

While you are on a phone call, you can t est the quality of th e audio. Note th at to perform a valid t est, you should be on an established call (not a call attempt).

CounterPath Corporation

Testing Video Quality

While you are on a phone call, you can t est the quality of the video. Note that to perform a valid test, you should be on an established call (not a call attempt).

Bria 4 for Mac User Guide – Retail Deployments

Testing Audio Devices

You can verify that your microphone and sp eakers are working and can set the volume to a comfortable level without having to actually place a phone call.

Click

Select the problem you are experiencing

Click

Perform the actions you want to capture

When done, click Advanced again to open the dialog.

The report is sent. Close this window

Click to stop logging

Then click to choose a log file to send.

CounterPath Corporation

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.

Bria 4 for Mac User Guide – Retail Deployments

B Dial Plan

When a call attempt is made, the call input (what you type or sele ct in the call entry fi eld) is proce ssed to sele ct the SIP account to use and to modify the input if that is required to ensure that the call gets placed suc cessfully. This ability to select an account and modify the input relies on the existence of a “dial plan” for each account.

Do You Need to Read this Information?

You do not have to read this dial plan information if the default dial plan behavior (below) is acceptable. If you want to be able to place calls on a specific account without including the account prefix, then you must

create a dial plan for one or more accounts. The default dial plan is:

#n\a\a.T;match=1;prestrip=2;

where #n is the account prefix (#1 for the first account in the list (proxy0), #2 for the second account (proxy1), and so on).

If the input is the account prefix and the number, then the Account for this dial plan is selected. The account prefixed is stripped from the number before the call is placed.

If all Accounts use this dial plan, then the behavior is as follows: if the input includes the account, then that account is used. In other words, you can force selection of a specific account by inclu ding the acco unt prefix. If the input does not include #n, then the default account is used.

Processing of Phone Numbers when a Phonecall is Placed

When a phone call is placed, the input (the phone number or SIP address) is processed as follows:

• Cleanup: Input is cleaned up by removing spaces, dashes, open brackets, and close brackets.

• Matching: The input is compared to the patterns defined by the dial plan for eac h ena ble d account. Each account has one dial plan, and each dial plan has one or more patterns.

When a match is found between the input and the pattern, the account that this pattern belongs to is selected and the transformation for this pattern is performed.

If no match is found, the default account is selected and no transformation is performed. For details on matching see “How the Input Is Processed” on page 80.

• Transformation: The selected transformation is performed.

• Then the call is placed using the transformed input.

CounterPath Corporation

B.1 Dial Plan Syntax

In Bria, the dial plan establishes the expected patterns of characters for a telephone number or softphone address, and allows for modification (transformation) of input based on the match to a pattern. The dial plan has the following syntax:

pattern[|pattern];match=1;<transformation>=<value>;[match=2; <transformation>=<value>;]

Where:

• Items in [ ] are optional.

• Pattern: the pattern that will be matched. One or more patterns. Each pattern is separated by a | pipe. The pipe is optional after the last pattern. Each pattern is implicitly numbered, starting from 1.

• Match; Transformation: A pair that identifies the pattern number to compare with the input, and the transformation to perform on the input when a match is obtained. The transformation is optional (meaning that if there is no transformation for a pattern, then the input that matches this pattern is not transformed). One or more pairs.

“match=” is a literal. “n” identifies the pattern. “transformation=” is replaced by a keyword, see below. “value” is replaced by a value.

Spaces are allowed only in the <value> items.

Example

\a\a.T|xxxxxxxxxx;match=1;prestrip=2;match=2;pre=8;

where:

• \a\a.Tis the first pattern.

• xxxxxxxxxx;is the second pattern.

• match=1;prestrip=2;is the first match-transformation pair.

• match=2;pre=8;is the second match-transformation pair.

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.

Element Origin Description

0 1 2 3 4 5 6 7 8 9 Literals Literal digits, used as is. # * a to z Literals Literal characters, used as is. Special cases:

• The literal x character is represented by \x.

• The literal t character is represented by \t.

x Digit map rules Wildcard for any single digit, 0 to 9.

Bria 4 for Mac User Guide – Retail Deployments

Element Origin Description

\a Regular

expression rules

[digit-digit] Regular

expression rules

[charactercharacter]

[digit1, digit2, digit3]

. Digit map rules Repeat the last element 0 or more tim es. For example, xxxx. means repeat the last x 0 or

T Digit map rules A timeout period will take place before automatic dialing starts.

Regular expression rules

Wildcard for any single alphanumer ic character.

A digit within the specified range.

A character within the specified range.

One of the characters in the collection.

more times, which means this pattern matches three or more digits (not four or more digits)! Use of this element results in a pattern with “minimum requirements”.

The T timer forces Bria to wait after a match is made. This timer should always be included in these situations:

• Any pattern that uses the . (dot). For example, if the pattern is xxxx. then adding a timer lets you type three or more digits. If there is no timer, then as soon as you type three digits, Bria makes the match as soon as you type three digits.

• Any dial plan that has two patterns that are similar in elements but dif fe ren t in len gth. For example, if one pattern is xxx and the other pattern is xxxxxxx, then adding the timer lets you continue typing past three digits, in order to get a match on the second pattern.

In this situation, the T timer should be included in the shorter pattern.

Timers

There are two timers:

• T timer is 4 seconds.

• The long timer is 20 seconds. These timers are used in input comparison, as described in “How the Input Is Processed” on page 80.

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.

Order of Transformations

These transformations are always performed in the following order (the order in which the transformations are entered in the dial plan is not significant):

prestrip > poststrip > pre > post > replace

CounterPath Corporation

B.2 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 p rocess 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 tran sfor matio n is p erformed. If no match is fo und, the default account is selected and no transformation is performed.

• If you are typing the input, the digits are compared one by one as they are entered. The comparison will result in one of the types of matches described in the table below.

It is possible for the same input to get matched to different dial plans depending on whether the input is entered on the fly or dragged. It is important to keep this in mind when design ing dial plan patterns.

Results of the Comparison

Type of Match Conditions

Partial match The characters typed so far follow the pattern but

there are not yet enough characters for a pending or complete match.

Pending match • The pattern has no . (dot) but does have the T

timer. Th ere is a perfect match.

• The pattern has a . (dot) and the T timer. The minimum requirements are met.

Complete match • The pattern has no . (dot) and no T timer.

There is a perfect match.

• The pattern has a . (dot) but does not have the T timer. The minimum requirements are met.

No match The characters typed do not match the patterns

for any dial plan.

Result if You Press

Enter or Dial

The default account is selected. No transformation is performed.

This pattern's account is selected and the transformation is performed.

This pattern's account is selected and the associated transformation is performed.

The default account is selected and no transformation is performed.

Result if You Stop Typing

If you stop typing for the long timer length (20 seconds), then the default account is selected. No transformation is performed on the characters typed so far.

If the T timer expires, this pattern's account is selected and the transformation is performed.

This pattern's account is selected and the associated transformation is performed.

Nothing happens even after the T timer and long timer have expired.

Bria 4 for Mac User Guide – Retail Deployments

B.3 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. The timer forces Bria to wait after detecting a three-digit number beginning with 3, in case you are actually dialing a local call starting with

1xxxxxxxxxx The second pattern is any eleven-digit number beginning with 1. Prefix with 9 and dial as is.

The assumption is that this is a long-distance PSTN call within North America (within North America, all long-distance calls start with 1).

[2-9]xxxxxxxxx The third pattern is any ten-di git number beginning with a number other than 1. The

assumption is that this is a local PSTN call within a ten-digit dialing zone.

+x.T; The fourth pattern is a number of any length that begins with +, to indicate an international

PSTN call from North America. Delete the +, prefix with 9011 (011 is the number to access

an international line from North America). match=2;pre="9"; For the second pattern, prefix 9 to access an outside line. match=3;pre="91"; For the third pattern, prefix 9 and 1 to access an outside line and enter the long-distance code. match=4;prestrip=1;pre="9011" For the fourth pattern, remove the + and prefix 9011 to access an outside line and enter the

international code.

Example 3

#1xxxxxxxT|#19xxxxxxx|xxxxxxxT|9xxxxxxx|;match=1;prestrip=2;pre=9;match=2; prestrip=2;match=3;pre=9;

#1xxxxxxxT The pattern is an account prefix followed by seven digits. The timer forces Bria to wait to

allow a match to the second pattern. The #1 is stripped off and 9 is prepended to access an

outside line. #19xxxxxxx The pattern is an account prefix followed by a 9 and seven digits. The #1 is stripped off. xxxxxxxT The pattern is seven digits. The timer forces Bria to wait to allow matching to the fourth

pattern. 9 is prepended to access an outside line. 9xxxxxxx The pattern is a 9 and seven digits. The input is not transformed.

This example assumes that the dial plan belongs to the first account. The dial plan is slightly trivial, because it do es not cover al l the situations that a dial p lan should be designed for

(local calls, long-distance calls, international calls, and so on for the locale). However, the example does illustrate two ideas:

CounterPath Corporation

• Handling of the account prefix (#1), if you are up grad in g fro m Br ia 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 b e in the hab it of enteri ng the acco unt prefix, you may want to include this pattern to handle such a scenario.

• Distinguishing between a local seven-digit call in which 9 is not dialed (to access an outside line) and one in which 9 is dialed to access an outside line.

Bria 4 for Mac User Guide – Retail Deployments

C 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 33.

Heading Description

business_number business_numbern, where n is 2 to 6 categories Maps to Bria groups default_address Maps to the Presence field default_address_comm Always specifies IM, if default_address is specified. This

heading does not map to a Contact Profile field default_address_type Specifies SIP or XMPP display-name email_address email_addressn, where n is 2 to 6 fax_number fax_numbern, where n is 2 to 6 given_name home_number home_numbern, where n is 2 to 6 mobile_number mobile_numbern, where n is 2 to 6 other_address other_addressn, where n is 2 to 6 postal_address presence_subscription TRUE or FALSE sip_address Maps to the Softphone field. sip_addressn, where n is 2 to 6 surname web_page web_pagen, where n is 2 to 6 xmpp_address Maps to the Instant Message field. This field must always

specify an XMPP address xmpp_addressn, where n is 2 to 6

CounterPath Corporation

D Other Ways to Run Bria

D.1 From a Hyperlink

You can attach a hyperlink to a phone number or softp hone address that, when clicked, starts Bria and dials the number. Bria supports three protocols: sip, tel, and callto.

Attach a hyperlink with this format:

<a href="sip:address_or_number">dial address_or_number

For example:

<a href="sip:kperera@domainA.com">dial kperera@domainA.com</a>

</a>

Bria 4 for Mac User Guide – Retail Deployments

E Glossary

Broadband Broad or wide bandwidth. In data transmission, the wider the ban d, the mo re 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. A dialup or ISDN connection typically provide a narrow bandwidth for data transmission.

Codec The format by which audio or video streams are compressed for transmission over

networks.

Dial plan The rules that Bria follows in order to interpret the softphone address or phone

number that the user has entered and to modify the number or address, as require d, to ensure that the call will be placed successfully.

DTMF Dual-tone multi frequency. DTMF is the system that is used in interactive voice-

response menu systems such as the menu system for accessing voicemail messages. The DTMF system allows the user to interact with the menu by pressing keys on a dialpad or keyboard.

Firewall A technology that prevents unauthorized people connecting to your computer and to

the applications running on the computer.

IM Instant Messaging. A technology that lets users send text message and files for near

instantaneous delivery and display on each others’ computers.

MWI Message Waiting Indicator. An indicator that there is a voicemail message for the

owner of an account.

Narrowband In data transmission, the wid er 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. A dialup or ISDN connection typically provide a narrow bandwidth for data transmission.

Presence An instant messaging feature that allows users to share informa tion abou t their online

status. PSTN Public Switch Telephone Network. The traditional land-line phone network. SIP account An account that provides the user the ability to make VoIP phone calls. The account

encapsulates the rules and functions the user can access. Softphone address The address used to connect to a SIP endpoint. In other words, the “phone number”

used in a VoIP phone call. For example, sip:joseph@domainA.com. USB device Universal Serial Bus device. A device that follows a specific communications VoIP

Voice over Internet Protocol. A variation of IP used for sending voice data over the

internet, in other words, used for making phone calls over the internet. vCard An electronic business card that is often attached to an e-mail. It often appears as a

“signature block” that identifies the person, their title, and their business. VoIP service provider A business that provides a VoIP service, allowing a user to connect to the internet in

order to make VoIP phone calls using Bria. The VoIP service provider sets up a SIP

account for the user.

CounterPath Corporation

CounterPath Bria 4 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

1 Introduction

Standard Telephone Features

Enhanced Features and Functions

2 Installation and Setup

2.1 Getting Ready

Account Information

XMPP Accounts

2.2 Configuring Bria

Setting up Notifications

Setting up Accounts

Setting up for Voicemail

Populating your Contact List

2.3 Troubleshooting

2.4 Checking for Bria Updates

3 Making Phone Calls

3.1 The Onscreen Softphone

The Bria Menu

Receiving an Online Status Request

3.2 Placing a Call

3.3 Handling Incoming Calls

3.4 Handling an Established Call

3.5 Transfering a Call

Basic (Unattended) Transfer – Transfer this Call

Attended Transfer – Call then Transfer

3.6 Handling Video Calls

3.7 Conference Calls

Starting a Conference Call

Managing the Conference

Video Conference Calls

3.8 Voicemail

3.9 Forwarding Calls

4 Other Bria Features

4.1 Instant Messaging

Sending an IM

Receiving an IM

4.2 Sending a Broadcast IM

4.3 Group Chat (Conference IM)

4.4 Chat Rooms

4.5 Viewing Messages

4.6 Sending and Receiving Files

Sending Files

Receiving Files

5 The Contacts Tab

5.1 Populating the Contact List

Populating from the Mac Address Book

Populating by Importing Contacts

5.2 Managing Contacts and Groups

Adding a Contact

Adding a Contact using an Existing Address

Modifying the Contact List

5.3 Using Contacts

5.4 Sharing Online Status

Sharing Online Status

Setting your Online Status

Adding Contacts to the Alert List (Buddy Pounce)

5.5 Privacy

Setting up Controls in Advance

Setting up Controls “on the Fly”

6 Using Other Resources

6.1 The History Tab

Managing the List of Calls

Phoning from History

6.2 The Favorites Tab

7 Configuring Bria

7.1 Configuring Accounts: the Accounts Tab

XMPP Account

SIP Accounts – General

SIP Accounts – Voicemail

SIP Accounts – Topology

SIP Accounts – Presence

SIP Accounts – Storage

SIP Accounts – Transport

SIP Accounts – Advanced

7.2 General Preferences

Preferences – Application

Preferences – Privacy