Clearbit

Mit unserer Clearbit-Integration können Sie die von Zammad bereitgestellten Informationen ganz einfach erweitern. Wenn die E-Mail-Adresse des Kunden oder Agenten Clearbit bekannt ist, wird es alle Informationen, die es über den Benutzer hat, mit Zammad teilen. Die Informationen können Folgendes umfassen:

  • Avatar

  • Informationen zur Adresse

  • Informationen zur Website

  • Eine Zusammenfassung der Biografie (standardmäßig als Notiz)

Bei Bedarf können Sie weitere benutzerdefinierte Objekte hinzufügen und ihnen Mappings zuweisen. Generell können Sie alle Informationen von Clearbit anzeigen lassen, solange Sie eine Zuordnung zu einem Zammad-Objekt-Attribut eingerichtet haben.

Hinweis

Clearbit hat ein Mapping von Feldern wie LDAP und Exchange, aber es überschreibt keine Zammad-Informationen. Das bedeutet, dass wenn Sie z.B. das Feld für den Nachnamen in Zammad bereits ausgefüllt haben, es von Clearbit nicht überschrieben wird, auch wenn dort andere Informationen vorliegen.

Aber: Wenn der Nachname von Clearbit festgelegt wurde und Zammad feststellt, dass sich der Nachname in der Clearbit-Quelle geändert hat, wird Zammad auch diesen Wert aktualisieren.

Konfiguration

Die Konfiguration von Clearbit ist wirklich einfach und schnell erledigt! Loggen Sie sich einfach in Ihren Clearbit-Account ein, gehen Sie auf „API“ und kopieren Sie den geheimen API-Schlüssel.

../../_images/api-key.jpg

Wechseln Sie nun zu Ihrer Zammad-Instanz und gehen Sie im Admin-Bereich zu Integrationen (System) > Clearbit. Fügen Sie Ihren API-Schlüssel in das API-SchlüsselFeld ein und entscheiden Sie, ob Zammad automatisch unbekannte Organisationen erstellen soll, wenn der Benutzer noch keine hat (und Clearbit diese kennt). Die Option „Geteilt“ legt fest, ob die neuen Organisationen, die Zammad aus Clearbit erstellt, „geteilt“ sein sollen.

Bemerkung

Wenn Sie unsicher sind, welche Option Sie wählen sollen, bleiben Sie besser bei „nein“. Sie können mehr dazu unter Organisationen erfahren.

../../_images/configure-zammad.png

Die Mapping-Option funktioniert ähnlich wie das Mapping innerhalb des Exchange und LDAP Sync. Sie können weitere Mappings für z.B. benutzerdefinierte Felder hinzufügen, wenn Sie weitere Informationen benötigen, die Clearbit bereitstellen kann.

Bemerkung

Wenn Sie weitere Clearbit-Felder hinzufügen möchten und mehr über die verfügbaren Felder in der API erfahren möchten, können Sie einen Blick auf deren API-Dokumentation werfen.

Wenn Sie mit den oben gewählten Einstellungen und Ihrem Mapping zufrieden sind, speichern Sie die Änderungen und aktivieren Sie die Clearbit-Integration. Zammad wird nun die Clearbit-API abfragen, wenn Nutzer Sie kontaktieren.

Bemerkung

Zammad synchronisiert sich nicht regelmäßig mit Clearbit, sondern nur bei Bedarf. Das spart API-Aufrufe.

../../_images/zammad-mapping.png

Unterhalb der Einstellungen und Zuordnungen finden Sie unser Integrationsprotokoll. Sie können sehen, welche Anfragen Zammad an Clearbit gesendet hat und auch die API-Antwort.

../../_images/zammad-log.jpg

Übrigens können Sie das API-Protokoll auch auf der Clearbit-Website einsehen - die Informationen sind im Grunde die gleichen.

../../_images/api-log.jpg

Beispiel für das Hinzufügen eines Benutzers

Um Ihnen zu zeigen, wie schnell Informationen hinzugefügt werden, haben wir unten einen kleinen Screencast eingefügt. Dieser zeigt die Erstellung des Benutzers Alex aus Clearbit. Da wir den Nachnamen von Alex bereits auf „X“ gesetzt haben, hat Zammad ihn nicht aktualisiert. Zammad hat weitere Informationen hinzuzufügt, die es von Clearbit erhalten hatte.

../../_images/automatic-user-additions.gif