Webhooks
PreSend
Mithilfe des preSend Hook kann man vor dem Versenden der Anfrage eingreifen.
Er wird kurz vor dem Versand der Anfrage aufgerufen, wo die Daten bereits erfolgreich validiert wurden. Beispielsweise können durch preSend Hooks Attachements generiert und dem Mail hinzugefügt werden.
Funktionsweise
Sobald die Webhooks registriert sind, werden vor dem Versand alle registrierten Hooks (preSendWebhooks) aufgerufen und es wird ein POST Request an die angegebene URL gemacht. Mit addAttachements kann man bestimmen, dass die zurückgesendeten Daten in ein Attachement hinzugefügt werden sollen. Damit das Attachement gespeichert wird, braucht es drei Bedingungen, die auf Integrationsseite erfüllt werden sollen:
- HTTP Status Code sollte 200 oder 201 sein (ist im Debug-Modus erkenntlich)
- HTTP Content Type sollte entsprechend gesetzt sein
- HTTP Content-Disposition sollte als type attachment angeben und den Dateinamen mitsenden
Im Debug-Modus werden die Daten sowie Fehler und Warnungen ausgegeben. Das generierte Attachment wird auch angezeigt. Im Production Modus werden bei Fehler und Warnungen die Anhänge nicht an das Mail hinzugefügt.
PostSend
Setzt einen POST Request auf die angegebene URL ab. Mitgeliefert werden alle Formular Felder. Zusätzlich kann man noch weitere Felder in den Settings mitgeben. Das kann hilfreich sein, um Werte mitzugeben, die nicht für die Besucher:innen des Online-Projekts sichtbar sein sollen, wie zum Beispiel eine Interne ID der Gegenseite.
Receiverlist - Hook
Wenn das Anfrage-E-Mail aufgrund eines bestimmten Wertes an verschiedene Empfänger gesendet werden soll, kann das mittels TypoScript konfiguriert werden: