Bria 3.
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 © March 2010 CounterPath Corporation. All rights reserved. Windows, Windows Vista, Active Directory, Excel and Outlook are registered trademarks of Microsoft Corporation in the United States and other countries.
Contents Introduction...................................................................................................................................1 Installation and Setup....................................................................................................................3 Getting Ready .........................................................................................................................3 Installing Bria .................................................................
CounterPath Corporation ii
1 Introduction Read this manual if you who are deploying Bria without the help of a system administrator. If you are working in an enterprise that has a system administrator who is deploying Bria across the enterprise, read the user guide “Using Bria 3.0 for Windows – for Enterprise Deployments”. Bria is a softphone from CounterPath that enables you to make VoIP voice and video calls, send and receive instant messages, share online status (presence) information, and exchange files.
CounterPath Corporation • Support for the following video codecs: H.263, H.263+ 1998, H.264. • Automatic selection of the best codec based on the other party’s capability, the available bandwidth, and network conditions. Bria switches the codec within a call in response to changing network conditions. Compliance to 3261 SIP standard.
2 Installation and Setup 2.1 Getting Ready SIP Account Information After choosing a VoIP service provider, you will need the following information: • • • • User name and password Authorization Name (if applicable) Domain Firewall traversal and other network information; see “Configuring Bria” on page 43. XMPP Accounts If you use an XMPP service for instant messaging or presence, you will need the following information: • • • Jabber ID: user name and domain. For example, jsantos@domainXMPP.com.
CounterPath Corporation Multimedia Device Requirements Bria requires both speakers and a microphone to make calls. Any of the following configurations are acceptable: • • • • • External speakers and microphone Built-in speakers and microphone Dual-jack multimedia headset USB multimedia headset USB phone. HID-compliant devices can be configured to work with Bria. Video Cameras Calls made with Bria will work without a video camera, but a video camera is necessary to allow other parties to see your image.
Bria 3.0 for Windows User Guide – Retail Deployments Setting up Accounts After obtaining SIP, SIMPLE, and (if applicable) XMPP account information from your VoIP service provider, you can set up Bria accounts. 1. From the Bria menu, choose Softphone > Account Settings. The SIP Account window appears. 2. In the Account tab, complete the User Details area with the information obtained from your VoIP service provider. 3. Complete the remaining tabs as specified by your service provider or to suit your setup.
CounterPath Corporation 6
Bria 3.0 for Windows User Guide – Retail Deployments Setting up for Voicemail Your VoIP service provider may offer voicemail. If it does, then you can set up some voicemail features in Bria. See page 50. Setting up a Contact List Typically, you will want to create contacts in order to easily make phone calls, send IMs and transfer files. You can set up contacts in several ways: • • • • During a call that you place or receive, you can add the other party to your contact list.
CounterPath Corporation 8
3 Using Bria 3.1 Starting and Quitting Bria If Bria is not already running, start it as you would any other program: Use the Windows Start menu or double-click the desktop icon. Bria appears. To quit Bria, click Softphone > Exit or press Ctrl-Q. 3.2 The Onscreen Softphone Show/hide directory, IM archive, and workgroup Close to system tray. This icon does not shut down Bria Bria menu. See below. Minimize to system tray Call entry field See page 11. Open/close video window Show/hide dial pad Resources.
CounterPath Corporation The Bria Menu Bria. •Accounts. These settings control how Bria interacts with your VoIP service provider, and are set individually for each account. See “Configuring Accounts” on page 43. • Preferences. These settings control the way that you work with Bria and apply to all accounts. See “Configuring Preferences” on page 59. • Exit. To shut down Bria. You can also exit by pressing Ctrl+Q. View. Changes how Bria looks. Contacts. Lets you work with contacts. Actions.
Bria 3.0 for Windows User Guide – Retail Deployments 3.3 Placing a Call You can contact someone using: • • A traditional phone number, if supported by your VoIP service provider. A softphone address (for example, kperera@domainA.com) 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. A call panel opens showing the call attempt, then the call established.
CounterPath Corporation Call entry field Click to place the call Auto complete suggestions 12
Bria 3.0 for Windows User Guide – Retail Deployments Selecting the Account to Use This information applies only if you have more than one SIP account set up and enabled. When you place a call, you can explicitly specify the account to use for that call. If you choose Auto Select, then the account to use depends on your dial plan rules (page 80). If there are no dial plan rules, then the “preferred” account (page 43) is used. Choose the account to use.
CounterPath Corporation Placing another Call To place a new call (without hanging up on the current call), simply place the call in the normal way. A second call panel opens below the current call. The first call is automatically put on hold. 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.
Bria 3.0 for Windows User Guide – Retail Deployments 3.4 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.) As soon as an incoming call is received, a call panel appears, showing information about the call. In addition, the Call Alert box appears, even if Bria is minimized. For information on setting call alert preferences, see page 60.
CounterPath Corporation Auto Answer You can set Bria to automatically answer all incoming calls. To turn auto answer off and on, in the Call panel click Options > Auto Answer. The AA icon appears in the menu bar. Turn Auto Answer on or off The Auto Answer indicator appears on the menu bar. Auto answer is initially configured to auto-answer after one ring, and to send only your audio when the call is established. To change this configuration choose Softphone > Preferences > Call Automation.
Bria 3.0 for Windows User Guide – Retail Deployments 3.5 Handling an Established Call While the call is in progress you can: • • • • • • Control the audio: use the speakerphone, mute the call, control volume. Record the call. Put the call on hold. Add the caller as a contact. Transfer the call. See the next page. Add video. Pause and resume video when video is already present. See “Handling Video Calls” on page 20 Place another call (current call is automatically put on hold).
CounterPath Corporation 3.6 Transfering a Call Basic (Unattended) Transfer – Transfer this Call You can transfer a call to any number without first speaking to the other person. The call will be • • If you hang up immediately and the other person does not answer, the person you are transferring will have to hang up. If you do not hang up immediately and the other person does not answer, the call will come back to you Click the Transfer button The call is put on hold and a call entry field appears.
Bria 3.0 for Windows User Guide – Retail Deployments Attended Transfer – Call then Transfer You can first speak to the target (the person you are transfering the call to), then click Transfer to complete the transfer.
CounterPath Corporation 3.7 Handling Video Calls Click the down arrow and choose Video call Show/hide dialpad Call entry field Placing a Video Call You can start a call with video. See the table. How Keying From the... Dialpad or computer keyboard Description 1. Enter the number or address in the call entry field using the dialpad or the computer keyboard If entering a softphone address, you can enter the entire address (kpereira@domainA.com) or just the name (kpereira).
Bria 3.0 for Windows User Guide – Retail Deployments Adding Video If you have a camera, you can click Start Video ( may (or may not) start sending their video to you. ) in the call panel. When you add video, the other party Other Party Adds Video If the other party starts their video, your video window automatically opens and the video is played. You can start sending your own video, if desired (and assuming you have a camera) by clicking Start Video( call panel.
CounterPath Corporation 3.
Bria 3.0 for Windows User Guide – Retail Deployments Managing the Conference Mute. When you mute during a video call, you may also want to click Stop Video to stop the video feed. Participant menu Conference call entry field Adding More Participants You can add more participants to an existing conference in any of these ways: • • • Right-click on a contact or history item and choose Add to Conference Call. In the conference call panel, enter a name in the call entry field and click Add.
CounterPath Corporation Video Conference Calls This person already has video. This person does not have video. To add this person to the group who will receive video, choose Start video from the participant menu. Closing the video window stops sending video to all participants who have “Video” beside their name.
Bria 3.0 for Windows User Guide – Retail Deployments 3.9 Voicemail If your service includes voicemail and you have set up voicemail options (page 50), 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. Voicemail icon 3.10 Forwarding Calls Forwarding Calls You can enable or disable forwarding so that calls will be forwarded to another number.
CounterPath Corporation 3.11 Instant Messaging Sending an IM 1. You can send an IM to a contact who has a softphone address. From the Contacts tab Right-click on the contact and choose Send Instant Message. The contact must have a softphone address. 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. 2. Type the message.
Bria 3.0 for Windows User Guide – Retail Deployments Conference IM—Group Chat Group chat allows you to exchange instant messages with a group of people in the same session. All people must have XMPP accounts configured in order to participate in group chat. There is no limit to the number of participants in a group chat. You can also invite more participants during a group chat session. 1. In the Address Book on the Contacts tab, select the desired contacts. Contacts must be online. 2.
CounterPath Corporation Viewing the IM Archive You can view your recent IM activity for any contact or group chat session. On the menu, choose View > Instant Message Archive. In the Archive window, select a contact from the list.
Bria 3.0 for Windows User Guide – Retail Deployments 3.12 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. Choose one of these actions: • • Right-click a contact and choose Send Files; a standard Open dialog box opens. Select the files to send and click Open. The Send Files dialog appears with a “waiting” message.
CounterPath Corporation 3.13 Workgroups Typically, workgroups are used only in enterprises and are set up by the system administrator. Click to join this established call Click to pick up this call that is coming into Al Michael’s line.
4 Using Resources 4.1 Contacts Tab Add a Contact Search entire contact list Filter contact list The online status of others. See page 38. The Contacts tab displays your contacts and lets you specify multiple contact methods for them, including: • • Softphone address Home phone number, business phone number, mobile phone number Contacts are typically organized into groups. Bria includes built-in groups: “Family”, “Friends” and “Work”. You can add more groups, as desired.
CounterPath Corporation Populating the Contact List At any time, but particularly when you first deploy Bria, you may want to populate the contact list with contacts from an external source. Synchronizing with Microsoft Outlook You can populate the Bria contact list by synchronizing with your Microsoft® Outlook® contacts. In this case, you are actually using your Outlook contacts from within Bria. When you start Bria, contacts are fetched from Outlook.
Bria 3.0 for Windows User Guide – Retail Deployments Exporting Contacts You can export a contact list to a comma-separated file, a pst file or a vcf file. 1. From the main menu, click the Contacts menu and choose Export Contacts. The Export Contacts wizard starts. 2. When you click Next, the export starts. The result is: • • For an Outlook export, the existing .pst file is updated to include the entries from the Bria contact list. If Outlook is open, the entries immediately appear in the contact list.
CounterPath Corporation Field Display as First name Description Only the “Display as” name is required. This is the name that will appear in the call panel and the Call Alert when this person phones you. Last name Group Click to show the list of groups and check each group to add this contact to. Contact Methods You must enter at least one contact method. Enter as many contact methods as you want. Softphone entries, Jabber entries and e-mail entries must have the format @.
Bria 3.0 for Windows User Guide – Retail Deployments Managing Contacts and Groups when Using Outlook The following information applies if you are using your Microsoft® Outlook® address book from within Bria. Adding a Contact Click , or right-click a group and choose Add Contact to Group. The Outlook Contact dialog appears. Complete the fields and save the information. The new contact will automatically appear in your Bria contact list.
CounterPath Corporation Using Contacts Phone or IM the person • • Double-click the contact to start a phone call or IM to the person (depending on how double-clicking is configured in the contact’s profile). Drag the contact to the call entry field to start a phone call. Phone the person Right-click and choose Call. If necessary, click the desired number. Send an IM Right-click and choose Send Instant Message. See page 26.
Bria 3.0 for Windows User Guide – Retail Deployments 4.2 History Tab Filter list Detach the history list Outgoing call, either attempted or established Incoming missed call Incoming call that was answered Managing the Lists of Calls You can right-click on an entry in a list to: • • • • Delete the entry. Delete all entries in the list. Edit the profile if the entry is a contact. Add as contact. The Add a Contact dialog appears.
CounterPath Corporation 4.3 Sharing Online Status You can publish your online status to contacts who have softphone address, and you can set up Bria to view the online status of other contacts. Typical online statuses are available, on the phone, busy, and so on.
Bria 3.0 for Windows User Guide – Retail Deployments 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 your status. Bria accepts this request automatically, and the other person can now see your status.
CounterPath Corporation Setting your Online Status Changing your Status Click the down arrow beside the online status indicator on Bria, and select the desired online status. See below. When your online status changes, the new status is sent to everyone who has permission to see your status Setting up Status Indicators You can create a custom status indicator: click the down arrow beside the status indicator, and choose Custom Message.
Bria 3.0 for Windows User Guide – Retail Deployments Adding Contacts to the Alert List (Buddy Pounces) You can add a contact to the Alert List in order to request to be notified when the online status of a contact changes. Right-click the contact or contacts and choose Add to Alert List. The Alert List icon appears beside the contact: Alert List icon When the contact’s status changes, a notification appears.
CounterPath Corporation 42
5 Configuring Bria You can configure Bria in several ways: • • Configure global behavior. See “Configuring Preferences” on page 59. Configure the behavior on a per-account basis. See “Configuring Accounts” on page 43. 5.1 Configuring Accounts Accounts Settings Window To work with accounts, choose Softphone > Account Settings from the menu. The Account Settings window appears, showing all the accounts set up.
CounterPath Corporation If you have more than one SIP account, the window appears as shown below. Enable accounts as instructed by your system administrator The functions this account is being used for. See below. 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 You can: • • • Add or remove an account. Enable one or more accounts. See below for details. Set or change account properties. Select the account and click Edit.
Bria 3.0 for Windows User Guide – Retail Deployments Setting the IM/Presence Account If you have more than one SIP account, set up for phone calls as follows: 1. Set up the “use for” information: • If you do not have an XMPP account: Open the Accounts tab for the one SIP account you want to use for IM and online status (presence) and check the Use for IM/Presence field.
CounterPath Corporation XMPP Account Fields with a red asterisk are required Table 1: XMPP Account Properties – Account Field Account name Protocol Description If desired, change the account name to something that is meaningful to you. For example, the name of the VoIP service provider. Read-only. Always specifies XMPP. User Details User ID Domain Password Display name Typically the account number for the softphone account. For example, kperera. Provided by the XMPP service provider.
Bria 3.0 for Windows User Guide – Retail Deployments Table 1: XMPP Account Properties – Account Field Resource Priority Description Optional resource, as specified in RFC 3920. For example “/home”. If this setting is blank and the User ID includes a resource, the value from that ID is used. If both are specified, the value from this Resource field is used. If no resource is specified, the XMPP server will assign a temporary resource. The priority, as per RFC 3921. The default is 0.
CounterPath Corporation SIP Account Properties – Account Fields with a red asterisk are required Table 2: SIP Account Properties – Account Field Account name Protocol Description If desired, change the account name to something that is meaningful to you. For example, the name of the VoIP service provider. Read-only. Always specifies SIP. User Details User ID Domain Password Display name Typically the account number for the softphone account. For example, kperera.
Bria 3.0 for Windows User Guide – Retail Deployments Table 2: SIP Account Properties – Account Field Send outbound via Description 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.
CounterPath Corporation SIP Account Properties – Voicemail These settings let you set up to interact with your VoIP service provider’s voicemail service. They also let you configure Bria to forward calls in several situations, independent of your VoIP service provider’s voicemail service. Your service provider may provide the ability to set up for voicemail outside of Bria, for example, by phoning a softphone address and following the voice prompts, or by accessing a website.
Bria 3.0 for Windows User Guide – Retail Deployments Table 3: SIP Account Properties – Voicemail Field Number to dial for checking voicemail Description Optional, but complete this field only if your VoIP service includes voicemail. • Completing this field activates the vicarial icon on the softphone. 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.
CounterPath Corporation SIP Account Properties – Topology Table 4: SIP Account Properties – Topology Field Firewall traversal mode Range of ports used on local computer 52 Description Leave the default. Or if you have problems making phone calls, contact your VoIP service provider for information on their firewall traversal solution. The appropriate setting depends on your computer setup: • Checked: If your computer is behind a restrictive firewall that only allows specific port ranges to be used.
Bria 3.0 for Windows User Guide – Retail Deployments SIP Account Properties – 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.
CounterPath Corporation SIP Account Properties – Storage These settings let you set up a remote storage system for the buddy list for this SIP account. (Note that the buddy list for an XMPP account is always stored on the XMPP server; no configuration is required). If you plan to use your Microsoft Outlook address book from within Bria (page 72), your buddy list must be stored locally.
Bria 3.0 for Windows User Guide – Retail Deployments SIP Account Properties – Transport Table 7: SIP Account Properties – Security Field Signaling Transport7 Encryption Description Contact your VoIP service provider to identify the types of transport that are supported. Then choose a supported transport: • Automatic: Bria sets up the transport based on the capabilities of the network and the Bria computer. Choose this option if you do not care which transport is used.
CounterPath Corporation Setting up for Security within Bria The options for media encryption are described in the following table. Table 8: Security Options Option Make and accept only encrypted calls Do not allow encrypted call 56 How Outgoing Calls are Handled How Incoming Calls Are Handled Bria will place all calls with TLS. The call INVITE Bria will only accept INVITEs that are for encrypted calls. will specify SRTP media encryption.
Bria 3.0 for Windows User Guide – Retail Deployments SIP Account Properties – Advanced Table 9: SIP Account Properties – Advanced Field Description Register Settings Reregister every Minimum time Maximum time The time interval between Bria’s attempts to reregister in order to refresh the account registration with the VoIP service provider for this account. A value of zero means not to reregister after the initial registration.
CounterPath Corporation Table 9: SIP Account Properties – Advanced Field Description Timers Enable session timers Default session time Session timer preference 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.
Bria 3.0 for Windows User Guide – Retail Deployments 5.2 Configuring Preferences Choose Softphone > Preferences. The Preferences window appears. The Preferences panels let you control the way that you work with Bria. Preferences – Application This panel lets you set your preferences for general GUI behavior and lets you set up for login. Login Options Login is typically used only in enterprises. You should not enable login.
CounterPath Corporation Preferences – Alerts & Sounds The tabs on this panel let you control the Call Alerts box and lets you assign sounds. Alerts You can control whether the Call Alert box is displayed in different situations. You can also control how you are alerted to an incoming IM: either with a small IM Alert box or with the IM window itself. Sounds You can assign specific sounds to a variety of actions or “events”. 1.
Bria 3.0 for Windows User Guide – Retail Deployments Preferences – Devices Bria automatically detects devices at each startup, and selects the most appropriate device for each purpose. If you do not like this selection, you can override it on this panel. If you override a selection, it will apply the next time you start Bria, unless the device is no longer available, in which case Bria will again select the device to use.
CounterPath Corporation Table 10: Preferences – Devices Field Description Speakerphone Mode Speaker Change this field only if you want to override the devices that Bria automatically selected. Make the appropriate choice: • Select the device that you want to use for audio out (the sound you hear) when the Speaker Phone button is pressed. Make sure you select a speaker device (not the headset). • Select None if you do not have a speaker phone. The Speaker Phone button on the dialpad is disabled.
Bria 3.0 for Windows User Guide – Retail Deployments HID Devices: USB Device Button Setup You can assign functions to a HID-compliant device. For example, you can set the green button so that it answers an incoming call.
CounterPath Corporation Preferences – Network Table 11: Preferences – Network Field Network Connection Speed Description Select the type of network connection for your computer. The sliders move to show the bitrate that will be used for sending and receiving. These rates are typical rates for the selected configuration. If you know that your computer and network can handle a faster sending speed, click Custom and move the slider. It is recommended that you not change the receiving speed.
Bria 3.0 for Windows User Guide – Retail Deployments Preferences – Audio Codecs This panel shows all the codecs that are included in the retail version of Bria. You can enable or disable codecs as desired. With only one codec enabled, all calls made will use that codec. With more than one codec enabled, Bria automatically chooses the best codec based on the other party’s capability, the available bandwidth, and network conditions. You cannot change the properties of any codecs.
CounterPath Corporation Supported Codecs Codec Narrowband Wideband Royalty-bearing Included in Bria AMR Wideband (G.722.2) 3 Broadvoice-32 3 3 Broadvoice-32 FEC 3 3 DVI4 3 3 3 3 DVI4 Wideband 3 EVRC 3 3 G.711aLaw * 3 3 G.711uLaw * 3 3 3 G.722 3 G.723 3 3 G.726 3 3 G.
Bria 3.0 for Windows User Guide – Retail Deployments Preferences – Video Codecs Video codecs describe the format by which video streams are compressed for transmission over networks. Some codecs require less bandwidth than others, but may result in lower video quality. You can enable or disable codecs as desired. You may decide to disable a codec even though your VoIP service provider supports it. With only one codec enabled, all calls made will use that particular compression format.
CounterPath Corporation Preferences – Quality of Service These fields appear only on versions of Bria that include video. The Quality of Service panel lets you request a specific transport service for audio, video and signaling traffic.This service is through DSCP (also known as ToS). In a network that has the default configuration, the recommended value for audio is 46, because “46” is the standard marking for audio. There are two types of services.
Bria 3.0 for Windows User Guide – Retail Deployments Preferences – Media Quality Video Quality Enable this option Check or uncheck to flip the video image. Resolution – Limit available resolution If you enable this field, Bria will determine the maximum quality that your computer can handle and will disable unapplicable options in the list of possible resolutions 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.
CounterPath Corporation Preferences – Directory Typically, directories are used only in enterprises and are set up by the system administrator.
Bria 3.0 for Windows User Guide – Retail Deployments Preferences – Call Automation These settings let you configure how you want auto answer to handle incoming calls, when Auto Answer is enabled. (To enable Auto Answer, see page 16).
CounterPath Corporation Preferences – Contact Storage These settings let you set up a remote storage system for your contact list. The contact list holds general information for contacts and is automatically loaded at startup, even if no accounts are enabled. These settings let you set up a remote storage system for your contact list via WebDAV, XCAP or Microsoft Outlook. • • • If you set storage to Local, the contact list is stored only on your computer.
Bria 3.0 for Windows User Guide – Retail Deployments Table 12: SIP Account Properties – Storage Field Description XCAP Settings Username and password Root URL The user name and password to log into the storage server. URL of an appropriate root folder on the remote server. The factory setting is https:// xcap.
CounterPath Corporation Preferences – Advanced Table 13: Preferences – Advanced Field Description Use slower but more compatible video Turning this field on may improve performance when running Bria on older hardware. format DTMF You may need to change the DTMF configuration if you cannot interact with interactive voice response systems (auto attendants, voice-activated menus, and so on).
A Troubleshooting Choose Help > Troubleshooting to display the Troubleshooting window. Testing Audio and Video Devices You can verify that your microphone, speakers and camera are working and can set the volume to a comfortable level without having to actually place a phone call.
CounterPath Corporation Testing the Network Connection You can verify that you are successfully connected to the network.
Bria 3.0 for Windows User Guide – Retail Deployments Testing Audio Quality While you are on a phone call, you can test the quality of the audio. Note that to perform a valid test, you should be on an established call (not a call attempt).
CounterPath Corporation Diagnostics Only use this panel if instructed to do so by your support representative at your VoIP service provider.
Bria 3.
CounterPath Corporation C Dial Plan When a call attempt is made, the call input (what you type, select or drag onto the call entry field) is processed to select the SIP account to use and to modify the input if that is required to ensure that the call gets placed successfully. This ability to select an account and modify the input relies on the existence of a “dial plan” for each account.
Bria 3.0 for Windows User Guide – Retail Deployments C.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;=;[match=2; =;] Where: • • • Items in [ ] are optional. Pattern: the pattern that will be matched. One or more patterns.
CounterPath Corporation Pattern Valid Content The content for a pattern follows the digit map rules of RFC 2705, supplemented by the rules for regular expressions. Where there is an overlap between the digit map and regular expression rules, the digit map rules apply. For this reason, there are some special cases, included in the table below. The following table describes the most common elements. As mentioned, all regular expression elements are supported. Some elements use the back slash \ character.
Bria 3.0 for Windows User Guide – Retail Deployments 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.
CounterPath Corporation Type of Match Pending match Conditions • The pattern has no . (dot) but does have the T timer. There is a perfect match. • The pattern has a . (dot) and the T timer. The minimum requirements are met. Result if You Press Enter or Dial This pattern's account is selected and the transformation is performed. Result if You Stop Typing If the T timer expires, this pattern's account is selected and the transformation is performed. Complete match • The pattern has no .
Bria 3.0 for Windows User Guide – Retail Deployments C.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.
CounterPath Corporation • Handling of the account prefix (#1), if you are upgrading from Bria 1.1 and are accustomed to entering the account number. Use of # to identify the account is now deprecated. The dial plan should be capable of determining the account to use for this number. However, since users may still be in the habit of entering the account prefix, you may want to include this pattern to handle such a scenario.
Bria 3.0 for Windows User Guide – Retail Deployments D Contact List Headings Following is a list of all the headings that are used in the Bria contact list. This list can be useful when formatting a contact list in order to import it into Bria.
CounterPath Corporation E Other Ways to Run Bria E.1 From a Hyperlink You can attach a hyperlink to a phone number or softphone address that, when clicked, starts Bria and dials the number. Attach a hyperlink with this format: dial For example: dial kpereira@domainA.com E.2 From the Command Line You can start Bria from a DOS prompt. You may need to add Bria.exe to the PATH. Then type: Bria30.
Bria 3.0 for Windows User Guide – Retail Deployments F Glossary AEC AGC AVI Broadband Codec Dial plan DTMF HID IM IP IP address Media MWI Narrowband Presence Proxy PSTN Acoustic echo cancellation. Processing of the audio or video signal to reduce the echo effect that can arise with a speakerphone or that can arise if the sound from the speakerphone or headphone leaks into the microphone. Automatic gain control.
CounterPath Corporation RFC RTP Signaling SIMPLE protocol SIP SIP account softphone address SRTP TCP TLS UDP URI URL USB device VAD vCard VoIP VoIP service provider WAV 90 Request for Comment. A document that describes an aspect of an internet technology. An RFC may be a proposed, draft or full internet standard. Real-time Transport Protocol. A protocol for delivering the media portion of a data transmission over an IP network. SRTP is another media protocol.
