Zum Inhalt

E-Mail aus Vorlage versenden über Pantarey (intern)

Der Service Task „E-Mail aus Vorlage versenden über Pantarey (intern)“ rendert Betreff und HTML-Inhalt aus einer Handlebars-Vorlage und versendet die E-Mail über den Pantarey-internen Dienst mit dem Absender benachrichtigung@pantarey.io. Empfänger können nur Benutzer des eigenen Pantarey-Accounts sein. Der Service eignet sich für Hinweise an Bearbeiter, nicht für Kunden oder andere Externe. Ohne Vorlage, mit fertigem HTML, leistet dasselbe E-Mail versenden über Pantarey (intern).

Technischer Name prio_sendCustomEmailTemplate · Kategorie im Dialog „Service-Task auswählen“: E-Mail

Wann wird dieser Service verwendet?

  • Eingang einer Anfrage melden: Bei der Musterfirma GmbH wird der zuständige Bearbeiter informiert, wenn eine Schulungsanfrage eingeht, mit Firma, Thema und Wunschtermin aus der Anfrage.
  • Erinnerungen an Bearbeiter: Ein Timer stellt fest, dass ein Angebot seit 14 Tagen offen ist, und benachrichtigt den Vertrieb.
  • Status an das Team: Nach einem Wareneingang erhält der Hardware-Verantwortliche eine Zusammenfassung der Positionen.

Welcher E-Mail-Service?

Service Absender Empfänger
E-Mail aus Vorlage versenden über Pantarey (intern) – diese Seite – und E-Mail versenden über Pantarey (intern) benachrichtigung@pantarey.io nur Benutzer des eigenen Pantarey-Accounts
E-Mail versenden an externe Empfänger (eigene Domain) eigene Domain, für den Account freigegeben beliebig
E-Mail senden (über SMTP) und aus Template eigener Mailserver, jede Adresse, die der Server erlaubt beliebig
E-Mail senden (Microsoft Graph) Microsoft-365-Konto beliebig

Voraussetzungen

  • Jede Empfängeradresse muss zu einem Benutzer dieses Pantarey-Accounts gehören. Unbekannte Adressen führen dazu, dass gar keine Mail gesendet wird.
  • Anhänge dürfen zusammen rund 5 MB nicht überschreiten.
  • Keine Zugangsdaten nötig; Secrets werden von diesem Service nicht aufgelöst.

Eingabe

Feld Typ Pflicht Bedeutung
subject String mit Handlebars ja Betreff-Vorlage, wird mit contentData gerendert
contentTemplate String mit Handlebars ja HTML-Vorlage für den Inhalt; muss Text sein, ein Objekt bricht ab
contentData Objekt nein Daten für die Platzhalter; Standard {}
toRecipients String oder String-Array ja Empfänger; jede Adresse wird getrimmt, kleingeschrieben und gegen die Benutzer des Accounts geprüft
attachments Datei-Objekt oder Array nein Anhänge {referenceId, filename, contentType} aus dem Pantarey-Speicher

Für die Vorlagen stehen alle Handlebars-Helfer zur Verfügung. Das HTML wird so gesendet, wie es gerendert wurde; es wird nicht in die Pantarey-Systemvorlage eingebettet.

{
  "subject": "Neue Schulungsanfrage von {{anfrage.firma}}",
  "contentTemplate": "<p>Hallo {{bearbeiter.vorname}},</p><p>{{anfrage.firma}} fragt eine Schulung „{{anfrage.thema}}“ für {{anfrage.teilnehmer}} Personen an. Wunschtermin: {{toGermanDate anfrage.termin}}.</p>",
  "contentData": { "anfrage": anfrage, "bearbeiter": bearbeiter },
  "toRecipients": [ bearbeiter.email ],
  "attachments": [ anfrage.anhang ]
}

Ausgabe

{ "status": 200 }

Ist eine Empfängeradresse kein Benutzer des Accounts, kommt { "status": 400, "message": "One or more users do not exist" } zurück, und es wird nichts gesendet. Das Ergebnis landet unter dem Ergebnispfad; wer es nicht braucht, schaltet Ergebnis verwerfen ein.

Fehler und Verhalten

  • Unbekannter Empfänger liefert {status: 400, message} und der Prozess läuft weiter, ohne dass eine Mail gegangen ist. Soll der Vorgang in diesem Fall abbrechen, gehört in den Output-Ausdruck status = 200 ? $ : $error(message).
  • Anhänge über rund 5 MB werfen: Attachments too large for the internal email service (~x MB encoded, limit ~5 MB). Use an external email task (Office/SMTP) for larger files.
  • Fehlender Betreff oder Inhalt wird erst vom Versanddienst abgewiesen, mit der wenig aussagekräftigen Meldung Invalid sendGenericEmail payload.
  • Technische Fehler des Versanddienstes werfen template-server sendGenericEmail failed: ….
  • Jeder geworfene Fehler führt über ein Fehler-Randereignis weiter; ohne Randereignis endet der Vorgang im Fehler mit Wiederaufsetzpunkt und Fehler-Mail an den Prozessverantwortlichen.
  • Wiederholungen: Bis zu drei Versuche nur bei vorübergehenden technischen Fehlern; eine Mail kann dann doppelt ankommen. Zeitgrenze 900 Sekunden. Im Dry Run wird keine Mail gesendet.

Beispiel

Bei der Musterfirma GmbH geht eine Schulungsanfrage über ein Formular ein. Ein Datenbank-Schritt liest den zuständigen Bearbeiter nach Thema; in der Nachricht liegen anfrage (Firma, Thema, Teilnehmer, Termin, Anhang) und bearbeiter (Vorname, E-Mail).

  1. Input-Ausdruck wie oben.
  2. Output-Ausdruck status = 200 ? $ : $error(message), Ergebnispfad benachrichtigung.
  3. Ausgabe { "status": 200 }. Ist bearbeiter.email kein Benutzer des Accounts, bricht der Vorgang mit One or more users do not exist ab.
  4. Nächster Schritt: Eine Benutzeraufgabe „Anfrage bearbeiten“ für denselben Bearbeiter.

Häufige Fragen

Kann damit eine Mail an einen Kunden gesendet werden?

Nein. Empfänger müssen Benutzer dieses Pantarey-Accounts sein. Für Kunden und andere Externe: E-Mail versenden an externe Empfänger (eigene Domain), SMTP oder Microsoft Graph.

Kann der Absender oder die Antwortadresse geändert werden?

Nein. Absender ist immer benachrichtigung@pantarey.io, eine Antwortadresse wird nicht gesetzt.

Ein Empfänger war falsch, trotzdem lief der Prozess durch.

Der Schritt liefert dann status 400 statt eines Fehlers, und es wird an niemanden gesendet. Mit dem Output-Ausdruck status = 200 ? $ : $error(message) wird daraus ein Abbruch.

Nächster Schritt

E-Mail versenden an externe Empfänger (eigene Domain): der Weg für Kunden und Partner, mit Absender der eigenen Domain.