Email/SMS-Vorlagen

Erstellen Sie eine beliebige Anzahl an Email/SMS-Vorlagen, die Sie als Anmeldebestätigung, Ergebnis-SMS oder als Newsletter versenden können. Analog zum Ausgabe-Fenster können Sie existierende Vorlagen kopieren, löschen, umbenennen, exportieren oder auch Vorlagen importieren.

Bei jeder Vorlage können Sie aus verschiedenen Typen wählen:

Email

Wählen Sie das Empfänger-Feld (Standard: Email) aus, das die Email-Adresse(n) enthält, an die Emails gesendet werden sollen.

Sie müssen auch eine Absender-Email-Adresse angeben, also die Email, die dem Empfänger angezeigt wird. Sie können optional den Absendernamen, CC/BCC-Email-Adressen und eine Antwort-Email-Adresse festlegen.

Im Betreff und im Inhalt der Email können Felder und Ausdrücke für dynamische Inhalte verwenden werden. Hier müssen Sie sicherstellen, dass alle Felder oder Ausdrücke in eckigen Klammern eingeschlossen sind.

Inhalte können entweder als einfacher Text oder als vollständiges HTML geschrieben werden. Wenn Sie einen externen Editor für Ihre E-Mail-Layouts verwenden, beachten Sie, dass einige davon Code enthalten, um das einfache Kopieren und Einfügen der Inhalte in eine Plattform eines Drittanbieters zu verhindern.

Es ist auch möglich, Urkunden oder Dateien als Anhang mitzusenden.

Email Vorlagen sind mehrsprachig, somit kann eine Vorlage den Inhalt mehrerer Sprachen beinhalten. Wenn eine Email über RACE RESULT 12 versendet wird, wird das Standard-Feld Sprache genutzt, um die Email in der richtigen Sprache zu versenden. Ist bei einem Teilnehmer das Feld leer, oder für die hinterlegte Sprache keine entsprechende Vorlage vorhanden, wird die Email in der Sprache verschickt in welcher die Software aktuell genutzt wird.

Wichtig: Sie können maximal 10 Emails über den RACE RESULT SMTP Server versenden. Dies ermöglicht Ihnen, die Funktionalität zu testen, aber erlaubt es Ihnen nicht, Newsletter zu versenden. Wenn Sie mehr als 10 Nachrichten versenden möchten, müssen Sie diese über Ihren eigenen SMTP-Server verschicken. Unten links können Sie die Zugangsdaten hierfür eingeben. Beachten Sie auch, dass viele Anbieter den E-Mail-Versand beschränken. Google Mail hat bspw. eine Beschränkung bei 500 Emails pro Tag.

SMS

Bestimmen Sie einen Absender-Namen (max. 11 Zeichen - ohne Umlaute) sowie den Text für die Nachricht. Beachten Sie, dass die Nachrichtenlänge auf 160 Zeichen beschränkt ist und alles nach diesen 160 Zeichen abgeschnitten wird. Für SMS mit Emojis oder anderen Unicode-Sonderzeichen ist die maximale Länge auf 70 Zeichen limitiert.

Wichtig: Der Versand von SMS ist nicht kostenlos! Sie müssen vor dem Versand Ihre Login-Daten angeben. RACE RESULT berechnet je versendeter SMS ein Credit.

Web Service Call

Beim WebService-Aufruf können Sie zwischen einem GET oder POST Aufruf wählen und eine URL angeben, die durch einen Ausdruck definiert wird. Die Funktion urlencode() kann Ihnen für die Erstellung der korrekten URL hilfreich sein. Beispiel:

"https://my.server.com/webservice/message.php?bib=" & [Startnr] & "&name=" & urlencode([Vorname] & " " & [Nachname])

Darüberhinaus können Sie HTTP Header definieren und das Ergebnis des Calls in einem zusätzlichen Textfeld speichern.

Weitere Optionen

