Verbinden eines Bots mit Office 365-E-MailsConnect a bot to Office 365 email

gilt für: SDK v4APPLIES TO: SDK v4

Zusätzlich zu anderen Kanälen können Bots mit Benutzern über Office 365-E-Mails kommunizieren.Bots can communicate with users via Office 365 email in addition to other channels. Wenn ein Bot für den Zugriff auf ein E-Mail-Konto konfiguriert ist, empfängt er eine Nachricht, sobald eine neue E-Mail eintrifft.When a bot is configured to access an email account, it receives a message when a new email arrives. Der Bot kann dann auf die Weise antworten, die durch die Geschäftslogik festgelegt ist.The bot can then respond as indicated by its business logic. Beispielsweise kann der Bot eine E-Mail-Antwort senden, in der der Empfang einer E-Mail mit folgender Nachricht bestätigt wird: „Hallo,For example, the bot could send an email reply acknowledging an email was received with the message, "Hi! vielen Dank für Ihren Auftrag!Thanks for your order! Wir werden sofort mit der Bearbeitung beginnen.“We will begin processing it immediately."

Warnung

Es verstößt gegen den Bot Framework-Verhaltenskodex, „Spambots“ zu erstellen. Dazu gehören Bots, die unerwünschte oder nicht angeforderte Massen-E-Mails senden.It is a violation of the Bot Framework Code of Conduct to create "spambots", including bots that send unwanted or unsolicited bulk email.

Hinweis

Stellen Sie bei Verwendung von Microsoft Exchange Server zunächst sicher, dass Sie die AutoErmittlung aktiviert haben, bevor Sie den E-Mail-Kanal konfigurieren.If you are using Microsoft Exchange Server, make sure you have enabled Autodiscover first before configuring email channel.

Konfigurieren von E-Mail-AnmeldeinformationenConfigure email credentials

Sie können einen Bot mit dem E-Mail-Kanal verbinden, indem Sie Office 365-Anmeldeinformationen in der Konfiguration des E-Mail-Kanals eingeben.You can connect a bot to the Email channel by entering Office 365 credentials in the Email channel configuration. Eine Verbundauthentifizierung mithilfe eines beliebigen Anbieters, die AAD ersetzt, wird nicht unterstützt.Federated authentication using any vendor that replaces AAD is not supported.

Hinweis

Sie sollten nicht Ihre eigenen persönlichen E-Mail-Konten für Bots verwenden, da jede an dieses E-Mail-Konto gesendete Nachricht an den Bot weitergeleitet wird.You should not use your own personal email accounts for bots, as every message sent to that email account will be forwarded to the bot. Dies kann dazu führen, dass der Bot eine unangemessene Antwort an einen Absender sendet.This can result in the bot inappropriately sending a response to a sender. Aus diesem Grund sollten Bots nur dedizierte Office 365-E-Mail-Konten verwenden.For this reason, bots should only use dedicated O365 email accounts.

Zum Hinzufügen des E-Mail-Kanals öffnen Sie den Bot im Azure-Portal, klicken Sie auf das Blatt Kanäle, und klicken Sie dann auf E-Mail.To add the Email channel, open the bot in the Azure Portal, click the Channels blade, and then click Email. Geben Sie Ihre gültigen E-Mail-Anmeldeinformationen ein, und klicken Sie auf Speichern.Enter your valid email credentials and click Save.

Eingeben von E-Mail-Anmeldeinformationen

Der E-Mail-Kanal funktioniert zurzeit nur mit Office 365.The Email channel currently works with Office 365 only. Andere E-Mail-Dienste werden derzeit nicht unterstützt.Other email services are not currently supported.

Anpassen von E-MailsCustomize emails

Der E-Mail-Kanal unterstützt das Senden benutzerdefinierter Werte, um mithilfe der Aktivitätseigenschaft erweiterte, angepasste E-Mails zu channelData erstellen.The Email channel supports sending custom values to create more advanced, customized emails by using the activity channelData property. Der folgende Codeausschnitt zeigt ein Beispiel für eine channelData eingehende benutzerdefinierte E-Mail-Nachricht vom Bot an den Benutzer.The snippet below shows an example of the channelData for an incoming custom email message, from the bot to the user.

EigenschaftProperty BESCHREIBUNGDescription
htmlBodyhtmlBody Der HTML-Code, der für den Text der Nachricht verwendet werden soll.The HTML to use for the body of the message.
subjectsubject Der Betreff, der für die Nachricht verwendet werden soll.The subject to use for the message.
importanceimportance Das Prioritätsflag, das für die Nachricht verwendet werden soll: low, normal oder high.The importance flag to use for the message: low, normal, or high.
toRecipientstoRecipients Eine durch ein Semikolon (;) getrennte Zeichenfolge von E-Mail-Adressen, die in das Feld „An“ der Nachricht eingefügt werden sollen.A semicolon (;) delimited string of email addresses to add to the message's To field.
ccRecipientsccRecipients Eine durch ein Semikolon (;) getrennte Zeichenfolge von E-Mail-Adressen, die in das Feld „Cc“ (Carbon Copy) der Nachricht eingefügt werden sollen.A semicolon (;) delimited string of email addresses to add to the message's Cc (carbon copy) field.
bccRecipientsbccRecipients Eine durch ein Semikolon (;) getrennte Zeichenfolge von E-Mail-Adressen, die in das Feld „Bcc“ (Blind Carbon Copy) der Nachricht eingefügt werden sollen.A semicolon (;) delimited string of email addresses to add to the message's Bcc (blind carbon copy) field.

Weitere Informationen zur channelData Aktivitätseigenschaft finden Sie unter Erstellen einer benutzerdefinierten E-Mail-Nachricht.For more information about the activity channelData property, see Create a custom Email message.

Weitere ÜberlegungenOther considerations

Wenn Ihr Bot als Antwort auf eine eingehende E-Mail-Nachricht nicht innerhalb von 15 Sekunden den HTTP-Statuscode „200 OK“ zurückgibt, versucht der E-Mail-Kanal, die Nachricht erneut zu senden. Ihr Bot kann die gleiche E-Mail-Nachrichtenaktivität mehrmals empfangen.If your bot does not return a 200 OK HTTP status code within 15 seconds in response to an incoming email message, the email channel will try to resend the message, and your bot may receive the same email message activity a few times. Weitere Informationen finden Sie unter Funktionsweise von Bots im Abschnitt HTTP-Details und im Artikel Bot Troubleshooting Timeout Errors (Problembehandlung für Bots: Timeoutfehler).For more information, see the HTTP details section in How bots work and the how to troubleshooting timeout errors article.

Hinweis

Wenn Sie ein Office 365-Konto verwenden, für das MFA aktiviert ist, stellen Sie sicher, dass Sie zuerst die MFA für das angegebene Konto deaktivieren. Anschließend können Sie das Konto für den E-Mail-Kanal konfigurieren.If you are using an Office 365 account with MFA enabled on it, make sure you disable MFA for the specified account first, then you can configure the account for the email channel. Andernfalls wird die Verbindung nicht hergestellt.Otherwise, the connection will fail.

Zusätzliche RessourcenAdditional resources