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 the Mac Address Book


You can populate the Bria contact list by synchronizing with your Mac Address book. When you start Bria, contacts are fetched from the address book. When you add or modify a contact in Bria, the contact is copied to the Mac Address book. Similarly, when you add or modify a contact in the Mac Address book, the contact is copied to Bria.


To synchronize with the Mac Address book, set the Bria contact storage method to this value.


Setting up the Mac Address Book

To use the Mac Address book effectively, make sure that softphone addresses in that address book are correctly labeled. The addresses must be of type “Phone” and the address label must the “softphone” (all lower case). You can create a “softphone” custom address label within the Address book.



In addition, if you have an XMPP account, any Jabber addresses in the Mac Address book must be set up in entries of the type “Phone” with the label “jid” (in lower case).


Switching to the Mac Address Book

If you started using Bria with contact storage set to Local and then want to switch to the Mac Address book, you can export the contacts currently stored locally in Bria and then import them into the Mac Address book. Then when you switch the Bria contact storage method to Mac Address book, these contacts will reappear along with all the other contacts from the Mac Address book.


Importing Contacts

You can populate the Bria contact list by importing from an external file or files. The new contacts will be added to the existing contacts.


You can import a contact list from:

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


1. From the menu, 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:

  • uri: 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).
  • jid: Bria recognizes a value in this field as a Jabber (XMPP) address and will map this field to the Jabber 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, entry_id, given_name, surname
  • business number
  • pres_subscription, which instructs Bria how to subscribe to the contact. Enter “true” for contacts whose online presence you want to see. Leave blank or enter “false” for others. Entering “true” assumes that the user has a SIP or XMPP address (depending on which account handles presence).

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.