Dokumentation

Nachrichten

E-Mails an Gäste entwerfen, planen, senden und Kontingente beachten.

Nachrichten gehen per E-Mail an eine Gruppe von Anmeldungen eines Events. Sie können sofort versendet oder für einen Zeitpunkt in der Zukunft geplant werden.

Empfängerkreise

Zielgruppe	Empfänger
all	Offene und bestätigte Anmeldungen. Die Warteliste ist nicht enthalten.
confirmed	Nur bestätigte Anmeldungen.
waitlisted	Nur Anmeldungen auf der Warteliste.
checked_in	Nur bestätigte Anmeldungen, die bereits eingecheckt sind.

Stornierte und abgelehnte Anmeldungen erhalten nie eine Nachricht. Doppelte E-Mail-Adressen werden entfernt.

Inhalt

Betreff mit höchstens 200 Zeichen.
Text mit höchstens 20.000 Zeichen.
Zielgruppe, standardmäßig all.
Optional ein Versandzeitpunkt als RFC-3339-Zeitpunkt in der Zukunft.

Entwurf, Planung und Versand

Nachricht als Entwurf anlegen und prüfen.
Entweder sofort senden oder einen Versandzeitpunkt setzen.
Eine geplante Nachricht lässt sich abbrechen, solange sie noch nicht versendet wird.
Nach dem Versand sind Änderungen und Löschen nicht mehr möglich.

Der Versand läuft im Hintergrund. Die API antwortet auf einen Sofortversand mit Status 202, status: sending und der Zahl der Empfänger. Der Status wechselt danach auf sent. Gesendete Nachrichten zeigen zusätzlich die Zahl der fehlgeschlagenen Zustellungen.

Eine Nachricht mit gesetztem Versandzeitpunkt bleibt technisch ein Entwurf. In der Oberfläche erscheint sie als Geplant.

Versandkontingent

Das Kontingent zählt Empfänger, nicht Nachrichten. Es umfasst alle Empfänger von Nachrichten der Organisation in den letzten sieben Tagen. Eventwerk erlaubt 500 Empfänger pro Woche, Eventwerk Plus 5.000.

Ist das Kontingent erreicht, antwortet der Versand mit Status 403 und dem Code weekly_send_limit. Die Antwort enthält unter details die Werte limit, used und plan.

Zustellung über Werkmail

Eventwerk versendet alle E-Mails über die Premium-Infrastruktur von Werkmail (werkmail.eu).

Mehr zur Infrastruktur steht unter werkmail.eu.

Automatische Erinnerungen vor dem Event sind gebaut und stehen unter Erinnerungen bereit. SMS, Push und WhatsApp sind als weitere Kanäle geplant, aber noch nicht gebaut. Nachrichten werden derzeit nur manuell oder zu einem festen Zeitpunkt versendet.