Frage: Wie konfiguriere ich meine Serverinstallation von Act! Premium (Zugriff via Web), um die Act! API und zugehörige Funktionen wie Act! Marketing Automation, Act! Insights und Verkaufschancen KPIs zu ermöglichen.
Produktdetails:
- Produktfamilie: Act!
- Produkt: Act! Premium (Zugriff via Web)
Antwort:
Welche Funktionen werden durch die Act! API unterstützt?
Die Act! API verbindet Ihre Datenbank mit einer Vielzahl von Act! Funktionen, Anwendungen von Drittanbietern und Integrationen. Erfahren Sie im folgenden Artikel mehr darüber, welche Funktionen die Act! API Einrichtung erfordern:
Welche Funktionen sind mit der Act! API verfügbar?
Act! API-Voraussetzungen
Die Act! API ist ein reiner Abonnentenvorteil, weshalb Sie zur Verwendung ein aktives Act! Abonnement benötigen. Achten Sie darauf, dass Ihre Act! Installation korrekt mit Ihrem Abonnement-Aktivierungsschlüssel registriert ist. Falls Sie bei der Registrierung Ihrer Software Hilfe benötigen, lesen Sie den folgenden Artikel:
Wie registriere oder aktiviere ich Act ab der Version 21.1
Achten Sie darauf, dass Act! auf einem kompatiblen Computer installiert ist und die in unserer Kompatibilitätsmatrix beschriebenen Anforderungen erfüllt:
Act! Kompatibilitätsmatrix
Es wird dringend empfohlen, sicherzustellen, dass Ihre Version von Act! mit den neuesten Patches aktualisiert ist. Sie können Updates für Act! vom Download Center herunterladen.
Um die Act! Web API nutzen zu können, muss Ihre Datenbank für den Internetzugriff konfiguriert werden.
Wie konfiguriere ich die Act! Premium (Zugriff via Web) Datenbank für den Zugriff über den Webbrowser
Außerdem muss sichergestellt werden, dass Ihr Netzwerk so konfiguriert ist, dass es den Datenverkehr korrekt an Ihren Webserver weiterleitet, sodass alle notwendigen Portweiterleitungs- und Firewall-Ausnahmen vorgenommen wurden, um einen fehlerfreien Zugriff auf Ihre Datenbank-Site zu gewährleisten. Weitere Informationen zur erfolgreichen Einrichtung Ihrer Netzwerkumgebung finden Sie im folgenden Artikel:
Understanding Port Forwarding with Act!
Einige Funktionen der API (einschließlich Act! Marketing Automation) erfordern das Ihre Act! Web-API-Anwendung über HTTPS zugänglich ist und in der Regel erfordern, dass Ihr Server ein gültiges SSL-Zertifikat besitzt.
Bitte beachten Sie - Der Kauf und die Einrichtung eines privaten SSL-Zertifikats wird von Swiftpage und dessen technischen Support nicht unterstützt. Eine alternative Methode zur Generierung einer sicheren URL, die keine SSL-Zertifizierung erfordert, finden Sie im folgenden Abschnitt "Einrichten von Act! Web API ohne SSL-Zertifikat mit dem Act! Connect Link"
Einrichtung der Act! API
Wenn Act! auf Ihrem Computer installiert wird, wird parallel dazu eine Basisversion der API installiert. Diese Basis-API stellt keine Verbindung zum Internet her, unterstützt aber die grundlegende Funktionen von Act! welche die API nutzen, um "sofort einsatzbereit" arbeiten zu können. Act! Insight und die Act! Verkaufschancen-KPIs sind Beispiele für lokale API-Funktionen die keinen Internetzugang erfordern, und sollten daher ohne zusätzliche Einrichtung oder Konfiguration der Act! API funktionieren.
Es ist jedoch weiterhin erforderlich sicherzustellen, dass Ihre Datenbank für den Webzugriff gemäß folgendem Artikel konfiguriert ist:
Wie konfiguriere ich die Act! Premium (Zugriff via Web) Datenbank für den Zugriff über den Webbrowser
Um die volle, funktionsfähige API, von der aus Internet verbundene Funktionen auf Ihre Datenbank zugreifen können einzurichten, müssen Sie sicherstellen, dass die Act! Web-API-Anwendung auf Ihrem Webserver konfiguriert ist.
> Einrichten der Act! Web-API auf einem SSL-zertifizierten Webserver
Nachdem die Datenbank für den Webzugriff gemäß dem obigen Artikel konfiguriert wurde, sollte die Act.Web.API-Anwendung automatisch als Teil Ihrer IIS-Server-Umgebung installiert sein.
Ihre API-Endpunkt-URL ist abhängig von der URL die Sie für den Zugriff auf Ihren Server verwenden - bei der Standardinstallation sieht die URL wie folgt aus:
- https://[Ihre Serveradresse]:[Port]/act.web.api
Zum Beispiel, wenn Sie Ihren Act! Premium (Zugriff via Web) Server unter der Domain "myactserver.de" eingerichtet haben und Sie Ihre Act! Premium-Site mit Port 8080 konfiguriert haben, dann lautet der API-Endpunkt:
- "https://MeinActServer.de:8080/act.web.api"
Hinweis: Wenn Sie die Standard-Ports wie HTTP-Port 80 oder Port 443 verwenden, dann brauchen Sie die Portnummer nicht in Ihre URL einzufügen, obwohl dies trotzdem funktionieren würde.
Zur Sicherstellung können Sie Ihre API testen, ob diese korrekt konfiguriert wurde, indem Sie zur Ihrer API-Endpunkt-URL navigieren und anschließend "/api/system" in Ihren Browser eingeben:
- https://MeinActServer.de:8080/act.web.api/api/system
Wenn Ihre API korrekt konfiguriert wurde, sollten Sie wie folgt eine Text-Seite mit den ähnlichen Angaben sehen:
{
"apiVersion": "1.0.317.0",
"sdkVersion": "21.0.295.0"
}
> Die Act! Web API ohne SSL-Zertifikat mit Act! ConnectLink einrichten
Einige Funktionen welche die Act! Web-API benötigen, erfordern eine sichere Verbindung zur API über HTTPS. Eine dieser Funktionen ist Act! Marketing Automation welche bei der Erstellung von Kampagnen eine sichere Verbindung benötigt, um Gruppendaten aus Ihrer Datenbank zu beziehen.
Sie können die Act! Web-API für viele Funktionen auf einem ungesicherten Server anwenden, indem Sie einfach mit Ihrer URL über http://[Ihre Serveradresse]:[Port]/act.web.api auf Ihre API-Site zugreifen. Für die volle Funktionalität und die erhöhte Sicherheit durch HTTPS empfehlen wir jedoch dringend, entweder die SSL-Zertifizierung auf Ihrem Webserver einzurichten, oder Act! Connect Link zu verwenden, um eine sichere URL wie unten beschrieben zu generieren:
Das Anwenden des Act! Connect Link's mit Act! Premium (Zugriff via Web)
Act! Connect Link erstellt mit der generierten Cloud Elements URL einen sicheren Tunnel direkt zu Port 80 auf Ihrer Maschine. Nach der Installation leitet der Connect Link alle an die generierte URL gerichteten Anfragen an http://localhost:80 auf Ihrem Computer weiter.
Da die Cloud Elements URL über HTTPS gesichert ist, brauchen Sie Ihren Webserver nicht mit einem SSL-Zertifikat zu konfigurieren, um die Vorteile einer sicheren HTTPS-Kommunikation über die API zu nutzen.
Bitte beachten Sie: Der Act! Connect Link leitet nur den Datenverkehr zum Port 80. Wenn Ihre Act! Premium (Zugriff via Web) oder API-Anwendung mit einem anderen Port als Port 80 konfiguriert ist - dann funktioniert der Connect Link für diesen Zweck nicht.
Wie installiere ich den Act! Connect Link auf dem Server
Wie installiere ich Act! Connect Link?
Testen Sie ob der Act! Connect Link aktiv und korrekt installiert ist, indem Sie prüfen ob die Cloud Elements URL unter Act! Connect (in der Navigation links) in Ihrer Act! Serverinstallation vorhanden ist.