agorum_ai_agents_library_basic_update_draft_mail

Anzeigename: Update a draft email

Was macht das Tool?

Dieses Tool aktualisiert ein vorhandenes E-Mail-Objekt im Entwurfsstatus ("draft") in agorum core. Es können nur E-Mails bearbeitet werden, die sich tatsächlich noch im Status "Entwurf" befinden. Mit diesem Tool können etwa Betreff, Empfänger, Inhalt, Anhänge und weitere Eigenschaften angepasst werden, bevor eine E-Mail final versendet wird.

Nach der Aktualisierung gibt das Tool zurück, ob die Speicherung erfolgreich war und liefert einen Link zum aktualisierten Objekt.

Empfohlener Einsatzzweck

Das Tool wird eingesetzt, wenn ein bereits angelegter E-Mail-Entwurf in agorum core angepasst werden soll – zum Beispiel, um Empfänger, Betreff, Inhalt, Anhänge oder weitere Metadaten zu ändern, bevor die E-Mail versendet wird. Es eignet sich besonders für automatisierte Workflows, in denen E-Mail-Entwürfe programmatisch bearbeitet werden müssen.

Funktionsbeschreibung

Parameter	Beschreibung
mail (Pflicht)	ID (Pfad, ID oder UUID) des agorum core Mailobjekts, das aktualisiert werden soll. Nur E-Mails mit Status "draft" sind zulässig.
data (Pflicht)	Objekt mit den zu aktualisierenden Feldern der E-Mail. Nur die angegebenen Felder werden geändert. Beispiele für mögliche Felder: priority ("low", "normal", "high") sensitivity ("normal", "personal", "private", "company-confidential") receipt (boolean, Lesebestätigung) from (Absenderadresse) to (Array von Empfängeradressen) cc, bcc (Array von CC- oder BCC-Adressen) subject (Betreff) body (E-Mail-Inhalt im HTML-Format) replyTo (Reply-To Adresse) attachments (Array von IDs agorum core Objekte als Anhang) shouldSendDispositionNotification (Ob eine Empfangsbestätigung gesendet werden soll) dispositionNotificationTo (Adresse für Empfangsbestätigung) seen (als gelesen markieren) defaultSenderAddress (vorgegebene Absender-Adresse)

 

Tipps und Tricks

• Es können nur Entwurfs-Mails bearbeitet werden. Bereits gesendete oder empfangene E-Mails können nicht geändert werden.
• Im data-Objekt müssen nur die Felder angegeben werden, die tatsächlich geändert werden sollen. Alle anderen bleiben unverändert.
• Die Anhänge müssen als gültige agorum core Objekte (ID, UUID oder Pfad) übergeben werden.
• Die Fußzeile (Signatur) der E-Mail wird automatisch anhand der Absenderadresse ergänzt, sofern nicht explizit eine andere angegeben wird.