Clearbit¶
Mit unserer Clearbit-Integration können Sie die von Zammad bereitgestellten Informationen ganz einfach anreichern. Wenn die E-Mail-Adresse des Kunden oder Agenten Clearbit bekannt ist, wird es alle Informationen über den Benutzer mit Zammad teilen.
Einführung¶
Die Informationen von Clearbit können umfassen:
Avatar
Informationen zur Adresse
Informationen zur Website
Eine 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-Atribut 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 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.
Wechseln Sie nun zu Ihrer Zammad-Instanz und gehen Sie im Admin-Bereich zu System > Integrationen > Clearbit. Fügen Sie Ihren API-Key in das API Key Feld ein und entscheiden Sie, ob Zammad automatisch unbekannte Organisationen erstellen soll, wenn der Benutzer noch keine hat (und Clearbit diese kennt). Die Option Geteilt entscheidet, ob die neuen Organisationen geteilte Organisationen 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.
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.
Unterhalb des Einstellungs- und Mappingbereichs finden Sie die Protokolle der Integration. Sie können sehen, welche Anfragen Zammad an Clearbit gesendet hat und auch die Antwort der API.
Übrigens können Sie das API-Protokoll auch auf der Clearbit-Website einsehen - die Informationen sind im Grunde die gleichen.