Dokumentation

Erinnerungen und Rückfrage

Automatische E-Mails vor dem Event und die Rückfrage, ob Gäste kommen.

Erinnerungen verschicken vor einem Event automatisch E-Mails an bestätigte Gäste. Die Rückfrage fragt dieselben Gäste, ob sie kommen. Beides gehört zu einem Event.

Erinnerungen

Neue Events starten mit zwei Erinnerungen: 24 Stunden und 1 Stunde vor Beginn. Beide sind normale Einträge und lassen sich ändern oder deaktivieren. Die Oberfläche bietet für sie kein Löschen an.

Je Event sind höchstens 10 Erinnerungen erlaubt. Mehr ergeben Status 409 und reminder_limit.
Der Vorlauf liegt zwischen 5 und 100000 Minuten.
Der Betreff ist Pflicht und höchstens 200 Zeichen lang.
Der Text ist Pflicht und höchstens 20000 Zeichen lang.
Empfänger sind bestätigte Anmeldungen ohne Check-in.
Nur aktive Erinnerungen werden versendet.
Versendet wird nur, solange das Event veröffentlicht und noch nicht vorbei ist.
Der Versand zählt zum wöchentlichen Empfängerkontingent.
Jede Anmeldung erhält jede Erinnerung höchstens einmal.

Im Betreff und im Text ersetzen Platzhalter die Angaben des Events und des Gasts: {{titel}}, {{name}}, {{start}}, {{ort}}, {{rsvp}}, {{ticket}} und {{link}}.

Rückfrage

Die Erinnerung enthält Links auf /rsvp?token=<token> mit answer=yes oder answer=no, solange die Antwort noch offen ist. Der Token gehört zu einer Anmeldung und ist ein Geheimnis. Die Seite trägt noindex und wird nicht zwischengespeichert.

Die Antwort yes speichert die Zusage. Der Anmeldestatus bleibt unverändert.
Die Antwort no storniert eine offene, bestätigte oder wartende Anmeldung. Bei einer offenen oder bestätigten Anmeldung wird der Platz für die Warteliste frei.
Eine bereits stornierte oder abgelehnte Anmeldung bleibt unverändert.

Endpunkte

Methode	Pfad	Zweck
GET	/api/events/{eventID}/reminders	Erinnerungen eines Events lesen.
POST	/api/events/{eventID}/reminders	Erinnerung anlegen.
PATCH	/api/events/{eventID}/reminders/{reminderID}	Erinnerung ändern.
DELETE	/api/events/{eventID}/reminders/{reminderID}	Erinnerung löschen.
GET	/api/public/rsvp?token=<token>	Rückfrage lesen.
POST	/api/public/rsvp	Antwort speichern, Rumpf mit token und answer.

Die POST-Antwort auf eine Rückfrage enthält answer, released und message.

Die Erinnerungsendpunkte brauchen ein Sitzungs-Token und die Rolle Eigentümer oder Verwaltung. Die Rückfrage ist öffentlich und braucht nur den Token.

Die Erinnerungen und die Rückfrage sind gebaut. SMS, Push und WhatsApp sind als weitere Kanäle geplant, aber noch nicht gebaut.