Standardmäßig werden E-Mails/SMS an die in den Standardfeldern [Mail] bzw. [Handy] gespeicherte Adresse/Nummer gesendet. Soll die Vorlage an einen anderen Empfänger gehen, wählen Sie als Empfängerfeld das Datenfeld aus, in dem die abweichende Adresse/Nummer gespeichert ist. Wenn Sie dieselbe Email- oder SMS-Vorlage an mehrere Empfänger senden möchten, können Sie diese im gewählten Empfänger-Feld durch Semikolon trennen.

Möchten Sie eine Nachricht nur an bestimmte Teilnehmer verschicken, setzen Sie einen Standard-Filter. Vor dem Versand können Sie diesen Filter immer noch anpassen, aber Sie werden den Filter dadurch nicht vergessen. Um eine Vorlage nur an Teilnehmer von Wettbewerb 2 zu senden, setzen Sie folgenden Filter:

[Wettbewerb]=2

Um nachzuverfolgen, an wen eine Nachricht bereits verschickt wurde, können Sie eine Checkbox setzen. Es empfiehlt sich, diese Funktion mit dem Standard-Filter zu verbinden, sodass Nachrichten nur verschickt werden, wenn sie nicht schon früher verschickt wurden. Setzen Sie Checkbox beim Versenden der Nachricht und setzen Sie dann diesen Filter:

[Wettbewerb]=2 AND [CheckboxName]=0

Anhänge

Wenn Sie mit der E-Mail einen oder mehrere Anhänge senden möchten, müssen Sie in jedem Fall das gewünschte Dateiformat angeben. Wenn Sie eine Urkunde als .pdf-Datei verschicken möchten, geben Sie den gewünschten Dateinamen für die Urkunde an, gefolgt von der Dateiendung .pdf. Die Bezeichnung Urkunde im nachfolgenden Beispiel kann beliebig geändert werden.

Urkunde.pdf

Wenn eine Gruppen-Email versendet wird, kann ein Filter eingesetzt werden um entweder nur dem ersten Teilnehmer aus der Gruppe (nach GroupRegPos), dem letzten Teilnehmer (nach GroupRegPos), oder allen Teilnehmern der Gruppe eine Email zu schicken.

Eigener SMTP-Server

Wenn Sie E-Mails von RACE RESULT 12 aus versenden, können Sie unsere Server nutzen, um maximal 10 E-Mails zu versenden, oder Sie können Ihren eigenen SMTP-Server verwenden, um mehr als 10 E-Mails zu versenden.

Geben Sie die Zugangsdaten Ihres SMTP-Servers ein. Wenn Sie diese nicht finden, wenden Sie sich an Ihren Anbieter. Üblicherweise entspricht der User Name der E-Mail-Adresse mit dem dazugehörigen Passwort. Wenn Sie Ihren SMTP-Server zum ersten Mal konfigurieren, testen Sie den Versand über den Server, indem Sie sich selbst eine E-Mail über RACE RESULT 12 senden.

Hier finden Sie einige gängige SMTP-Server-Einstellungen. Bitte beachten Sie, dass sich diese Einstellungen ändern und möglicherweise nur bis zum Datum der Erstellung dieses Artikels, dem 17.3.2020, korrekt sind.

Office 365 SMTP-Einstellungen

  • Server: smtp.office365.com
  • Port: 587
  • Verschlüsselung: TLS

Outlook SMTP-Einstellungen

  • Server: smtp-mail.outlook.com
  • Port: 587
  • Verschlüsselung: TLS

GoDaddy SMTP-Einstellungen Americas

  • Server: smtpout.secureserver.net
  • Port: 465 oder 587
  • Verschlüsselung: SSL

 

Email SMTP Errors

Context Deadline Exceeded

The e-mail SMTP server is unreachable, this may be a temporary outage of the server or a limit in the sending rate of the SMTP server.

Connection Refused

This error occurs when the SMTP server you are trying to connect to refuses the connection. A few things to consider when getting this error.

  • What are the limits of your email provider? Most providers limit the number of emails that can be sent in a given amount of time.
  • Is your email address out of space? If your email is running out of space you may run into issues sending multiple emails.

Incorrect authentication data

  • This error occurs when your SMTP settings are incorrect for your email address.

Automatische E-Mail Fehlerbenachrichtigung

