Wie kann ich den SMS Versand über Lox24.eu in CSB einrichten?

In dieser Anleitung erklären wir Ihnen, wie Sie den SMS Versand über Lox24.eu im CSB einrichten können.

Kundenkonto Erstellen
Bevor es im CSB los gehen kann müssen Sie sich zunächst einen Kundenaccount bei Lox24.eu erstellen.
Dort erhalten Sie auch weitere Informationen über die Tarife und Zählungsmöglichkeit. Nach erfolgreicher Registrierung erhalten Sie eine eMail mit den Zugangsdaten (Account-ID / Kundennummer und Passwort). Beachten Sie, dass die Anlage des Accounts bis zu 24h dauern kann.

Ihre LOX24 - Tarife in CSB hinterlegen
Nachdem Ihr Lox24.eu Account erstellt worden ist loggen Sie sich im Kundenbereich ein.

Auf der Übersichtsseite sehen Sie zunächst Ihre Kunden-Nr. sowie Ihre API/Service-IDs für die verschiedenen Tarife. Beides wird für die Anbindung an CSB benötigt. Um CSB Ihre individuellen Tarif IDs bekannt zu machen müssen diese einmal in eine "SMSLOX24Tarif.ini" eingepflegt werden.

Die SMSLOX24Tarif.ini finden Sie im Anhang dieses Help-Center Beitrags zum Downloaden. Laden Sie die SMSLOX24Tarif.ini herunter und bearbeiten Sie diese mit dem Windows Editor. Hierfür Rechtsklick auf die Datei und im Kontextmenü "Bearbeiten" auswählen.

Die Ini-Datei ist wie folgt aufgebaut:

Ändern Sie hier die API/Service IDs für Economy, Pro und Direkt vorne und hinten mit denen in Ihrem Lox24.eu Account angegebenen Nummern. Speichern Sie danach die Änderungen über Datei -> Speichern.

Die fertige SMSLOX24Tarif.ini mit Ihren API Nummern muss nun nor noch in Ihr CSB PRG-Verzeichnis verschoben werden. Sie finden den Pfad zu Ihrem CSB PRG-Verzeichnis leicht indem Sie einfach im oberen Bereich Ihrer CSB Version prüfen, wo dieses liegt.

In meinem Beispiel liegt das CSB-PRG-Verzeichnis auf

C:\CSB\Demo\prg\

Navigieren Sie mit dem Windows Datei-Explorer in dieses Verzeichnis und fügen Sie dort Ihre SMSLOX24Tarif.ini ein.

Einen Lox24-API Key erstellen
Bevor wir Ihren Lox24-Account mit CSB verbinden können benötigen wir noch einen API-Schlüssel. Diesen können Sie direkt auf der Lox24.eu Seite in Ihrem Kundenkonte erstellen.

Klicken Sie hierfür im linken Seitenmenü auf den Eintrag "Einstellungen" wählen danach "API Einstellungen" und drücken dann den Button "Neuen API Key erstellen".

Im folgenden Dialog wählen Sie die API v1 Version aus und geben der Schnittstelle noch einen beliebigen Namen bspw. CSB.

Achtung!: Wenn Sie den SMS Versand auch für den neuen S2 Werkstattkalender nutzen wollen, dann müssen Sie einen weiteren API-Key der Version 2 anlegen. Die S2-Schnittstelle nutzt für die Kommunikation schon die neuere API Version.

Speichern Sie die API mit dem Button "Speichern". Die API wird dann angelegt und mit folgendem Button können Sie den API Key kopieren / in die Windows Zwischenablage legen.

Dieser wird gleich noch benötigt und fungiert quasi als Passwort im CSB.

Ihren Lox24-Account mit CSB verbinden
Nachdem wir die Tarife nun im PRG-Verzeichnis hinterlegt haben können wir nun Ihren Lox24-Account im CSB hinterlegen und den SMS Versand aktivieren. Öffnen Sie hierfür den Programmpunkt 9-4-1 - Programmparameter und dort die Reiterkarte [[Tab: 2 Händlernr./Zugangsdaten]].

Im unteren linken Bereich finden Sie die SMS Account Einstellungen.

Wählen Sie hier zunächst als Provider LOX24 aus.

In den folgenden Feldern geben Sie diese Daten hier an:
Absender Kennung: Hier kann der Firmenname angegeben werden (max. 11 Zeichen!), dem Empfänger wird dann dieser anstelle der Telefonnummer als Absender angezeigt.

SMS KundenNr.: Ist für LOX24 nicht relevant und bleibt leer.

SMS User: LOX24 Kundennummer

Passw.: Hier kommt der LOX24-API Key hinein den wir gerade erstellt haben. (Api Key der über die Webseite erstellt wurde, 32-stellig)

Bei SMS Tarif können Sie einen der drei Tarife wählen, die wir zuvor über die INI-Datei dem CSB bekannt gemacht haben. Hier finden Sie ihre Tarif-Api Nummern wieder.

Wenn alles fertig ausgefüllt ist speichern Sie die Daten mit [[Image: CSB-BildUnten-Button]].

Hinweis: Die SMS Einstellungen sind Stationsbezogen und müssen somit bei JEDER Station die SMS versendet erneut eingetragen werden!

Verbindung testen
Um zu testen, ob alles richtig konfiguriert ist senden Sie sich am Besten selbst eine SMS. Wählen Sie hierfür im Kundenstamm sich selbst oder einen Mitarbeiter mit hinterlegter Handynummer und nutzen den Button [[Button: SMS]].

Wenn im folgenden Fenster das Guthaben von Lox24 angezeigt wird können Sie davon ausgehen, dass die Schnittstelle korrekt eingerichtet ist.

Mit [[Image: CSB-BildUnten-Button]] können wir die SMS versenden.

Damit ist die Einrichtung abgeschlossen und Sie können mit dem SMS Versand los legen.