aiaibot Helpcenter
AppChangelog
  • Willkommen
  • Allgemein
    • Workspace, Projekte & Einstellungen
      • 2-Faktor-Authentifizierung
      • Workspace
      • Projekte
      • Projekt duplizieren
      • Benutzerverwaltung und Rollen
      • Passwort zurücksetzen
      • Profileinstellungen und persönliche Daten ändern
      • Datensicherheit
      • Feature Request und Bug Report
  • Chatbot
    • Integration
      • Domains konfigurieren
      • Integration über Slack
      • Website-Integration
      • Google Tag Manager Integration
      • Warum sehe ich meinen Chatbot nicht?
      • Cookies anpassen
      • Unblu Live-Chat integrieren
    • Stories & Story Builder
      • Story - Diagrammansicht
      • Konfiguration vom Chat Ende
      • Was ist der Story Builder?
      • Was ist eine Story?
      • Story Übersicht
      • Eine Story erstellen
      • Eine Story kopieren/duplizieren
      • Storys untereinander verlinken
      • Wie kann ich eine Story exportieren?
      • Eine Story wiederherstellen
      • Speichern, Entwurf- und Live-Version
      • Vorschau und Testen Ihres Chatbots
      • Chatbot Aussehen mit dem Styler anpassen
      • Verwendung von Variablen
      • Trigger
      • User Sessions
      • KPI Dashboard
    • Widgets
      • Modifier
      • Ghost message
      • Text
      • Medien
      • Benutzereingabe
        • Text, E-Mail und Telefon
        • Datum und Uhrzeit
        • Standort
      • Datei-Upload
      • Datei-Download
      • Dynamische Liste
      • Karussell
      • Entscheidung
      • Entscheidung Links
      • AI Indent
      • FAQ
      • Umfrage
      • Dialogübergabe an E-Mail
      • Live-Chat
      • Story Link
      • Sub Story
      • Checkpoint
      • Go-To Ziel
      • Variable
      • Robot
  • AI
    • Knowledge Base
      • Quelle
  • Robot
    • Workflows
      • Workflow Liste
      • Variablen
        • Datentypen
        • E-Mail-Variablen
      • Workflow Protokoll
      • Sub-Workflows
    • Plugins
      • Chatbot
        • Konversationspfad festlegen
        • Dynamische Liste erstellen
        • Dynamische Liste befüllen
        • Nachricht an Chatbot senden
      • Textverarbeitung
        • Text in Datumsobjekte umwandeln
        • Datumsobjekte in Text umwandeln
        • Text erstellen
        • Dezimal-Variable formatieren
        • Text extrahieren
        • Umändern von Texten
        • Regular Expression abgleichen
        • Text verändern
        • Teilen eines Textes
        • Ersetzen im Text
        • Suche in Text
        • Text abschneiden
      • Collections
        • Element zur Collection hinzufügen
        • Element aus Collection lesen
        • Element entfernen
        • Collection löschen
        • Collection-Element prüfen
        • Elemente in einer Collection abzählen
        • Collection sortieren
        • Doppelte Elemente entfernen
      • Speicher
        • Speichern eines Wertes
        • Laden eines Wertes
        • Speichern einer Datei
      • E-Mail und SMS
        • E-Mail senden
        • E-Mail verschieben
        • E-Mail ändern
        • E-Mail weiterleiten
        • Senden einer Textnachricht
      • Web
        • Dateiinhalt erkennen
        • Datei herunterladen
        • Dateien hochladen
        • URL-Parameter auslesen
      • REST APIs und JSON
        • API-Endpunkt aufrufen
        • Streaming API-Endpunkt aufrufen
        • JSON abfragen
        • Abfrage JSON (mehrfach)
        • JSON erstellen
        • REST Web-Service aufrufen
      • Datenbanken
        • Datenbank abfragen (SQL)
        • Datenbank aktualisieren
      • Session
        • Token senden
        • Token verifizieren
        • Authentifikation prüfen
        • Session beenden
      • Diverse
        • Rechnen mit Datum oder Zeitstempel
        • Workflow abbrechen
        • Öffnungszeiten
        • Zählen
        • Berechnung durchführen
        • ID generieren
        • Zufallszahl generieren
        • Log-Eintrag
        • Variablenwert setzen
        • Sub-Workflow ausführen
        • Warten
      • Muster für Datumsobjekte
    • Connectoren
      • Aktiv
        • Exchange Online
        • Timer
        • POP3 / IMAP
      • Passiv
        • Sub-Workflow
        • JSON
        • Webformular
      • Konfiguration
        • Microsoft Graph API
        • Datenbank
        • SMTP
    • Data Store
      • Key-Value Store
      • Projektvariablen
    • API Spezifikationen
      • Request-Header
      • Endpunkte
      • Platzhalter
      • JSON als Request-Body
    • Live Log
    • Sessionmanagement
    • Einstellungen
    • Microsoft Azure App Registration
    • Teams Integration
