Wie funktioniert das sync.blue® Adressbuch?

Nutzen

In der Regel speichert sync.blue® eigenständig keine Kontakte und synchronisiert diese stattdessen live zwischen zwei Accounts, wie z.B. einem Microsoft 365 Account (Groupware) und einem Placetel Account (Telefonanlage).

In manchen Szenarien ist es aber erforderlich, dass sync.blue® bewusst als Online-Kontaktspeicher dient und die Kontakte in verschiedensten Formaten auf Abruf zum Download bereitstellt:

• Telefonbuch für IP-Telefone: Kontakte aus einer bestimmten Adressbuch-Quelle wie z.B. Microsoft 365 sollen für ein IP-Telefon (z.B: snom oder Yealink) als Telefonbuch bereitgestellt werden.
• Zusammenführung mehrerer Accounts: Kontakte aus verschiedenen Accounts wie z.B. Microsoft 365, Apple iCloud und Google Contacts sollen zusammengeführt und für eine eigene Unternehmensanwendung ohne Duplikate bereitgestellt werden.
• Push statt Pull: Kontakte können aus einer internen Unternehmens-Anwendung nicht von sync.blue® abgerufen werden und sollen vom internen Netzwerk aus in das sync.blue® Adressbuch gepusht werden.

Technik

Wie kommen Kontakte in das sync.blue® Adressbuch?

sync.blue® Adressbuch als Verbindungs-Ziel

Wähle das sync.blue® Adressbuch als Ziel in einer klassischen sync.blue® Verbindung (z.B. Quelle "Microsoft 365" und Ziel "sync.blue® Adressbuch"). 

Es können mehrere Verbindungen angelegt werden mit demselben sync.blue® Adressbuch Account als Ziel.

sync.blue® Adressbuch als Push-Ziel

1. Erstelle eine lokale CSV-Datei nach dieser Anleitung.

2. Pushe diese CSV-Datei namens contacts_5.csv in das sync.blue® Adressbuch z.B. per cURL:

Beispiel für macOS: 

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

Beispiel für Windows: 

curl --insecure -F "file=@contacts_v5.csv" ^
-H "Authorization: YOUR_API_KEY" ^
https://addressbook.sync.blue/storage/v1.0/addressbooks/<UID_des_sync.blue_Addressbuches>/upload_csv

Technische Anforderungen:

• Request: POST
• Formular-Typ: multipart/form-data
• Parametername der CSV-Datei: file

Wie stellt das sync.blue® Adressbuch Kontakte bereit?

Die Bereitstellung von Kontakten erfolgt derzeit noch über das sync.blue® Directory. Verwende hierzu einen Sync von dem sync.blue® Adressbuch in das sync.blue® Directory. 

Je nach URL-Endung gibt das sync.blue® Directory Kontakte in dem gewünschten Format aus:

• Als CSV-Datei (Beispiel: https://directory.sync.blue/contacts/DEMOabcABC0123)
• Als XML-Datei für Yealink IP-Telefone (Beispiel: https://directory.sync.blue/contacts/DEMOabcABC0123/yealink/v1)
• Als XML-Datei für snom IP-Telefone (Beispiel: https://directory.sync.blue/contacts/DEMOabcABC0123/snom/v1)
• Als XML-Datei für Gigaset IP-Telefone/DECT-Basen (Beispiel: http://directory.sync.blue/contacts/DEMOabcABC0123/gigaset/v1)
• Als CardDAV URL (in Entwicklung)

Sicherheit und Datenschutz

• Bereitstellung der Kontakte nur per HTTPS (SSL-verschlüsselt)
• Kontakte nur, wenn persönlicher API-Key bekannt

Mehr dazu auch hier. 

🎥 In diesem YouTube-Video zeigen wir dir, wie du das sync.blue® ADRESSBUCH einrichtest.