Anbindung an E-Mail-Tools

Generell unterstützen alle Anbindungen den Abgleich von Verteilerlisten und die Verknüpfung und Auswertung von Aussendungen.

Das E-Mail-Tool wird in den Projekteinstellungen unter "Datei > Verwalten > Eigenschaften > Anbindungen > E-Mail-Marketing-/Newsletter-Tool" ausgewählt bzw. aktiviert. Über die entsprechende Schaltfläche müssen die Verbindungsdaten eingegeben werden.

Als Proxy-Authentifizierung wird "NTLM", "negotiate" und "Kerberos" unterstützt.

Folgende Anwendungen werden unterstützt. Sie finden dabei jeweils Beispiele für die Verbindungsdaten. Bitte beachten Sie, dass spitze Klammern vor dem Speichern der Verbindungsdaten entfernt werden. Diese dienen nur zur Veranschaulichung und Abgrenzung variabler Werte. Jeder Eintrag in den Verbindungsdaten muss sich in einer eigenen Zeile befinden und mit einem Semikolon abgeschlossen werden.

▪ Brevo

▪ Verbindungsdaten:

URL: https://api.brevo.com;

API key: <API-Schlüssel>;

▪ Den API-Schlüssel erzeugen Sie in Brevo über "Account > SMTP & API > API-Schlüssel" über die Schaltfläche "Einen neuen API-Schlüssel generieren".

▪ Schnittstellenanfragen werden vom Brevo-Server nicht in Echtzeit, sondern im Rahmen einer Auftragswarteschlange in festen Intervallen (z. Zt. 5-minütig) verarbeitet. Daher kann es u. U. sein, dass die combit CRM-Schnittstelle einige Minuten auf das Ergebnis des Brevo-Servers warten muss, bevor die nächste, davon aber abhängige, Aktion fortgesetzt werden kann.

▪ Für die Nutzung der Brevo-API muss die IP im Brevo-Account autorisiert werden. Die Autorisierung finden Sie in Brevo über "Account > Sicherheit > Zugelassene IPs".

▪ CleverReach

▪ Verbindungsdaten:

URL: https://rest.cleverreach.com;

Client ID: <Client ID>;

Client Secret: <Client Secret>;

▪ Die Werte für "Client ID" und "Client Secret" erzeugen Sie in CleverReach (cleverreach.com/de/login/) über "Mein Account > Schnittstellen > REST API" über die Schaltfläche "Oauth2-App anlegen”:

App Name: CleverReachOAuthApp

Redirect URL: https://localhost/CleverReachOAuth/

App Image: Hier können Sie optional ein Bild hinterlegen.

REST API Version: 3

Scopes: Empfänger, Reports, Formulare, E-Mails

Das Aktivieren der Scopes ist zwingend, ansonsten kann es zur Meldung "(401) Nicht autorisiert. Übertragung abgebrochen." führen,

▪ Inxmail

▪ Verbindungsdaten:

URL: <URL zur REST API>;

Username: <Benutzername>;

Password: <Passwort>;

DisplayPath: <Dateipfad zur Inxmail.exe>;

▪ Die URL hat die Form https://api.inxmail.com/{customer}/rest/v1. Die genaue URL und die Authentifizierungsinformationen erhalten Sie vom Inxmail Support.

▪ DisplayPath hat z. B. die Form "C:\Program Files\Inxmail\Client\Inxmail.exe;".

▪ Mailchimp

▪ Verbindungsdaten:

URL: <URL zur REST API>;

API key: <API key>;

▪ Den API key erzeugen Sie in Mailchimp über "Account > Extras > API keys" über die Schaltfläche "Create A Key". Weitere Informationen dazu finden Sie auch unter https://mailchimp.com/help/about-api-keys.

▪ Die URL hat die Form "https://<dc>.api.mailchimp.com/3.0". Der Wert für <dc> in der URL ergibt sich aus dem letzten Teil des API keys, also z. B. "us6".

Zusätzlich zur Eingabe der Verbindungsdaten müssen Sie die Attributszuordnung prüfen. Denn beim Abgleich zwischen combit CRM und E-Mail-Tool werden von uns standardmäßig die Felder E-Mail, Name, Vorname und Briefanrede synchronisiert. Damit diese Synchronisation funktioniert, müssen diese Felder auch im Mailtool vorhanden sein.

Sofern Sie im E-Mail-Tool die Feldliste anpassen möchten, finden Sie die Konfiguration im jeweiligen Tool an folgender Stelle:

▪ Brevo: Kontakte > Einstellungen > Kontaktattribute und CRM

Folgende Felder werden vorausgesetzt: VORNAME, NACHNAME, SALUTATION

▪ CleverReach: Empfänger > eine Empfängerliste auswählen > Einstellungen > Felder

Folgende Felder werden vorausgesetzt: firstname, name, Salutation

▪ Inxmail: Globale Einstellungen > Alle Empfänger > Spalten konfigurieren

Folgende Felder werden vorausgesetzt: FirstName, LastName, Salutation

▪ Mailchimp: Audience > Settings > Audience fields and [MERGE] tags

Folgende Felder werden vorausgesetzt: FNAME, LNAME, Salutation

Sofern Sie Feldnamen umbenennen möchten, müssen diese Änderungen an 2 Stellen vorgenommen werden. Im folgenden sehen Sie die Scriptstellen für Änderungen bei CleverReach:

▪ Im Script "MailToolManagement.vbs" müssen Sie den Feldnamen anpassen:

" Werte des Empfängers auslesen

Call GetRecipientValueByRecipientObject(oRecipient, "VORNAME”, oDictionary, "sRecipientValueFirstname”, bErrorFlag, bSilent, bEventLog)

Call GetRecipientValueByRecipientObject(oRecipient, "NACHNAME”, oDictionary, "sRecipientValueLastname”, bErrorFlag, bSilent, bEventLog)

Call GetRecipientValueByRecipientObject(oRecipient, "ANREDE”, oDictionary, "sRecipientValueSalutation”, bErrorFlag, bSilent, bEventLog)

▪ In der Konfigurationsdatei "EmailToolAttributesCleverReach.txt" müssen Sie ebenfalls den Feldnamen anpassen: