MS365

Microsoft 365 und Outlook.com erreichen Sie über Microsoft Graph. Es muss kein Mailprogramm laufen, und es funktioniert auch mit dem neuen Outlook. Für den häufigsten Fall, eine Mail mit Anhängen senden, gibt es außerdem die fertige Aktion Outlook365.

Einmalig: Konnektor anlegen

1. Öffnen Sie Konnektoren, klicken Sie auf Neu und wählen Sie die Vorlage Microsoft Outlook Mail (für Kontakte: Outlook Contacts).
2. Nennen Sie den Konnektor OutlookMail (bzw. OutlookContacts) und speichern Sie.
3. Klicken Sie auf Im Browser anmelden, melden Sie sich mit dem Postfach an und bestätigen Sie die Berechtigungen.

Der Status zeigt danach Bereit. RUNOS erneuert die Anmeldung selbst. Mehr unter OAuth2.

Mail senden

{
  "Type": "HttpRequest",
  "Name": "MailSenden",
  "Parameters": {
    "Url": "https://graph.microsoft.com/v1.0/me/sendMail",
    "Method": "POST",
    "Connector": "OutlookMail",
    "BodyType": "json",
    "Body": {
      "message": {
        "subject": "Ihr Dokument {{FileName}}",
        "body": { "contentType": "Text", "content": "Guten Tag,\n\nanbei Ihr Dokument." },
        "toRecipients": [ { "emailAddress": { "address": "kunde@example.com" } } ],
        "attachments": [
          {
            "@odata.type": "#microsoft.graph.fileAttachment",
            "name": "{{FileName}}",
            "contentBytes": "{{FilePath.toBase64()}}"
          }
        ]
      },
      "saveToSentItems": true
    }
  }
}

• {{FilePath.toBase64()}} liest die Datei und liefert ihren Inhalt als Base64, so wie Graph ihn für Anhänge erwartet.
• Graph antwortet mit StatusCode 202 und leerem Body; die Mail liegt danach in Gesendete Elemente.
• Auf diesem Weg sind Anfragen bis etwa 4 MB möglich. Für größere Anhänge nehmen Sie die Aktion Outlook365, sie lädt Dateien bis 150 MB in Teilen hoch.

Kontakte lesen

{
  "Type": "HttpRequest",
  "Name": "Kontakte",
  "Parameters": {
    "Url": "https://graph.microsoft.com/v1.0/me/contacts?$select=displayName,emailAddresses,companyName&$top=100",
    "Connector": "OutlookContacts",
    "AutoPagination": true
  }
}

Mit AutoPagination folgt RUNOS dem @odata.nextLink von Graph, bis alle Seiten gelesen sind; jede Seite ist ein Eintrag in Response.Results. Die Kontakte aller Seiten stehen zusammen in {{Kontakte.Response.Items}} und lassen sich mit einer Loop durchlaufen:

{
  "Type": "Loop",
  "Name": "JederKontakt",
  "Parameters": {
    "Items": "{{Kontakte.Response.Items}}",
    "Do": [
      { "Type": "SMTP", "Name": "Anschreiben", "Parameters": { "To": "{{item.emailAddresses.0.address}}", "Subject": "Hallo {{item.displayName}}", "Body": "…" } }
    ]
  }
}

Die Aktion Outlook365

Die Aktion Outlook365 sendet Mails über denselben Konnektor, ohne dass Sie das Graph-JSON selbst schreiben. Sie lädt große Anhänge in Teilen hoch und kann Entwürfe anlegen.

{
  "Type": "Outlook365",
  "Name": "RechnungMailen",
  "Parameters": {
    "Connector": "OutlookMail",
    "Mode": "Send",
    "To": "{{InitialData.Empfaenger}}",
    "Subject": "Rechnung {{InitialData.Invoice.BT1}}",
    "Body": "Guten Tag,\n\nanbei Ihre Rechnung.",
    "Attachments": "{{FilePath}}"
  }
}

Parameter	Standard	Bedeutung
Connector	OutlookMail	Name des Microsoft-Konnektors
Mode	Send	Send sendet; Draft speichert im Ordner Entwürfe; Display speichert als Entwurf und öffnet ihn in Outlook im Web
From	–	Leer: das angemeldete Postfach. Sonst ein freigegebenes Postfach oder eines mit „Senden als“-Rechten.
To, Cc, Bcc, ReplyTo	–	Empfänger, getrennt durch ; oder ,. Name <a@b.de>, Listen und Dateien mit Adressen sind erlaubt.
Subject	–	Betreff
Body, Signatur	–	Text oder Pfad einer Text- bzw. HTML-Datei
BodyFormat	Auto	Auto, Html oder Text
Attachments	–	Pfad, mehrere getrennt durch ;, eine Liste oder ein Muster wie C:\Out\*.pdf. Bis 150 MB je Datei.
MissingAttachments	Error	Error oder Skip
Importance	Normal	Low, Normal, High
ReadReceipt, DeliveryReceipt	false	Bestätigungen anfordern
SaveToSentItems	true	Kopie in Gesendete Elemente. Bei großen Anhängen bleibt sie immer dort.
Timeout	100	Zeitlimit je Anfrage an Microsoft in Sekunden

Das Ergebnis enthält je Mail Mode, Status (z. B. Sent), From, To, Subject, Attachments und Message; bei Draft und Display außerdem MessageId und WebLink zum Entwurf.

Meldung	Lösung
No connector named “…”	Konnektor anlegen oder den Namen in Connector korrigieren
… is not signed in	Auf der Seite Konnektoren Im Browser anmelden klicken
Fehler 403 bei From	Für das Postfach fehlen „Senden als“-Rechte

Im Diagramm des Workflow-Editors hat die Aktion ein Formular: Konto listet die gespeicherten Konnektoren (die Schaltfläche daneben liest sie neu ein), Mode wählen Sie mit den Schaltflächen Direkt senden, Als Entwurf speichern und Zum Prüfen öffnen; dann An, Cc, Bcc, Betreff, Text, Signatur und Anhänge (bis 150 MB je Datei). Unter Weitere Optionen stehen From (leer = das angemeldete Postfach, sonst z. B. ein freigegebenes Postfach), Antwortadresse, Textformat, Wichtigkeit, fehlende Anhänge (Fehler oder Überspringen), Lese- und Zustellbestätigung, In „Gesendete Elemente“ behalten (Standard an) und das Zeitlimit (Standard 100 Sekunden). Jedes Feld nimmt auch {{…}}-Platzhalter und Werte, die Sie in der Testansicht aus der Spalte Eingabe hineinziehen; Auswahllisten, Schalter und Zahlenfelder werden mit einem {{…}} zu einem Textfeld. Parameter, die das Formular nicht kennt, stehen unter Weitere Parameter. Schritt testen führt die Aktion sofort einmal aus, mit den Daten der Schritte davor, und zeigt das Ergebnis mit Fehlern und Warnungen. Der Test sendet bzw. speichert die Mail wirklich.

Die Workflow-Vorlage Mail über Microsoft 365 (unter Neu) enthält ein fertiges Beispiel.