How-To-Do Talk2M als E-Mail & SMS-Server verwenden Inhaltsverzeichnis 1 Allgemein... 2 1.1 Information... 2 1.2 Hinweis... 2 1.3 Verbindung PC und Teleservice-Modul... 2 2 E-Mail-Versand mit TM-E/TM-H-Modulen... 3 2.1 E-Mail-Postausgangsserver (SMTP) einrichten... 3 2.2 E-Mail konfigurieren... 5 2.3 E-Mail-Versand über die BASIC-Programmierung... 6 3 SMS-Versand mit TM-E/TM-H-Modulen... 6 3.1 E-Mail-Postausgangsserver (SMTP) einrichten... 7 3.2 SMS konfigurieren... 9 3.3 SMS-Versand über die BASIC-Programmierung... 11 4 Revision History... 12 4.1 Änderungen... 12 Juli 12 Seite 1 von 12
1 Allgemein 1.1 Information In diesem How-To-Do wird beschrieben, wie der in Talk2M integrierte SMTP-Server zum Versenden von E-Mails und SMSen genutzt werden kann. Mit den VIPA Teleservice-Modulen der TM-E/TM-H-Serie haben Sie die Möglichkeit über den Talk2M-Server E-Mails zu versenden. Talk2M dient hierbei als SMTP-Server, um die von den VIPA Teleservice-Modulen gesendeten E-Mails über das Internet zu verteilen. Ebenso können Sie mit jedem beliebigen Teleservice-Modul (auch DSL/LAN Geräte) eine SMS versenden. Dazu dient ihnen Talk2M als Vermittlungsstation. 1.2 Hinweis Wir werden in diesem How-To-Do anhand verschiedener Beispiele die grundsätzliche Vorgehensweise beschreiben. Dieses How-To-Do ersetzt nicht das Handbuch. Es dient rein als Einstieg für die Talk2M als E-Mail & SMS-Server verwenden -Funktion. Dieses How-To-Do dient als Beispiel einer funktionierenden Anwendung. Eine Haftung ist für Sachund Rechtsmängel dieser Dokumentation, insbesondere für deren Richtigkeit, Fehlerfreiheit, Freiheit von Schutz- und Urheberrechten Dritter, Vollständigkeit und/oder Verwendbarkeit außer bei Vorsatz oder Arglist ausgeschlossen. 1.3 Verbindung PC und Teleservice-Modul Um das Teleservice-Modul in Betrieb zu nehmen, müssen Sie es zunächst mit Ihrem PC / Laptop verbinden. Dazu gibt es verschiedene Möglichkeiten. Grundsätzlich muss der PC mit einer der LAN Schnittstellen des Teleservice-Moduls verbunden werden. SWITCH ETHERNET ETHERNET Bei einem VIPA TM-H-Modul benötigen Sie entweder eine gekreuzte oder Standard-Ethernetleitung zwischen PC und Teleservice-Modul. Juli 12 Seite 2 von 12 Bei einem VIPA TM-E-Modul benötigen Sie entweder eine gekreuzte Ethernetleitung oder einen Switch zwischen PC und Teleservice-Modul.
2 E-Mail-Versand mit TM-E/TM-H-Modulen Um die Funktionen in Talk2M Free+ nutzen zu können, benötigen Sie die passende Firmware (mindestens Version 6.4s3) auf Ihren VIPA Teleservice-Modulen. Diese können Sie sich kostenfrei aus dem Internet oder über die Software ebuddy laden und auf Ihre VIPA Teleservice-Module aufspielen. Die E-Mail-Funktion ist mit allen TM-E/TM-H-Router nutzbar, unabhängig davon ob das Gerät bei Talk2M angemeldet ist oder nicht. In allen Fällen ist ein funktionierender Internet-Zugang des Teleservice-Moduls, sowie ein gültiger und aktiver Talk2M-Account zwingend notwendig. Die Nutzung des E-Mail-Servers für den E-Mail-Versand ist kostenfrei in Talk2M für alle TM-E/TM- H-Router enthalten. 2.1 E-Mail-Postausgangsserver (SMTP) einrichten Zunächst muss ein E-Mail-Postausgangsserver (SMTP) eingerichtet werden. Dieser empfängt von den VIPA Teleservice-Modulen die Anfrage für einen E-Mail-Versand und versendet dann eine E-Mail über das Internet an den entsprechenden Empfänger. Gehen Sie dazu zunächst in die Konfigurationsoberfläche Ihres TM-E/TM-H-Routers. Weiter über den Menüpunkt Konfiguration Systemeinstellung Allgemein. Danach öffnen Sie im Baumdiagramm (auf der linken Seite) den Punkt Netz Service und SMTP (emails). Geben Sie hier nun die passenden Daten (siehe folgende Tabellen) ein und bestätigen Sie diese mit dem Aktualisieren-Button. Juli 12 Seite 3 von 12
SMTP Einstellungen TM-E/TM-H-Router ist per VPN mit Talk2M verbunden Parameter SMTP Server Adresse Beschreibung relay.talk2m.com SMTP Server Port 25 E-Mail Adresse Von Benutzername Passwort Hier wird die E-Mail-Adresse eintragen, die der TM-E/TM-H-Router als Absenderadresse in der E-Mail anzeigen soll. Dies kann jede beliebige, sollte aber ein möglichst sinnvolle Adresse (z.b. device001@customer_a.com) sein, damit die E-Mail nicht durch einen SPAM-Filter in Ihrem E-Mail-Posteingang blockiert wird. Dieses Feld kann leer bleiben. Dieses Feld kann leer bleiben. SMTP Einstellungen TM-E/TM-H-Router ist nicht per VPN mit Talk2M verbunden Parameter SMTP Server Adresse Beschreibung relay.ewon.biz SMTP Server Port 25 E-Mail Adresse Von Benutzername Passwort Hier wird die E-Mail-Adresse eintragen, die der TM-E/TM-H-Router als Absenderadresse in der E-Mail anzeigen soll. Dies kann jede beliebige, sollte aber ein möglichst sinnvolle Adresse (z.b. device001@customer_a.com) sein, damit die E-Mail nicht durch einen SPAM-Filter in Ihrem E-Mail-Posteingang blockiert wird. Hier muss ein gültiger Talk2M Benutzername und Account eingetragen werden. Definiertes Format: USERNAME@ACCOUNT Hier muss das Passwort zu dem gültigen Talk2M Account eingetragen werden. Juli 12 Seite 4 von 12
2.2 E-Mail konfigurieren Legen Sie nun eine Variable an, um eine E-Mail versenden zu können. In diesem Beispiel nutzen wir eine interne Bit-Variable, um einen E-Mail-Versand auszulösen. Diese verwenden wir nur zum Test. Natürlich können Sie auch direkt eine Variable aus Ihrer Steuerung auslesen. Gehen Sie dazu zunächst in die Konfigurationsoberfläche Ihres TM-E/TM-H-Routers. Weiter über den Menüpunkt Konfiguration Tag Einstellung Erstellen eines neuen Tags. Unsere Variable bekommt den Namen Email, ist von dem I/O-Server MEM und vom Typ her Digital. Des Weiteren aktivieren wir den Alarm, der digitale Alarmwert wird auf 1 gesetzt, und die Automatische Bestätigung aktiviert. Danach aktivieren wir am Bildende Benachrichtigung erstellen und betätigen mit Aktualisieren. In dem sich nun öffnenden Bild setzen wir den Haken im Feld ALM, geben eine Empfänger- E-Mail-Adresse, einen Betreff sowie den Text-Inhalt der E-Mail ein. Bestätigen Sie Ihre Eingaben mit dem Aktualisieren-Button. Juli 12 Seite 5 von 12
Nun können Sie die Funktion testen. Gehen Sie dazu über den Menüpunkt Hauptmenü Ansicht I/O, in die Ansicht Ihrer erstellten Tags. Dort können Sie in der Spalte Neuer Wert den Wert auf 1 setzen und mit einem Klick auf Aktualisieren übernehmen. Ihr Teleservice-Modul wird nun dazu aufgefordert, eine E-Mail an die von Ihnen angegebene E-Mail-Adresse zu senden. Überprüfen Sie dazu Ihren Posteingang. 2.3 E-Mail-Versand über die BASIC-Programmierung In allen TM-E/TM-H-Routern haben Sie die Möglichkeit, über die BASIC-Programmierung verschiendenste Funktionen zu realisieren. Möchten Sie eine E-Mail mit der BASIC-Funktion verschicken, dann nutzen Sie diese wie gewohnt mit unten genanntem Befehl. sendmail An den Parametern dieser Funktion ändert sich nichts. Weitere Informationen erhalten sie auch im Handbuch. 3 SMS-Versand mit TM-E/TM-H-Modulen Um die Funktionen in Talk2M Free+ nutzen zu können, benötigen Sie die passende Firmware (mindestens Version 6.4s3) auf Ihren VIPA Teleservice-Modulen. Diese können Sie sich kostenfrei aus dem Internet oder über die Software ebuddy laden und auf Ihre VIPA Teleservice-Module aufspielen. Juli 12 Seite 6 von 12
Die SMS-Funktion ist mit allen TM-E/TM-H-Routern nutzbar, unabhängig davon ob das Gerät bei Talk2M angemeldet ist oder nicht. In allen Fällen ist ein funktionierender Internet-Zugang des Teleservice-Moduls, sowie ein gültiger und aktiver Talk2M-Account zwingend notwendig. Die SMS-Funktion ermöglicht es allen Geräten unabhängig vom verwendeten Modem-Typ oder von landestypischen Gegebenheiten eine SMS zu versenden. Damit sind nun auch reine LAN-Router wie der VIPA TM-H-Router (VIPA Artikelnummer 900-2H611) in der Lage, eine SMS zu versenden. Die grundsätzliche Funktionsweise lässt sich einfach erklären: Der TM-E/TM-H-Router versendet eine E-Mail an den Talk2M-Server. Dieser wandelt diese E-Mail in eine SMS-Nachricht um und versendet diese wiederum an eine Zielperson - und dies weltweit. Für jede versendete SMS werden 0,30 EURO berechnet. Diese werden über Ihren Talk2M Account abgerechnet. Bei der Erstellung eines neuen Accounts sind bereits 15 EURO Startguthaben enthalten. Danach kann das Guthaben über das Talk2M Portal (https://my.talk2m.com) per Kreditkarte aufgeladen werden. 3.1 E-Mail-Postausgangsserver (SMTP) einrichten Zunächst muss ein E-Mail-Postausgangsserver (SMTP) eingerichtet werden. Dieser empfängt von den VIPA Teleservice-Modulen die Anfrage für einen SMS-Versand und versendet eine SMS an die entsprechenden Empfänger. Gehen Sie dazu zunächst in die Konfigurationsoberfläche Ihres TM-E/TM-H-Routers, anschließend weiter in den Menüpunkt Konfiguration Systemeinstellung Allgemein. Danach öffnen Sie im Baumdiagramm (auf der linken Seite) den Punkt Netz Service und SMTP (emails). Geben Sie hier nun die passenden Daten (siehe folgende Tabellen) ein und bestätigen Sie diese mit dem Aktualisieren-Button. Juli 12 Seite 7 von 12
SMTP Einstellungen TM-E/TM-H-Router ist per VPN mit Talk2M verbunden Parameter SMTP Server Adresse Beschreibung relay.talk2m.com SMTP Server Port 25 E-Mail Adresse Von Benutzername Passwort Hier wird die E-Mail-Adresse eintragen, die der TM-E/TM-H-Router als Absenderadresse in der E-Mail anzeigen soll. Dies kann jede beliebige, sollte aber ein möglichst sinnvolle (z.b. device001@customer_a.com) sein, damit die E-Mail nicht durch den SPAM-Filter in Ihrem E-Mail-Posteingang blockiert wird. Dieses Feld kann leer bleiben. Dieses Feld kann leer bleiben. SMTP Einstellungen TM-E/TM-H-Router ist nicht per VPN mit Talk2M verbunden Parameter SMTP Server Adresse Beschreibung relay.ewon.biz SMTP Server Port 25 E-Mail Adresse Von Benutzername Passwort Hier wird die E-Mail-Adresse eintragen, die der TM-E/TM-H-Router als Absenderadresse in der E-Mail anzeigen soll. Dies kann jede beliebige, sollte aber ein möglichst sinnvolle (z.b. device001@customer_a.com) sein, damit die E-Mail nicht durch den SPAM-Filter in Ihrem E-Mail-Posteingang blockiert wird. Hier muss ein gültiger Talk2M Benutzername und Account eingetragen werden. Definiertes Format: USERNAME@ACCOUNT Hier muss das Passwort zu dem gültigen Talk2M Account eingetragen werden. Juli 12 Seite 8 von 12
3.2 SMS konfigurieren Legen Sie nun eine Variable an, um eine SMS versenden zu können. In diesem Beispiel nutzen wir eine interne Bit-Variable, um einen SMS-Versand auszulösen. Diese verwenden wir nur zum Test. Natürlich können Sie auch direkt eine Variable aus Ihrer Steuerung auslesen. Gehen Sie dazu zunächst in die Konfigurationsoberfläche Ihres TM-E/TM-H-Routers. Weiter über den Menüpunkt Konfiguration Tag Einstellung Erstellen eines neuen Tags. Die Variable bekommt den Namen SMS, ist von dem I/O-Server MEM und vom Typ her Digital. Des Weiteren wird der Alarm aktiviert, der digitale Alarmwert auf 1 gesetzt, und die automatische Bestätigung aktiviert. Danach aktivieren wir am Bildende Benachrichtigung erstellen und bestätigen die Eingabe durch einen Klick auf Aktualisieren. In dem sich nun öffnenden Bild aktivieren wir bei der E-Mail-Funktion ALM sowie als Kurznachricht versenden, geben eine Empfänger-Adresse, einen Betreff sowie den Text-Inhalt ein. Bestätigen Sie die Eingabe mit einem Klick auf den Aktualisieren-Button. ACHTUNG: Nutzen Sie nicht die SMS-Funktion! Juli 12 Seite 9 von 12
Um eine SMS über den Talk2M-Server zu versenden, verwenden Sie auf jeden Fall folgendes Format: Handynummer@sms.talk2m.com Die Mobilfunknummer wird hierbei im internationalen Format mit führenden Nullen oder +-Zeichen eingetragen. Beispiel: 00491701234567@sms.talk2m.com oder +491701234567@sms.talk2m.com für die Handynummer 01701234567 in Deutschland (0049). Nun können Sie die Funktion testen. Gehen Sie dazu über den Menüpunkt Hauptmenü Ansicht I/O, in die Ansicht Ihrer erstellten Tags. Dort können Sie in der Spalte Neuer Wert den Wert auf 1 setzen und mit einem Klick auf Aktualisieren übernehmen. Ihr Teleservice-Modul wird nun dazu aufgefordert, eine SMS an die von Ihnen angegebene Mobilfunknummer zu senden. Juli 12 Seite 10 von 12
3.3 SMS-Versand über die BASIC-Programmierung In allen TM-E/TM-H-Routern haben Sie die Möglichkeit über die BASIC-Programmierung verschiendenste Funktionen zu realisieren. Möchten Sie eine SMS via Talk2M Relay über BASIC-Skript verschicken, dann nutzen Sie hier anstatt sendsms unten genanntem Befehl. sendmail Dabei wird der E-Mail Betreff als Inhalt der SMS ausgegeben. Die Parameter Kopie und E-Mail Inhalt werden nicht benutzt. Dies mag im ersten Moment unlogisch klingen. Bedenkt man aber, dass eine E-Mail versendet wird und diese wiederum als SMS gewandelt wird, macht der Befehl sendmail jedoch Sinn. Beispiel: sendmail "+491701234567@sms.talk2m.com", "", "Inhalt der SMS", "" Weitere Informationen erhalten sie auch im Handbuch. Bitte beachten Sie, dass der Inhalt der SMS auf maximal 160 Zeichen begrenzt ist. Juli 12 Seite 11 von 12
4 Revision History 4.1 Änderungen DATUM ÄNDERUNGEN BEARBEITER 26.07.2012 Erstellung Dokument S. Isinger Juli 12 Seite 12 von 12