Bereitgestellt von GitBook
Auf dieser Seite
  • Voraussetzungen
  • Erstellen eines Microsoft Graph API-Connectors
  • Authentifizierungsverfahren wählen
  • Auth Code Grant
  • ROPC Grant
  1. Robot
  2. Connectoren
  3. Konfiguration

Microsoft Graph API

Zuletzt aktualisiert vor 5 Monaten

Der Microsoft Graph API-Connector wird benötigt, um E-Mails von Exchange Online Mailboxen abzurufen oder zu versenden.

Voraussetzungen

Um einen Microsoft Graph API-Connector zu erstellen, benötigen Sie folgende Daten:

  • Tenant ID

  • Client ID

  • Client Secret

  • Benutzer und Password der Exchange Online Mailbox

Um diese Daten zu erhalten, registrieren Sie eine App in im Microsoft Azure Portal. Nähre Informationen dazu finden Sie in .

Erstellen eines Microsoft Graph API-Connectors

Um einen neuen Microsoft Graph API-Connector zu erstellen, wählen Sie den Menüpunkt Connectoren und klicken anschliessend auf das Symbol.

Danach vergeben Sie einen Namen und wählen die Option Microsoft Graph API aus der Auswahlbox aus.

Authentifizierungsverfahren wählen

Die Authentifizierung erfolgt mittels OAuth. Es kann zwischen zwei Verfahren gewählt werden: Auth Code Grant und ROPC Grant.

Es wird ausdrücklich die Variante Auth Code Grant empfohlen, da bei dieser Variante weder Benutzername noch Passwort der Mailbox in unserer Datenbank gespeichert werden müssen.

Auth Code Grant

Bei dieser Methode werden Sie nach Eingabe aller erforderlichen Daten zur Exchange Online-Mailbox weitergeleitet. Dort melden Sie sich mit dem Benutzername und Passwort der Mailbox an und bestätigen, dass aiaibot mit den entsprechenden Berechtigungen auf die Mailbox zugreifen darf. Nach erfolgreicher Bestätigung werden Sie automatisch zurück zur aiaibot-Plattform geleitet.

Anschliessend wählen Sie die Berechtigungen aus, die der Connector haben soll. Unter Vordefinierte API-Berechtigungen können Sie Berechtigungen für das Abrufen und Senden von E-Mails auswählen.

Falls weitere Berechtigungen benötigt werden, können Sie diese im Feld Weitere API-Berechtigungen hinzufügen eintragen.

Im Bereich Zusammenfassung der API-Berechtigungen sehen Sie eine Übersicht aller Berechtigungen, die diesem Connector zugewiesen werden.

Damit der Connector korrekt funktioniert, müssen bei der Registrierung der App im Azure-Portal mindestens die erforderlichen Berechtigungen vergeben werden.

Am unteren Ende sehen Sie eine URL, die Sie bei der App-Registrierung im Azure-Portal benötigen.

Klicken Sie auf Weiter, um zur Microsoft-Seite zu gelangen. Dort melden Sie sich mit dem Benutzernamen und Passwort der Mailbox an. Anschliessend wird eine Übersicht angezeigt, in der alle Berechtigungen aufgeführt sind. Nachdem Sie den Zugriff bestätigt haben, werden Sie automatisch zurück zur aiaibot-Plattform geleitet.

ROPC Grant

Bei dieser Methode müssen Sie Benutzername und Passwort bei uns hinterlegen, damit ein Zugriff auf die Mailbox möglich ist. Das Passwort wird mit einer zusätzlichen Verschlüsselung in unserer Datenbank abgelegt.

Bei dieser Methode müssen Sie auch den Benutzername und das Passwort der Mailbox in die entsprechenden Felder eintragen.

Anschliessend wählen Sie die Berechtigungen aus, die der Connector haben soll. Unter Vordefinierte API-Berechtigungen können Sie Berechtigungen für das Abrufen und Senden von E-Mails auswählen.

Falls weitere Berechtigungen benötigt werden, können Sie diese im Feld Weitere API-Berechtigungen hinzufügen eintragen.

Im Bereich Zusammenfassung der API-Berechtigungen sehen Sie eine Übersicht aller Berechtigungen, die diesem Connector zugewiesen werden.

Damit der Connector korrekt funktioniert, müssen bei der Registrierung der App im Azure-Portal mindestens die erforderlichen Berechtigungen vergeben werden.

Abschliessend klicken Sie auf Speichern um den Connector anzulegen.

Tragen Sie die Tenant ID, Client ID und das Client Secret in die entsprechenden Felder ein. Diese Daten erhalten Sie, wenn Sie eine durchgeführt haben.

Tragen Sie die Tenant ID und Client ID in die entsprechenden Felder ein. Diese Daten erhalten Sie, wenn Sie eine durchgeführt haben.

App-Registrierung im Azure-Portal
App-Registrierung im Azure-Portal
dieser Anleitung
Erstellen eines neuen Connectors
Erstellen eines Microsoft Graph API-Connectors
OAuth Authentifizierungsverfahren
Auth Code Grant Authentifizierungsverfahren