How does the sync.blue® address book work?

Benefits

sync.blue® typically does not store contacts independently and instead synchronizes them live between two accounts, such as a Microsoft 365 account (groupware) and a Placetel account (telephone system).

In some scenarios, however, it is necessary for sync.blue® to deliberately serve as an online contact storage and make the contacts available for download in a variety of formats on demand:

• Phone book for IP phones: Contacts from a specific address book source, such as Microsoft 365, should be made available as a phone book for an IP phone (e.g., snom or Yealink).
• Merging multiple accounts: Contacts from different accounts such as Microsoft 365, Apple iCloud, and Google Contacts should be merged and made available for a separate corporate application without duplicates.
• Push instead of pull: Contacts cannot be retrieved from an internal corporate application by sync.blue® and should be pushed from the internal network into the sync.blue® address book.

Technology

How do contacts get into the sync.blue® address book?

sync.blue® address book as a connection destination

Select the sync.blue® address book as the destination in a classic sync.blue® connection (e.g., source "Microsoft 365" and destination "sync.blue® address book").

Multiple connections can be created with the same sync.blue® address book account as the destination.

sync.blue® Address Book as Push Destination

1. Create a local CSV file according to these instructions.

2. Push this CSV file named contacts_5.csv to the sync.blue® Address Book e.g., via cURL:

Example for macOS:

curl -F 'file=@contacts_v5.csv' \
-H 'Authorization: YOUR_API_KEY' \
https://addressbook.sync.blue/storage/v1.0/addressbooks/<UID from your sync.blue® address book>/upload_csv

Example for Windows: 

curl --insecure -F "file=@contacts_v5.csv" ^
-H "Authorization: YOUR_API_KEY" ^
https://addressbook.sync.blue/storage/v1.0/addressbooks/<UID from your sync.blue® address book>/upload_csv

Technical requirements:

• Request: POST
• Form type: multipart/form-data
• Parameter name of the CSV file: file

How does this sync.blue® Address Book Contacts Ready?

Contacts are currently still provided via the sync.blue® Directory. To do this, use a sync from the sync.blue® Address Book to the sync.blue® Directory.

Depending on the URL extension, the sync.blue® Directory outputs contacts in the desired format:

• As a CSV file (example: https://directory.sync.blue/contacts/DEMOabcABC0123)
• As an XML file for Yealink IP phones (example: https://directory.sync.blue/contacts/DEMOabcABC0123/yealink/v1)
• As an XML file for snom IP phones (example: https://directory.sync.blue/contacts/DEMOabcABC0123/snom/v1)
• As an XML file for Gigaset IP telephones/DECT bases (example: http://directory.sync.blue/contacts/DEMOabcABC0123/gigaset/v1)
• As CardDAV URL (under development)

Security and data protection

• Contacts are only available via HTTPS (SSL-encrypted)
• Contacts are only available if the personal API key is known

More on this here.