Outlook (M365)

✅ Voraussetzungen

• Zugriff auf Microsoft Azure (zur Einrichtung einer App in Microsoft Entra ID, ehemals Azure Active Directory)

• Die folgende Anleitung (auch als Video verfügbar): 📹 Loom-Video ansehen

---

🛠️ Einrichtung in Microsoft Azure

1. Anmelden in Azure

   • Gehe zu Microsoft Azure

   • Navigiere zu Microsoft Entra ID (früher Azure AD)

2. App-Registrierung erstellen

   • Im Menü unter "Verwalten" → "App-Registrierungen" klicken

   • Oben auf "Neue Registrierung"

   • Vergib einen Namen, z. B. melibo

   • Kontotyp auswählen: Konten in einem beliebigen Organisationsverzeichnis und persönliche Microsoft-Konten

   • Umleitungs-URI: Plattform: Web URL: https://api.melibo.de/dingo/channels/outlook/auth/callback

   • Abschließen mit "Registrieren"

3. API-Berechtigungen konfigurieren

   • In der neu erstellten App unter "Verwalten" → "API-Berechtigungen"

   • Klick auf "Berechtigung hinzufügen"

   • Microsoft Graph → Delegierte Berechtigungen

     • ✅ Mail.ReadWrite

     • ✅ Mail.ReadWrite.Shared

     • ✅ Mail.Send

     • ✅ Mail.Send.Shared

     • ✅ MailboxSettings.Read

4. Geheimen Clientschlüssel erstellen

   • Gehe zu "Zertifikate & Geheimnisse"

   • Klicke auf "Neuer geheimer Clientschlüssel"

   • Nach Erstellung: Wert kopieren!

     • 👉 Diesen Wert in melibo bei Client Secret einfügen

5. Client-ID kopieren

   • Gehe zur Übersicht der App

   • Kopiere den Wert bei Anwendungs-ID (Client-ID)

     • 👉 Diesen Wert in melibo bei Client ID einfügen

Outlook-Integration mit melibo

1. Einleitung

Dieser Artikel beschreibt, wie du eine Verbindung zwischen melibo und Outlook herstellst, um automatisierte Antworten über Microsoft Graph API zu senden.

---

2. Token abrufen

Bevor du eine E-Mail über Outlook versenden kannst, benötigst du ein Access Token.

Schritt 1: Channel-ID finden

1. Öffne die melibo Plattform.

2. Navigiere zu "Einstellungen" → "Channels" → "Outlook-Channel".

3. In der URL des Channels findest du die CHANNEL_ID.

Schritt 2: Token abrufen

Führe die GET-Anfrage über den Webhook-Knoten direkt in melibo aus.

GET https://api.melibo.de/dingo/channels/outlook/<CHANNEL_ID>/token x-api-key: XXXXXXXXX

👉 Hinweis: Ersetze <CHANNEL_ID> durch die ID aus Schritt 1. 👉 Der erhaltene Access Token wird später für die Authentifizierung benötigt.

---

3. Antwort per E-Mail versenden

Sobald das Token vorliegt, kannst du eine Antwort über Microsoft Graph API mithilfe des Webhook-Knotes senden.

Schritt 1: Anfrage vorbereiten

Endpunkt:

POST https://graph.microsoft.com/v1.0/me/messages/@var{id}/reply

Header:

Authorization: Bearer @var{getAccessTokenResponse.data} Content-Type: application/json

Body:

{ "message": { "body": { "contentType": "HTML", "content": "@var{answer}" } } }

👉 Hinweise:

• Ersetze @var{id} mit der ID der ursprünglichen E-Mail. Dabei handelt es sich um eine globale Variable, die automatisch von melibo bereitgestellt wird.

• @var{getAccessTokenResponse.data} muss durch das erhaltene Access Token ersetzt werden.

• @var{answer} enthält die HTML-formatierte Antwort.

---

4. Fehlerbehebung

Falls Fehler auftreten, überprüfe Folgendes:

✅ Korrekte Channel-ID? ✅ API Key gültig? ✅ Bearer Token in der Anfrage enthalten? ✅ E-Mail-ID korrekt angegeben?

Falls weiterhin Probleme bestehen, wende dich an den melibo Support.

---

5. Fazit

Mit diesen Schritten kannst du automatisierte Antworten über Outlook mit melibo versenden. 🚀