.MAIL

Versendet E-Mails direkt oder über einen Webhook (RAGAI.MAIL).

Hintergrund

send verschickt eine E-Mail direkt über den internen Mailversand (UserMailService); webhookleitet stattdessen an einen extern konfigurierten Webhook eines Skills weiter (über RAGAI.WEBHOOK.call()) - nützlich, um E-Mail-Inhalte an ein externes System (z. B. CRM, Ticket-System) statt an einen echten E-Mail-Server zu senden.

Methoden

.getEnvelope(to, subject, body)

Baut ein E-Mail-Umschlag-Objekt (Empfänger, Betreff, Inhalt).

Parameter	Typ	Beschreibung
to	string	Empfänger-Adresse.
subject	string	Betreff der E-Mail.
body	string	Inhalt der E-Mail.

Rückgabewert: Promise<&#123; to: string; subject: string; body: string; &#125;>

Das Umschlag-Objekt.

.send(request)

Sendet eine E-Mail direkt über den konfigurierten Mailversand.

Parameter	Typ	Beschreibung
request	SendMailRequest | z.input<typeof mailSendSchema>	Die E-Mail-Daten, oder ein Objekt gemäß mailSendSchema.

Objekt-Form (validiert über mailSendSchema):

Feld	Typ	Pflicht	Beschreibung
to	string	✔	Empfänger-Adresse.
subject	string	✔	Betreff der E-Mail.
body	string	✔	Inhalt der E-Mail.

Rückgabewert: Promise<SendMailResponse>

Das Ergebnis des Versands.

.webhook(webhook, envelope?)

Sendet eine E-Mail über einen konfigurierten Webhook.

Parameter	Typ	Beschreibung
webhook	string | z.input<typeof mailWebhookSchema>	ID des Webhooks, oder ein Objekt gemäß mailWebhookSchema.
envelope	&#123; to: string; subject: string; body: string &#125;	Empfänger, Betreff und Inhalt der E-Mail.

Objekt-Form (validiert über mailWebhookSchema):

Feld	Typ	Pflicht	Beschreibung
webhook	string	✔	ID des Webhooks, über den die E-Mail versendet wird.
envelope	any	✔	Empfänger, Betreff und Inhalt der E-Mail.

Rückgabewert: Promise<void>

Nichts.