DOKUMENTATION
EinleitungEINLEITUNG
Hier können Sie sich über die Funktionen des mailBEAMER-Messaging-Systems informieren:
mailBEAMER ist erreichbar unter www.mailbeamer.com. Die Funktionsweise ist recht einfach. Der Nutzer sendet eine eMail an eine bestimmte Adresse. Die eMail wird vom mailBEAMER-Server empfangen und ein vorher definierter Inhalt der eMail (z.B. der Nachrichtentext oder die Betreffzeile oder eine Kombination aus beiden) wird per SMS, Fax oder Sprachnachricht an den Empfänger weitergeleitet.
mailBEAMER kann entweder den Inhalt der empfangenen eMail an eine Zieladresse senden oder auch an eine beliebige Empfängergruppe.
Die eMail kann aus jeder eMail-Anwendung (z.B. directBOX oder MS-Outlook) beispielsweise in folgenden Formaten gesendet werden:
| sms.01709876543@mailbeamer.com | Der Inhalt der eMail wird per SMS an die Rufnummer 00491709876543 gesendet. |
| fax.00491709876543@mailbeamer. com | Ein Fax wird an die Rufnummer 00491709876543 gesendet. |
| logo.+491709876543@mailbeamer. com | Ein Handylogo wird an die Rufnummer 00491709876543 gesendet. (Das + wird nicht von allen Mailservern akzeptiert - 0049 ist die sichere Variante!) |
| meineliste@mailbeamer. com | Eine in der mailBEAMER-Datenbank definierte Rufnummerngruppe namens "meineliste" wird genutzt. Das System sendet in diesem Fall den Inhalt der eMail an alle Gruppenmitglieder. Dabei kann pro Listenmitglied bestimmt werden, ob die Info per SMS, Fax oder Sprachanruf (Text-2-Speech) gesendet werden soll. |
Im mailBEAMER-Administrationsbereich kann das System konfiguriert werden. Hier erhält der Benutzer darüber hinaus einen Überblick über die gesendeten Nachrichten, so wie die angefallenen Kosten.
Das System kann entweder PrePaid oder auf Rechnung betrieben werden.
1. LOGIN
Auf unserer Website www.mailbeamer.com:
- Kunden-Login
- Eingabe von Benutzernamen und Passwort.
Die Login-Daten werden Ihnen nach Abschluss des Vertrages von uns mitgeteilt. Das Passwort sollte zur Sicherheit möglichst direkt bei der ersten Benutzung und auch zukünftig häufiger geändert werden. In der Maske "Kundendaten bearbeiten" können unter den Details durch Anklicken des Feldes "Passwort ändern" Benutzername und Passwort geändert werden.
2. ADMINISTRATION
Im Administrationszugang sieht der Benutzer folgende Daten:
-
Adressdaten (können gegebenenfalls geändert werden)
Die erlaubten Nachrichtenmedien entsprechend dem abgeschlossenem Vertrag (SMS, Handylogos, Faxe, Voicemails)
Den Kontostand des mailBEAMER-Kontos (Verbrauch in Euro, sowie Dispositionslimit)
Hier besteht außerdem die Möglichkeit, durch Setzen eines Häkchens in "Passwort ändern", die Zugangsdaten zu ändern.
Aktionen:
2.1 Absender
2.2 HTTP
2.3 Logbuch
2.1 ABSENDER
Mit Klick auf den Button "Absender" kann definiert werden, von welchen Adressen eMails angenommen werden dürfen. Um die Details eines Absendereintrages anzusehen, muss auf den jeweiligen Listeneintrag geklickt werden.
| Absendername | Es kann ein beliebiger Eintrag erfolgen. Dieses Feld dient der besseren Zuordnung und Übersicht. |
| Erlaubter Absender | Local Part der eMailadresse (alles vor dem @): Falls beliebige Absenderadressen einer bestimmten Domain erlaubt werden sollen, muss hier ein Sternchen (*) eingegeben werden. |
| Erlaubte Absenderdomain | Domainpart der eMailadresse (alles nach dem @). |
| Erlaubte IP Adresse | Hier kann bestimmt werden, dass nur eMails von einem bestimmten Host angenommen werden. |
| Erlaubte IP-Maske | Es kann definiert werden, ob sich die oben eingegebene IP-Adresse nur auf den einen Host bezieht (kein Eintrag oder 255.255.255.255) oder ein bestimmtes Subnetz umfasst (z.B. 255.255.255.230). |
| Schlüssel für Betreff | Ist hier ein Wert eingetragen, verarbeitet mailBEAMER nur die Mails, bei denen im Betreff als erstes Wort der Schlüssel enthalten ist. Wird hier beispielsweise "Hallo" eingegeben, muss im Betreff der eMail als erstes Wort ebenfalls "Hallo" stehen. Es wird nur das erste Wort im Betreff der eingehenden eMail berücksichtigt. Dieser Schlüssel wird dem Empfänger nicht angezeigt! |
| Schlüssel für Header | Diese Voreinstellung muss von Ihrem Systemadministrator eingerichtet werden. Hier wird definiert, dass nur eMails akzeptiert werden, die im SMTP-Header diesen Schlüssel ebenfalls enthalten. Der Header der eMail muss folgende Zeile enthalten: "X-CUSTOMER: " gefolgt von dem Schlüssel. |
2.1.1 FORMATE
Mithilfe des Buttons "Formate" kann definiert werden, welche Teile der eingegangenen eMail in der Zielnachricht ausgegeben werden sollen. Um die Details eines Formateintrages anzusehen, muss auf den jeweiligen Listeneintrag geklickt werden
| Formatname | Hier kann ein beliebiger Name für das Format eingetragen werden. | ||||||
| Versandart |
Hier kann ausgewählt werden, in welche Versandart die Nachrichten formatiert
werden sollen. Je nach abgeschlossenem Vertrag sind folgende Arten möglich:
|
||||||
| Davor | Hier kann ein Text eingetragen werden, der vor dem Nachrichteninhalt ausgegeben werden soll (siehe Beispiele). Dieser Eintrag sollte möglichst mit einem Trennzeichen oder einer Leerstelle enden, da der Nachrichteninhalt direkt angehängt wird. | ||||||
| Herkunft | Es kann ausgewählt werden, aus welchem Teil der Mitteilung Daten versendet
werden sollen:
|
||||||
| Danach | Hier kann ein Text oder - meist sinnvoll - ein Trennzeichen eingetragen werden, das nach dem Nachrichteninhalt ausgegeben werden soll. | ||||||
| Länge | Maximale Länge des auszugebenden Textes aus der Nachricht (ohne den Inhalt der Felder "Davor" und "Danach" ). | ||||||
| Von | Eine bestimmte Stelle der Nachricht wird herausgesucht, ab der der Inhalt ausgegeben werden soll - siehe 3. Beispiel. | ||||||
| Bis | Stelle, bis zu der dieser Text ausgegeben werden soll - siehe 3. Beispiel. | ||||||
| Mehr Inhalte | Mit diesem Button können weitere Formatzeilen eingefügt werden. | ||||||
| Weniger Inhalte | Durch Klicken auf diesen Button wird die letzte Formatzeile gelöscht. | ||||||
| Maximale Länge insgesamt | Gesamte Länge der Nachricht inkl. der Inhalte in den Feldern "Davor" und "Danach". |
1. Beispiel:
In obigem Beispiel wird der Inhalt des Nachrichtentextes als SMS formatiert. Nehmen wir an, die eingegangene eMail hat folgenden Inhalt:
Die SMS hat somit folgenden Inhalt:
2. Beispiel:
In diesem Beispiel wird ebenfalls der Inhalt des Nachrichtentextes als SMS formatiert. Die eingegangene eMail hat folgenden Inhalt:
Betreff:
Text:
Die SMS hat dann diesen Inhalt:
Die maximale Länge der Nachricht insgesamt wurde auf 160 Zeichen festgelegt. Der Betreff hat maximal 20 Zeichen, in diesem Beispiel sind es 16 Zeichen: "Betreff: Test! /". Vor dem Nachrichtentext wird "Nachricht: " (11 Zeichen) eingefügt, so dass für den Nachrichtentext noch 133 Zeichen zur Verfügung stehen.
Würde die Nachricht einen längeren Ausdruck im Feld Betreff haben, z.B.
Betreff:
Text:
dann hätte die SMS diesen Inhalt:
Der Nachrichteninhalt im Betreff hat maximal 20 Zeichen, ein möglicher Rest wird abgeschnitten.
3. Beispiel:
In diesem Beispiel werden Inhalte einer Faxmitteilung als SMS formatiert.
Der Eintrag "\r\n" im Feld "Bis" bedeutet, dass die Inhalte der Zeile bis zur
nächsten Zeilenschaltung abgefragt werden.
Hat das eingegangene Fax zum Beispiel folgenden Inhalt:
Fax-Protokoll:
Dann hat die SMS diesen Inhalt:
Durch Einträge in den Feldern "Von:" und "Bis:" werden bestimmte Angaben aus dem Header herausgefiltert. Die Zeilen werden nacheinander abgefragt, daher ist es wichtig, dass die Reihenfolge der Inhalte eingehalten wird. "CallerNo:" ist z.B. immer vor "CallerInfo:". Würde "CallerInfo" zuerst abgefragt, können Daten, die davor im Header stehen, nicht mehr gefunden werden und "CallerNo" bliebe ohne Inhalt.
2.1.2 GRUPPEN
Mithilfe des Buttons "Gruppen" können Empfängerlisten generiert werden. Um die Empfänger einer definierten Gruppe anzusehen, muss auf den jeweiligen Gruppennamen geklickt werden bzw. eine neue Gruppe erstellt werden.
2.1.2.1 Neue Gruppe einpflegen
Durch Klick auf den Button "Neue Gruppe" öffnet sich eine neue Maske. Es kann ein neuer, frei wählbarer Gruppenname eingetragen werden. Wird der Name durch den Button "Speichern" bestätigt, erscheint er in der Gruppenliste. Mit Klick auf den Gruppennamen werden die Empfänger dieser Liste bearbeitet (siehe 2.2.2.2)
2.1.2.2 Empfänger einer Gruppe pflegen
In der nun folgenden Ansicht erscheinen alle Gruppen- mitglieder. Am Ende der Liste kann jeweils ein neuer Eintrag erstellt werden.
| Format |
Hier kann die Versandart ausgewählt werden. Je nach abgeschlossenem Vertrag
sind folgende Arten möglich:
|
| Empfänger | Handynummer, an die die Nachricht gesendet werden soll. Für Internationale Vorwahlen sollte möglichst die Länderkennziffer mit 00 (z.B. 0049 = Deutschland) eingetragen werden, weil das + wird nicht von allen Mailservern akzeptiert wird. Der mailBEAMER-Server ist so eingerichtet, dass Handynummern ohne Ländervorwahl in deutschen Netzen gesucht werden. Vor allem für Nutzer außerhalb Deutschlands ist es empfehlenswert, die Ländervorwahl immer einzutragen. |
Eine Importmöglichkeit besteht derzeit noch nicht, ist aber in Planung.
2.1.3 Formular-Hosts
Dieser Button hat zurzeit noch keine Funktion.
2.1.4 Formular-Referrer
Dieser Button hat zurzeit noch keine Funktion.
2.2 HTTP
Hinter dem Button "HTTP" befindet sich die Schnittstelle zum Modul mailBEAMER HTTP/XML-API.
(Für Systemadministratoren! Die technische Dokumentation erhalten Sie beim mediaBEAM-Team)
2.3 LOGBUCH
Mittels des Buttons "Logbuch" kann eine Liste der gesendeten Nachrichten angezeigt werden:
| 01.03.2004 | 11:01:28 | SMS wurde an 00491709999999 versendet | 0,10€ |
| 01.03.2004 | 10:35:49 | FAX wurde an 0049309999999 versendet | 0,15€ |
Durch den "Export" Button kann die Liste später auch als CSV-Datei exportiert werden. (Diese Funktion steht derzeit noch nicht zur Verfügung.)
3 Kontakt
Bei Fragen und Anregungen freuen wir uns über Ihre Nachricht an: contact@mediabeam.com
mediaBEAM GmbH
Parallelstraße 38
D-48683 Ahaus
Phone +49 2561 695-0
Fax +49 2561 695-0199
eMail contact@mediabeam.com
Web http://www.mediabeam.com
Stand: 17. März 2004