Wenn es im Rahmen der Onlineanmeldung zu einem Fehler bei dem E-Mail-Versand gibt, dann wird an die für die Kundennummer hinterlegte E-Mailadresse eine Fehlermeldung versendet.

Diese enthält neben der Veranstaltungs-ID und dem Zeitpunkt auch den Auslöser (Kontext) und die Fehlerbeschreibung.

Beispieltext:


Sehr geehrter Herr Zeitnehmer,

Ein Fehler ist in Veranstaltung 123456 aufgetreten:

Zeitpunkt:
2024-01-01T12:45:09+02:00

Kontext:
AfterSave actions of registration "Einzel-Anmeldung", ID 123

Fehler:
error sending email in AfterSave actions: no email given

Wir bitten Sie, das Problem zu prüfen und ggf. zu korrigieren. Bei Fragen stehen wir gerne zur Verfügung.

Mit freundlichen Grüßen
Ihr RACE RESULT Team


Häufige Fehler:

Fehlerbeschreibung: error sending email in AfterSave actions: no sender given
Erläuterung: In dem verwendeten E-Mail-Template, das nach der Anmeldung versendet werden soll, ist kein Absender eingetragen.


Fehlerbeschreibungerror sending email in AfterSave actions: no subject given
Erläuterung: Im verwendeten E-Mail-Template, das nach der Anmeldung versendet werden soll, ist kein Betreff angegeben.


Fehlerbeschreibungerror sending email in AfterSave actions: no email given
Erläuterung: Das Anmeldeformular wird das Feld für die Empfänger-E-Mail-Adresse nicht abgefragt/gespeichert.


Fehlerbeschreibungerror sending email in AfterSave actions: error sending email: gomail: could not send email 1: 450 4.1.2 <sample@wrongurl.com>: Recipient address rejected: Domain not found
Erläuterung: Die E-Mail konnte nicht versendet werden, da die Adresse des Empfängers nicht erreicht werden kann. Hier handelt es sich sehr oft um eine Fehleingabe/Tippfehler.


Fehlerbeschreibungerror sending email: gomail: could not send email 1: 450 Requested mail action not taken: mailbox unavailable
Mail send limit exceeded.
Erläuterung: Das Versandlimit des verwendeten Mailservers wurde erreicht, da die meisten Provider aus Schutz vor Spammail Limits eingerichtet haben. 


Fehlerbeschreibungerror sending email in AfterSave actions: error sending email: gomail: could not send email 1: 450 4.7.1 <sample@participant.com>... sample@organizer.com has exceeded 5000 messages per 1 day
Erläuterung: Das Versandlimit des verwendeten Mailservers wurde erreicht, da die meisten Provider aus Schutz vor Spammail Limits eingerichtet haben. Hier mit der Detailangabe, dass das Tageslimit von 5000 Nachrichten erreicht wurde.


Fehlerbeschreibungerror sending email in AfterSave actions: Post "https://messy.raceresult.com/emails/send?sync=true": context deadline exceeded (Client.Timeout exceeded while awaiting headers)
Erläuterung: Der E-Mail-Empfangsserver hat nicht in der erwarteten Zeit auf die Anfrage geantwortet. Der genaue Grund ist aufseiten des Empfängers zu finden. 


Anmerkung: 

Die im Kontext aufgeführte ID ist die ID des Teilnehmers, dessen Anmeldung den Fehler ausgelöst hat.

Writing JSON in to a Web Service Call POST Body

Email Templates can be used to send requests to another URL using a Web Service Call, these often require sending data fields in JSON format which requires some special considerations. First create a new e-mail/SMS template and set the Delivery Setting type as "Web Service Call". 

You will need to ensure to set the Method to POST, where the data is then sent in the POST body, the URL is the destination of the web service call, note that this cannot contain fields as it is plain text so does not support variables in the URL. 

The POST body contains the data to be sent where you can enter this without any additional quotation marks, any text enclosed in square brackets will be treated as a RACE RESULT field or function to insert data. 

{"name": "[FirstName]", "age": [Age]}

 

If your endpoint requires additional headers such as an API key for authentication then these can be entered with the name and value of the header. You might need to include other required elements specific to the JSON service you are using, these elements should also be included in the header.