GREYHOUND Docs Hilfstools & Addons GREYHOUND Connect Addons

Mirakl Connect

Dieser Artikel ist noch in Bearbeitung.

Das Mirakl-Addon kann jederzeit einem bestehenden GREYHOUND-Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon dann vollautomatisch.

Für die Verwendung des Mirakl Connect-Addons ist eine GREYHOUND-Version 5.1.150 build 3272 oder höher notwendig.

Notwendige Vorbereitung

Im Benutzerbackend von Mirakl ist zunächst oben rechts auf die persönlichen Einstellungen zu klicken:

Hier lässt sich der API-Schlüssel einsehen – den müssen wir später in GREYHOUND hinterlegen, um Mirakl anzubinden:

Wer mehrere Mandanten / Shops nutzt, braucht zudem alle Shop IDs von den Shops, die an GREYHOUND angebunden werden sollen. Dazu ist links im Menü auf “Shop” zu klicken – oben rechts an der markierten Stelle sieht man dann die jeweilige Shop ID:

Addon zum Vertrag hinzubuchen

Das Produkt Mirakl Connect kann im GREYHOUND Control Center (GCC) jederzeit dem bestehenden Vertrag hinzugebucht werden.

Nach dem Login unter Verträge den Vertrag auswählen und bearbeiten.
Unter den Vertragsinhalten auf Produkte ändern klicken.
Das gewünschte Addon “Mirakl Connect” anhaken.
Die Änderungen sind zum Schluss noch mit Weiter zu bestätigen und nach einer Prüfung zu übernehmen.

Hinweis für Eigenbetriebler

Kunden im Individualbetrieb müssen die Verwendung des gebuchten Addons zusätzlich im GREYHOUND Admin aktivieren. Außerdem sind die Funktionen des neuen Addons erst nach einem Neustart des GREYHOUND Clients verfügbar.
Kunden im überwachten Eigenbetrieb müssen sicherstellen, dass Port 9443 in der Firewall wie hier beschrieben eingehend und ausgehend freigegeben ist.

Mirakl Connect einrichten

Im Folgenden ist beschrieben, wie die Anbindung an Mirakl in GREYHOUND eingerichtet wird.

Verbindung zu Mirakl herstellen

Um Mirakl und GREYHOUND zu verknüpfen, bitte zunächst zu Erweiterungen > Addon Manager navigieren.

Im Addon Manager kann man über das Plus-Icon unten links eine neue Verbindung hinzufügen und entsprechend “Mirakl” auswählen.
In der neuen Verbindung müssen die API URL der Mirakl-Instanz, z. B. https://company-name.mirakl.net, sowie der dazugehörige API-Schlüssel der Instanz hinterlegt werden.
Im Feld Vorgangspräfix kann man definieren, welches Präfix importierte Nachrichten in der Vorgangsnummer in GREYHOUND erhalten sollen. Das Feld kann leergelassen werden – mit diesem Feld kann der Standard Präfix bei Bedarf geändert werden.
Nutzt man mehrere Shops im Marktplatz, ist im Feld Shop ID die ID des Shops angegeben werden, den man an GREYHOUND anbinden will. WICHTIG: Bei mehreren Mandaten muss für jeden Shop eine eigene Verbindung wie hier beschrieben anzulegen, jeweils mit der passenden Shop ID.
Über den Button “Verbindung testen” kann und sollte getestet werden, ob GREYHOUND mit den eingegebenen Daten eine Verbindung zu Mirakl herstellen kann.
Wenn alles passt, den Haken bei “Aktiv” setzen und speichern.

Nach dem Speichern erscheint ein weiterer Bereich unten: Die Sprache. Hier kann optional ausgewählt werden, welche Sprache bei Mirakl hinterlegt ist. Dies dient zur Übersetzung der Mirakl-seitigen Themen und Betreffs.

In Mirakl gibt es potenziell mehrere Marktplätze. In GREYHOUND verwenden wir aber die marktplatzspezifische API. Deshalb muss für jeden Marktplatz eine eigene Verbindung im Addon Manager hinterlegt werden.

Maileingang konfigurieren

Um Tickets aus Mirakl in GREYHOUND zu importieren, braucht es ein POP3-Konto für den Mailabruf. Detaillierte und allgemeine Informationen über das Anlegen von Konten zum Mailempfang sind an dieser Stelle im Handbuch zu finden.

Speziell für Mirakl ist zum Thema POP3-Konto wichtig zu wissen:

Als Host ist localhost einzugeben.
Der Benutzer ist benutzername|tenant, wobei der Tenant standardmäßig “greyhound” ist. Welcher GREYHOUND-Benutzer hier verwendet wird, ist egal – es kann, muss aber nicht, der admin-User sein. Wichtig ist nur, dass der Benutzer im Status “aktiv” ist, also nicht deaktiviert wurde.
Das Passwort ist das GREYHOUND-Passwort des jeweiligen Benutzers, also z.B. das GREYHOUND-Kennwort des admin-Benutzers.

Mailausgang konfigurieren

Um Antworten aus GREYHOUND heraus an Mirakl zu senden, braucht es ein SMTP-Konto für den Mailversand. Detaillierte und allgemeine Informationen über das Anlegen von Konten zum Mailversand sind an dieser Stelle im Handbuch zu finden.

Optionale Konfiguration

Im Addon Manager gibt es neben dem Anlegen der Verbindungsdaten noch einige weitere, optionale Einstellungen. Beispielsweise lässt sich definieren, welche Daten die Vorschauzeile anzeigen soll sowie ob und welche Auftragsdaten aus einem Addon in benutzerdefinierte Felder in GREYHOUND geschrieben werden sollen.

Die optionalen Einstellungen sind für alle Addons identisch, weshalb sie zentral an folgender Stelle im Handbuch beschrieben sind:

Optionale Addon-Einstellungen

FAQ

Gelten via GREYHOUND gesendete Nachrichten in Mirakl als beantwortet?

Ja. E-Mail-Antworten, die via GREYHOUND generiert werden, landen in Mirakl und das ursprüngliche Ticket, auf das geantwortet wird, gilt dort dann als bearbeitet/beantwortet.

Der automatisch generierte E-Mail-Verlauf in der Nachricht wird durch das Addon entfernt und nicht in der Nachricht mit gesendet.

Kann ich Anhänge via GREYHOUND senden?

Ja, es können Dateien angehängt werden.

Warum steht bei allen Nachrichten aus Mirakl bei GREYHOUND ein Hinweis im Betreff?

Allen Nachrichten, die aus Mirakl stammen, wird in GREYHOUND automatisch im Betreff die Auftrags ID mit “Mirakl: ” angehängt. Das ist nötig, damit das Addon automatisch den zugehörigen Auftrag finden und anzeigen kann.