Handbuch SMS Reseller System


Wenn Sie selber SMS an Ihre Kunden als Wiederverkäufer/Reseller unter dem eigenen Namen (white label) verkaufen wollen, können Sie unser Reseller System verwenden.
Dazu legen Sie für jeden Ihrer Kunden ein Unterkonto an, indem Sie einen Mitbenutzer mit USER-Berechtigung einrichten. Diesem Mitbenutzer können dann SMS-Kontingente zugewiesen werden. Sie können innerhalb Ihrer Firma beliebig viele Mitbenutzer anlegen.

  1. Freischaltung als Reseller
  2. Anlegen eines Benutzers
  3. Rechte eines Benutzers
  4. Benutzer-Kontingente aufladen
  5. Einbinden in Ihre Software

1.) Freischaltung als Reseller

Bevor Sie unser Resellersystem nutzen wollen, müssen Sie zuerst einen Testzugang anlegen (falls noch nicht geschehen) und dann das SMS-Konto aufladen oder das Lastschriftverfahren nutzen, siehe >> Konto aufladen.

Bitte wählen Sie dann einen Tarif aus, den Sie als Reseller Ihren Kunden anbieten wollen. Dieser Tarif wird dann beim Reseller-Account fest hinterlegt >> Tarife.
Beantragen Sie eine Reseller-Freischaltung für dieses Konto. Dazu nehmen Sie bitte am besten telefonisch Kontakt mit uns auf.
Das Reseller-System ist lediglich eine Erweiterung der Mitbenutzerverwaltung, Sie können darauf ganz einfach über unsere Verwaltung (siehe unten) zugreifen.

2.) Anlegen eines Benutzers

Für jeden Ihrer Kunden legen Sie einen neuen Benutzer an:
Loggen Sie sich mit einem Benutzer mit ADMIN-Rechten ein und wählen Sie im Menü "Einrichten -> Berechtigungen" und dann auf "Mitbenutzer"

Legen Sie einen neuen Benutzer mit USER-Berechtigung an: bitte NICHT mit POWER-Berechtigung!
Eine Anleitung finden Sie im Handbuch SMS Verwaltung der Benutzer.
Legen Sie den Benutzername und Passwort für den Endkunden fest, die Kundennummer bleibt immer gleich. Machen Sie in den Optionen Ihrer Software diese Zugangsdaten konfigurierbar. So können für jeden Benutzer die Zugangsdaten in der Software beim Versand an unsere Schnittstelle übergeben werden. Entweder teilen Sie die Zugangsdaten Ihrem Kunden mit und er richtet es selber in der Software ein oder Sie richten es für den Kunden ein.

3.) Rechte eines Benutzers

Es gibt 3 Benutzerklassen mit unterschiedlichen Berechtigungen.
Sie benötigen mindestens einen ADMIN-Benutzer, um die Benutzer zu verwalten. User mit ADMIN-Berechtigung haben immer ein unveränderliches Kontingent=-1, allen anderen User-Kontingente können verändert bzw. aufgeladen werden.
Die ADMIN Benutzer können Sie u.a. auch dazu verwenden, um SMS für Ihre eigene Firma zu versenden ohne erst Kontingente zuweisen zu müssen.

4.) Benutzer-Kontingente aufladen

Bevor Sie aufladen, stellen Sie bitte sicher, dass Ihr Resellerkonto mit ausreichend SMS gedeckt ist. Wenn Sie einem Benutzer (=Endkunde) mehr SMS zuweisen als Ihr Prepaid Guthaben oder Ihr monatliches Limit abdeckt, kann das dazu führen, dass Ihre Kunden keine SMS mehr versenden können.
Das aktuelle Kontingent je Benutzer wird in der Spalte "Kontingent" angezeigt. Zum Aufladen wählen Sie einen oder mehrere Benutzer aus, tragen die Anzahl der aufzuladenden SMS ein und klicken dann auf "Weiter":

Ergebnisseite:

Zur Korrektur von Aufladungen sind auch negative Anzahlen SMS erlaubt (Kontingent darf aber insgesamt nicht in minus gehen). Die Aufladungen je Benutzer werden geloggt.
Die Rechnungsstellung an die Endkunden erfolgt durch den Reseller (z.B. Paket über Anzahl x SMS), also durch Sie selbst. Sie hingegen erhalten für die Nutzung des Zugangs bei SMS4.de die Rechnungen direkt von der alphaQuest GmbH.

5.) Einbinden in Ihre Software

Binden Sie den SMS-Versand in Ihre Software oder Webseitenapplikation mit der HTTP-Schnittstelle ein.

Technische Hinweise:
  • Der Parameter kdnr ist Ihre Kundennummer und bleibt immer gleich.
  • Der Parameter tarif kann nicht gesetzt werden, da der tarif fest eingestellt ist.
  • Sendeberichte und Antworten werden standardmäßig an die E-Mail-Adresse des Benutzers gesendet. Sollen unterschiedliche E-Mail-Adressen je Endkunde verwendet werden, kann dazu der replyto-Parameter für jede SMS gesetzt werden.
  • Verwenden Sie die Guthabenabfrage via HTTP-Schnittstelle, wenn Sie Ihren Kunden ermöglichen möchten das aktuelle Kontingent abzufragen: Parameter level=user, check=sms.
  • Wenn das Kontingent des Endkunden aufgebraucht ist, liefert die Versand-Schnittstelle den Statuscode 43 =Kontingent aufgebraucht.
Rechtliche Hinweise:
  • Für den Resellerzugang gelten unsere AGBs.
  • Wir empfehlen, dass Sie Ihrerseits mit Ihren Kunden Bedingungen für die Nutzung des SMS-Versand vereinbaren.